De-Slopify
Overview
De-slopify is a methodology for removing telltale signs of AI-generated content from documentation, prose, and code. LLMs produce statistically regular output with characteristic vocabulary, punctuation habits, and structural patterns that make text and code feel inauthentic. Some patterns appear over 1,000x more frequently in LLM output than human writing.
When to use: Before publishing READMEs, after AI-assisted writing sessions, during documentation reviews, when reviewing AI-generated code for over-engineering, before committing prose or code that an LLM touched.
When NOT to use: On code logic or algorithms where correctness matters more than style. On technical specifications where precision outweighs voice. On content that was already human-written and reads naturally.
Quick Reference
| Category |
Pattern |
Fix |
| Punctuation |
Emdash overuse |
Semicolons, commas, colons, or split into two sentences |
| Phrase |
"Here's why" / "Here's why it matters" |
Explain why directly without the lead-in |
| Phrase |
"It's not X, it's Y" |
"This is Y" or restate the distinction |
| Phrase |
"Let's dive in" / "Let's get started" |
Delete; just start the content |
| Phrase |
"It's worth noting" / "Keep in mind" |
Delete the hedge; state the fact |
| Phrase |
"At its core" / "In essence" / "Fundamentally" |
Delete; say the thing directly |
| Vocabulary |
"delve", "tapestry", "landscape", "nuanced" |
Replace with plain, specific language |
| Vocabulary |
"revolutionize", "cutting-edge", "game-changer" |
Replace with concrete claims or delete |
| Structure |
Uniform sentence length throughout |
Mix short (5-word) and long (20+ word) sentences |
| Structure |
Perfectly balanced lists of exactly 3 items |
Vary list length; humans use 2, 4, or odd counts |
| Structure |
Generic claims without specifics |
Add names, dates, numbers, or first-person detail |
| Sycophancy |
"Great question!" / "Absolutely!" |
Delete; answer the question directly |
| Meta |
"Let me break this down..." / "Let me explain" |
Delete the preamble; just break it down |
| Structure |
Numbered lists where a sentence suffices |
Use a sentence; reserve lists for genuinely parallel items |
| Closer |
"In conclusion" / "To summarize" |
Delete or replace with a specific takeaway |
| Code |
Over-commented trivial functions |
Remove comments that restate the code |
| Code |
Unnecessary abstractions and design patterns |
Flatten to the simplest working solution |
| Code |
Verbose or overly descriptive variable names |
Use domain-appropriate concise names |
| Code |
Defensive error handling on every operation |
Handle errors only where failure is realistic |
Common Mistakes
| Mistake |
Correct Pattern |
| Replacing every emdash mechanically |
Evaluate context; sometimes an emdash is the right choice |
| Editing code blocks for style |
Focus on prose; leave code examples and technical syntax untouched |
| Removing all structure to sound casual |
Keep headers, tables, and lists intact; rewrite prose only |
| Over-correcting into choppy fragments |
Read aloud after editing; recombine sentences that lost flow |
| Applying fixes without defining target voice |
Set persona, tone, and audience before starting edits |
| Running regex replacements instead of reading |
Manual line-by-line review is required; context determines fixes |
| Ignoring AI code smells |
Review AI-generated code for over-engineering, verbose names, and unnecessary abstractions |
| Removing all LLM-typical words unconditionally |
Some flagged words are perfectly natural in context; use judgment |
Delegation
- Scan a repository for documentation files that need de-slopifying: Use
Explore agent
- Rewrite an entire documentation site to remove AI artifacts: Use
Task agent
- Plan a documentation voice guide and editorial workflow: Use
Plan agent
- Review AI-generated code for slop patterns: Use
code-reviewer agent
For systematic quality auditing across 12 dimensions (architecture, security, testing, performance, etc.), use the quality-auditor skill.
References
- Prose patterns: emdash alternatives, phrase replacements, and voice calibration
- Before-and-after examples of common AI writing fixes
- AI slop vocabulary: words and phrases that signal LLM authorship
- Code slop: detecting and fixing AI-generated code smells
- Review workflow: prompts, checklists, and integration
1---2name: de-slopify3description: Removes AI writing artifacts from documentation and code. Use when editing LLM-generated prose, reviewing READMEs, polishing docs before publishing, or cleaning up AI-generated code. Use for emdash cleanup, formulaic phrase removal, tone calibration, over-commented code, verbose naming, and AI code smell detection.4license: MIT5---6
7# De-Slopify
8
9## Overview
10
11De-slopify is a methodology for removing telltale signs of AI-generated content from documentation, prose, and code. LLMs produce statistically regular output with characteristic vocabulary, punctuation habits, and structural patterns that make text and code feel inauthentic. Some patterns appear over 1,000x more frequently in LLM output than human writing.
12
13**When to use:** Before publishing READMEs, after AI-assisted writing sessions, during documentation reviews, when reviewing AI-generated code for over-engineering, before committing prose or code that an LLM touched.
14
15**When NOT to use:** On code logic or algorithms where correctness matters more than style. On technical specifications where precision outweighs voice. On content that was already human-written and reads naturally.
16
17## Quick Reference
18
19| Category | Pattern | Fix |
20| ----------- | ----------------------------------------------- | ---------------------------------------------------------- |
21| Punctuation | Emdash overuse | Semicolons, commas, colons, or split into two sentences |
22| Phrase | "Here's why" / "Here's why it matters" | Explain why directly without the lead-in |
23| Phrase | "It's not X, it's Y" | "This is Y" or restate the distinction |
24| Phrase | "Let's dive in" / "Let's get started" | Delete; just start the content |
25| Phrase | "It's worth noting" / "Keep in mind" | Delete the hedge; state the fact |
26| Phrase | "At its core" / "In essence" / "Fundamentally" | Delete; say the thing directly |
27| Vocabulary | "delve", "tapestry", "landscape", "nuanced" | Replace with plain, specific language |
28| Vocabulary | "revolutionize", "cutting-edge", "game-changer" | Replace with concrete claims or delete |
29| Structure | Uniform sentence length throughout | Mix short (5-word) and long (20+ word) sentences |
30| Structure | Perfectly balanced lists of exactly 3 items | Vary list length; humans use 2, 4, or odd counts |
31| Structure | Generic claims without specifics | Add names, dates, numbers, or first-person detail |
32| Sycophancy | "Great question!" / "Absolutely!" | Delete; answer the question directly |
33| Meta | "Let me break this down..." / "Let me explain" | Delete the preamble; just break it down |
34| Structure | Numbered lists where a sentence suffices | Use a sentence; reserve lists for genuinely parallel items |
35| Closer | "In conclusion" / "To summarize" | Delete or replace with a specific takeaway |
36| Code | Over-commented trivial functions | Remove comments that restate the code |
37| Code | Unnecessary abstractions and design patterns | Flatten to the simplest working solution |
38| Code | Verbose or overly descriptive variable names | Use domain-appropriate concise names |
39| Code | Defensive error handling on every operation | Handle errors only where failure is realistic |
40
41## Common Mistakes
42
43| Mistake | Correct Pattern |
44| ---------------------------------------------- | ------------------------------------------------------------------------------------------ |
45| Replacing every emdash mechanically | Evaluate context; sometimes an emdash is the right choice |
46| Editing code blocks for style | Focus on prose; leave code examples and technical syntax untouched |
47| Removing all structure to sound casual | Keep headers, tables, and lists intact; rewrite prose only |
48| Over-correcting into choppy fragments | Read aloud after editing; recombine sentences that lost flow |
49| Applying fixes without defining target voice | Set persona, tone, and audience before starting edits |
50| Running regex replacements instead of reading | Manual line-by-line review is required; context determines fixes |
51| Ignoring AI code smells | Review AI-generated code for over-engineering, verbose names, and unnecessary abstractions |
52| Removing all LLM-typical words unconditionally | Some flagged words are perfectly natural in context; use judgment |
53
54## Delegation
55
56- **Scan a repository for documentation files that need de-slopifying**: Use `Explore` agent
57- **Rewrite an entire documentation site to remove AI artifacts**: Use `Task` agent
58- **Plan a documentation voice guide and editorial workflow**: Use `Plan` agent
59- **Review AI-generated code for slop patterns**: Use `code-reviewer` agent
60
61> For systematic quality auditing across 12 dimensions (architecture, security, testing, performance, etc.), use the `quality-auditor` skill.
62
63## References
64
65- [Prose patterns: emdash alternatives, phrase replacements, and voice calibration](references/prose-patterns.md)
66- [Before-and-after examples of common AI writing fixes](references/before-and-after.md)
67- [AI slop vocabulary: words and phrases that signal LLM authorship](references/slop-vocabulary.md)
68- [Code slop: detecting and fixing AI-generated code smells](references/code-slop.md)
69- [Review workflow: prompts, checklists, and integration](references/review-workflow.md)
oakoss