Agent skill · writing content · aiskillstore
de-slopify
Remove telltale signs of AI-generated 'slop' writing from README files and documentation. Make your docs sound authentically human.
Why this skill is useful
Provides specific guidelines for improving documentation quality by eliminating AI-generated writing patterns, which the AI wouldn't reliably know to address.
What it needs
About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
De-Slopify — Remove AI Writing Artifacts Purpose: Make your documentation sound like it was written by a human, not an LLM. Key Insight: You can't do this with regex or a script—it requires manual, systematic review of each line. --- What is "AI Slop"? AI slop refers to writing patterns that LLMs produce disproportionately more commonly than human writers. These patterns make text sound inauthentic and "cringe." Common Tells Pattern Problem --------- --------- Emdash overuse LLMs love emdashes—they use them constantly—even when other punctuation works better "It's not X, it's Y" Formulaic contrast structure "Here's why" Clickbait-style lead-in "Here's why it matters:" Same energy "Let's dive in" Forced enthusiasm "In this guide, we'll..." Overly formal setup "It's worth noting that..." Unnecessary hedge "At its core..." Pseudo-profound opener --- THE EXACT PROMPT — De-Slopify Documentation --- Why Manual Review is Required The prompt explicitly states: "And you can't do this sort of thing using regex or a script, you MUST manually read each line of the text and revise it manually in a systematic, methodical, diligent way." Reasons: 1. Context matters — Sometimes an emdash is actually the right choice 2. Recasting sentences — Often the fix isn't substitution but rewriting 3. Tone consistency — Need to maintain voice throughout 4. Judgment calls — Some patterns are fine in moderation --- Emdash Alternatives When you encounter an emdash (—), consider: Original Alternative ---------- ------------- X—Y—Z X; Y; Z or X, Y, Z The tool—which is powerful—works well The tool, which is powerful, works well We built this—and it works We built this, and it works Here's the thing—it matters Here's the thing: it matters or recast entirely Sometimes the best fix is to split into two sentences or restructure entirely. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/de-slopify