slop-cop

slop-cop is a Claude Code skill that catches sloppy writing before it ships.

Our feeds are becoming shit. Our websites are becoming shit. Our repos are becoming shit. AI didn't make writing harder, it made writing easier, and now everyone uses the same shortcuts, the same shapes, the same words. Open ten landing pages in a row and you can't tell them apart.

slop-cop runs two tests on a draft:

• Does it sound like AI wrote it? (the AI-Slop test)
• Can a real person read it? (the Comprehension test)

A piece can pass one test and fail the other. A blog post might pass the AI test but be too hard to read because it stuffs nine short forms into one paragraph. A casual note might fail the AI test but read just fine.

Hand it a draft. You get back two scores, the words to cut, a guess at which AI made it, and one clear next step.

Both tests use density. What matters is how often the patterns pile up close together, not whether one bad word shows up once. This README scores LOW on its own test.

Why I built this

To make my own websites less shit. To make my clients' websites less shit. To stop my LinkedIn feed from drowning in copy-paste slop. That is the whole point.

Yes, AI wrote parts of this README. That is not the problem. The problem is AI prose that nobody catches: the safe, hedge-stacked, em-dash-heavy paragraph where every line is grammatically clean but the whole thing is forgettable.

I run slop-cop against my own work every day. Landing pages, blog posts, READMEs, pitch decks, cold emails. It catches the stuff I would have shipped. It tells me which paragraph is too dense for a new reader, which sentence sounds AI-shaped, which heading buries the point.

If someone uses this to score other people's writing, fine. But the first job is policing yourself before you ship.

Why I keep updating it

I run it daily, so I find new things every week. A pattern I missed. A false alarm on real human prose. A new model with new tells. The list moves with the work. Expect a lot of changes.

Sponsors

GiveFeedback.dev uses AI to turn client screen recordings into clear tasks and stop scope creep.

Install

One command. The skill drops into your Claude Code skills folder. It runs automatically as a final QA pass on any prose Claude writes for a human reader — emails (internal or external), proposals, reports, blog posts, chat messages — and also wakes up on demand when you say things like "is this AI", "is this readable", "audit this", "humanize this", "slop check".

curl -L https://github.com/MahmoudHalat/slop-cop/releases/latest/download/ai-slop-detector.skill -o /tmp/slop-cop.zip \
  && unzip -o /tmp/slop-cop.zip -d ~/.claude/skills/ \
  && rm /tmp/slop-cop.zip

The skill lands at ~/.claude/skills/ai-slop-detector/. Restart Claude Code and it loads.

Want git? Clone right in:

git clone https://github.com/MahmoudHalat/slop-cop.git ~/.claude/skills/ai-slop-detector

Use

In Claude Code, just talk to it:

audit this draft for AI tells
is this AI?
is this readable?
humanize this
slop-check
de-slop this paragraph
comprehension check
would a fresh reader follow this?

Or run the scanner straight from the shell:

python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py path/to/draft.md
python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py --quick draft.md
python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py --json draft.md
python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py --genre academic draft.md
python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py --audience marketing draft.md
python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py --strict-em-dash draft.md
echo "your draft text" | python3 ~/.claude/skills/ai-slop-detector/scripts/scan.py

What it looks like

Four real test runs. Note how each test catches different things:

Look at row three. The text reads like a thoughtful human wrote it (low AI score). But it stuffs 36 names and 7 short forms into 359 words with no headings. A new reader has no chance. A simple AI scanner would miss the problem. slop-cop catches both halves.

What it catches

Two tests. Each one has its own list of patterns the scanner pulls from.

AI-Slop test

Comprehension test

A short list of the worst AI tells and comprehension tells lives at the top of SKILL.md. The skill is useful even before any other file loads.

Why two tests

Most prose tools collapse to one number. slop-cop won't, because the two problems need different fixes.

• AI-slop is the texture. The fix is swapping words and breaking shapes. delve becomes look at. Em-dash clusters become commas and periods. Sucking-up openers and crafted closers go.
• Comprehension is the friction. The fix is structure and clear names. Short forms get spelled out the first time. Big paragraphs get split with headings. Long run-on sentences get broken in two.

Mixing them gives you bad audits. A piece that passes AI-slop and fails comprehension ships because the one number looked fine. A piece that fails AI-slop but reads well gets a heavy rewrite when a five-minute polish would do. Two tests, two scores, one clear next step.

slop-cop also has a tuning layer that other tools skip:

• Density formula. (H × 3) + (M × 1) + (L × 0.25) per 500 words on both tests. One hit doesn't fail you. Clusters do.
• Genre tuning (AI-slop). Academic prose can use studies show with a citation. Marketing copy uses some boost words. Wikipedia-style triggers false alarms because models train on it. The scanner spots the genre and adjusts.
• Audience tuning (Comprehension). A blog post and a tech white paper need different sentence lengths and short-form limits. Pick --audience (casual / marketing / academic / encyclopedic / technical / fiction / healthcare) or let the scanner guess.
• Model fingerprint. When AI is in the text, the scanner names the model. GPT and Claude have different word habits.
• Sanded-prose check. Smart writers prompt around the famous tells like delve and tapestry. The scanner gives more weight to the newer tells (skipping is, present-participle tails, "From X to Y" lines, hedge stacks) since those slip past the sanding.
• Uncanny-valley flag. When no single tell is bad but eight or more weak tells stack with low sentence variety, the scanner bumps the score. That's the "feels off" effect.
• Compound triggers. 3+ undefined short forms in 100 words, 5+ names in the same window, or a 150+ word block with no heading all bump the comprehension score one tier.
• Burstiness. Sentence-length variety, shown as a number. Humans land at 0.6 to 1.2. AI lands at 0.2 to 0.4.
• Em-dash awareness. Em-dash clusters are still a strong tell. But one em dash on its own is mixed signal now (after GPT-5.1 added an opt-out). The scanner tags both.

Score scale

Same scale on both tests:

The combined next-step is pulled from a cross-test table in references/calibration.md §11. Two PASS means ship. Two CRITICAL means rewrite. Anything else gets one sentence telling you which test is driving the score and what to fix first.

Sources

The catalog draws from about 130 sources across both tests:

• AI-Slop test (~50 sources): peer-reviewed papers (PubMed, arXiv, Nature, PLOS One), Wikipedia's Signs of AI writing guide, AI-detector vendor pages (GPTZero, Pangram, Originality), writer blogs (tropes.fyi, avoid-ai-writing, Beutler Ink, Olivia Cal), and viral takedowns (Rolling Stone, TechRadar, LitHub, Scientific American, The Conversation, LessWrong).
• Comprehension test (~80 sources): the original reading-score papers (Flesch 1948, Kincaid 1975, McLaughlin 1969, Coleman-Liau 1975, Dale-Chall 1948/1995, DuBay 2004, Halliday & Hasan 1976), working-memory science (Miller 1956, Cowan 2001, Sweller 1988, Gibson 1998, Pinker 2014, Chase & Simon 1973), plain-language rules (US Plain Writing Act, plainlanguage.gov, GOV.UK, WCAG 3.1.5, CDC Clear Communication Index), web-reading research (Nielsen / NN/g 1997 to 2017), and the writing-craft canon (Strunk & White, Williams & Bizup, Zinsser, Lanham, Garner).

Every pattern names its sources. The full list is in references/sources.md.

A few facts from the AI-slop research:

• The verb delves rose +6,697% in 2024 PubMed papers over 2020 (arXiv)
• underscores rose +904%, intricate rose +611% in the same window
• today's fast-paced world shows up 107x more in AI than human text (GPTZero)
• objective study aimed shows up 269x more in AI (Atlas)
• A 2024 study found at least 13.5% of medical paper summaries that year were touched by AI

And from the comprehension research:

• Working memory holds about 4 chunks, not 7 (Cowan 2001)
• Web readers take in only ~20% of text on a page (NN/g 2008)
• Reading drops 20 to 30% when the same text is on a screen instead of paper (Wilkinson et al. 2011)
• WCAG AAA asks for a reading level no higher than 9th grade for general readers (W3C)

What it does not do

slop-cop is a detector, not a judge. The AI-Slop test tells you whether your prose has the shape of AI writing. It does not tell you whether AI wrote it. Skilled writers using AI for research can score PASS. Careful prompts can score LOW.

The Comprehension test tells you whether a fresh reader is likely to struggle. It does not test real reading (that takes user testing). The scores hint at the friction. The patterns flag the spots. But no formula is a real reader.

Treat both scores as "this prose has the shape of a problem", not "this prose has the problem." The fixes are clear. The scores point you at the exact edits.

Working with other writing skills

slop-cop slots in as the last check before any prose-making skill ships (cold-email, copywriting, sales-enablement, ad-creative, email-sequence, mahmouds-seo-writer, mahmouds-reddit-strategist, mahmouds-writing-voice). When those skills are about to send back prose, they call slop-cop in --quick mode and add the result as a footer.

The --quick flag exists for this. A few short lines:

AI-Slop: LOW (density 2.5) | Comprehension: CRITICAL (density 31.0)
AI-Slop violations: 0H, 2M, 2L
Comp violations:    10H, 1M, 0L [audience: casual]
Combined: Comprehension rewrite. The texture is fine but the reader can't follow.
Top fixes: undefined acronyms ×7, named-entity bombing ×36, wall-of-text paragraphs ×1

License

MIT. Use it. Fork it. Ship a fork with a meaner score scale. The list will need updates as models change. PRs welcome for new patterns, new spike data, new model fingerprints, and new comprehension friction signals.