Smithery is now a part of Arcade.dev! Read more in our announcement here
Remove telltale signs of AI-generated 'slop' writing from README files and documentation. Make your docs sound authentically human.
Core Insight: You can't do this with regex or a script. It requires manual, systematic review of each line. Slop has a mechanism: the text becomes simultaneously less specific and more exaggerated — rare concrete facts get smoothed into generic important-sounding claims. So the fix is never just deleting tics; it's reinstating the concrete detail the slop displaced. Human writers use most of these devices intentionally and sparingly; the problem is density and reflex, not any single occurrence.
I want you to read through the complete text carefully and look for any telltale
signs of "AI slop" style writing; one big tell is the use of emdash. You should
try to replace this with a semicolon, a comma, or just recast the sentence
accordingly so it sounds good while avoiding emdash. This applies to emdashes
used as prose punctuation only: leave dash/minus characters alone when they are
doing non-prose work, such as in math formulas, code, CLI flags, numeric ranges,
or tables.
Also, you want to avoid certain telltale writing tropes:
- Setup-reversal copy ("Four steps, and only one of them is yours." /
"Everything about billing changed. Your invoice didn't.")
- Negative parallelism ("It's not [just] XYZ, it's ABC")
- Clickbait lead-ins ("Here's why", "Here's the thing")
- AI vocabulary clusters (delve, pivotal, tapestry, intricate, underscores,
seamless, robust, vibrant, leverage) and copula avoidance ("serves as",
"marks a", "boasts" instead of plain "is"/"has")
- Significance inflation ("marks a pivotal moment", trailing "-ing" commentary
clauses like "highlighting its importance")
- Bullet lists of "- **Snappy Label:** text" where prose would read better
- Filler: paragraphs that say in four sentences what fits in one
Basically, anything that sounds like the kind of thing an LLM would write
disproportionately more commonly than a human writer and which sounds
inauthentic/cringe.
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. Use ultrathink.
Review this text and remove AI slop patterns: emdashes used as prose
punctuation (not dashes in math, code, or ranges), setup-reversal copy, "It's not X, it's Y" formulas, "Here's
why" lead-ins, AI vocabulary (delve/pivotal/tapestry/underscores/seamless),
"serves as" instead of "is", trailing "-ing" significance clauses, bold-label
bullet lists, and filler. Recast sentences to sound naturally human; restore
concrete specifics where slop replaced them. Use ultrathink.
| Pattern | Example | Fix |
|---|---|---|
| Setup-reversal copy (paraprosdokian) | "Four steps, and only one of them is yours." / "A thousand integrations, and you'll only ever click one." / "Everything about billing changed. Your invoice didn't." | State what the tool does plainly. No dramatic pivot. |
| Negative parallelism | "It's not just a linter—it's a complete system" / "not X, but Y" / "no X, no Y, just Z" | Say what it is; drop the strawman denial |
| AI vocabulary clusters | delve, tapestry, intricate, pivotal, robust, seamless, vibrant, leverage, testament, landscape, spine, seam, smoke-test (several together) | Plain synonyms; density is the signal |
| Copula avoidance | "serves as", "stands as", "marks a", "boasts/features/offers" for has, "holds the distinction of being" | "is" / "has" |
| Significance inflation | "marks a pivotal moment", "underscores the importance", trailing ", highlighting..." / ", emphasizing..." / ", ensuring..." clauses | Cut the commentary; keep or add the fact |
| "Here's why" family | "Here's why it matters:", "Here's the thing", "The solution? Simpler than you think." | Explain directly, or delete |
| Emdash overuse | — as prose punctuation (never dashes in math, code, or ranges) |
Comma, semicolon, colon, or split the sentence |
| Bold-label bullets | - **Blazing Fast:** processes files in ms |
Prose, or plain bullets |
| Forced enthusiasm | "Let's dive in!", "We're thrilled to announce" | Just start / just announce |
| Reflexive triads | "Fast, efficient, and reliable" / third item padded with "and other X" | Keep the one or two claims that are true and specific |
| Vapid transitions | "As technology continues to evolve", "In today's fast-paced world", sentence-initial "Additionally," | Delete or replace with a real transition |
Setup-reversal copy:
Before: Ten features. Zero headaches.
After: Includes ten features for managing billing, invoicing, and usage tracking.
Emdash + negative parallelism:
Before: It's not just a linter—it's a complete code quality system.
After: A code quality system that covers linting, formatting, and CI checks.
"Here's why":
Before: We chose Rust for this component. Here's why: performance matters.
After: We chose Rust for this component because performance matters.
Significance inflation (restore the specific fact):
Before: The v2 release marks a pivotal moment, underscoring our commitment to reliability.
After: v2 fixes the three crash bugs reported since March.
Copula avoidance:
Before: The CLI serves as the primary entry point and boasts a robust plugin system.
After: The CLI is the primary entry point and has a plugin system.
Forced enthusiasm:
Before: Let's dive in! We're excited to help you get up and running.
After: Install the tool and run your first command in under a minute.
| Topic | Reference |
|---|---|
| Complete pattern catalog with fixes | PATTERNS.md |
