de-slopify — Claude Code skill: what it does, how to install
The de-slopify skill for Claude Code flags stock phrases, excess em dashes, and AI traces in comments while editing LLM-touched text and code.
MIT 146 installs ★ 29 updated 2026-08-17
npx skills add oakoss/agent-skills --skill de-slopify -a claude-codeWhat de-slopify does
The skill names what gives model-written docs away: dashes everywhere, openers like “let's dive in”, worn-out vocabulary, sentences of uniform length, lists that always hold exactly three items. It ships a pattern-and-fix table plus a list of editing mistakes, and five files under references/ cover dash alternatives and tone calibration, before/after examples, slop vocabulary, code smells, and a review workflow.
Code gets a separate pass. Comments that repeat the line below them go, needless abstraction layers flatten, wordy variable names shrink, and error handling survives only where something can realistically fail.
Work through the file by hand. A regex sweep will catch legitimate dashes and ordinary words along with the noise. Decide on voice and audience first, or the cleaned text turns into choppy fragments. On algorithms and logic, where correctness outranks style, leave it alone.
What it helps with
- strip dashes and formulaic openers from a README before publishing
- spot words in a draft that point to machine authorship
- clean generated code of restating comments, extra layers and bloated names
- set the tone of a doc to fit a stated audience
- review someone else's text for signs of generation
Example prompts for the agent
- Run de-slopify over
README.mdand cut the stock phrases and extra dashes. - Use the de-slopify skill to check this doc page for AI tells and rewrite the stiff parts.
- Clean up the generated module with de-slopify: drop comments that restate the code and shorten the long names.
How to install de-slopify
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill de-slopify -a claude-code2Manually: put the files in place
~/.claude/skills/de-slopify/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/de-slopify/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill de-slopify -a codex2Manually: put the files in place
.agents/skills/de-slopify/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill de-slopify -a cursor2Manually: put the files in place
.cursor/skills/de-slopify/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/de-slopify2Manually: put the files in place
.github/skills/de-slopify/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill de-slopify -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/de-slopifyManually: put the files in place
.devin/skills/de-slopify/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill de-slopify -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about de-slopify
How do I install de-slopify in Claude Code?
Run npx skills add oakoss/agent-skills --skill de-slopify -a claude-code. The skill file lands at ~/.claude/skills/de-slopify/SKILL.md.
What does de-slopify do?
It lists the marks of machine writing with a fix for each, and adds a matching set of rules for code: restating comments, unnecessary abstraction, oversized variable names.
How is de-slopify different from quality-auditor?
de-slopify works on the style of one text or file. quality-auditor audits a whole project across 12 dimensions, from architecture and security to tests and performance.
Source text
SKILL.md · MIT
--- name: de-slopify description: > 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. license: MIT metadata: author: oakoss version: '1.0' --- # 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](references/prose-patterns.md) - [Before-and-after examples of common AI writing fixes](references/before-and-after.md) - [AI slop vocabulary: words and phrases that signal LLM authorship](references/slop-vocabulary.md) - [Code slop: detecting and fixing AI-generated code smells](references/code-slop.md) - [Review workflow: prompts, checklists, and integration](references/review-workflow.md)
© oakoss · MIT · oakoss/agent-skills