Stop Slop
repository·main·Indexed 9 days ago
https://github.com/hardikpandya/stop-slopA skill designed to help LLMs identify and remove predictable AI writing patterns—including jargon, structural clichés, and metronomic rhythms—to produce more human-sounding prose. It provides a framework for eliminating banned phrases, rhetorical scaffolding, and passive voice, and includes a scoring rubric to evaluate prose quality across dimensions of directness, rhythm, trust, authenticity, and density.
What's inside Stop Slop
- Stop Slop is a framework designed to remove predictable AI writing patterns from prose. It is used during drafting, editing, or reviewing text to eliminate 'AI tells' and ensure prose sounds human and direct. Use this skill when you need to transform formulaic, 'slop'-heavy text into high-quality, authentic writing.
How Stop Slop identifies AI writing patterns
mainStop Slop targets three specific categories of AI-generated 'slop':
- Banned phrases: Includes throat-clearing openers, emphasis crutches, business jargon, all adverbs, vague declaratives, and meta-commentary (detailed in
references/phrases.md). - Structural clichés: Includes binary contrasts, negative listings, dramatic fragmentation, rhetorical setups, false agency, narrator-from-a-distance voice, and passive voice (detailed in
references/structures.md). - Sentence-level rules: Enforces constraints such as no 'Wh-' sentence starters, no em dashes, no staccato fragmentation, no lazy extremes, and a requirement for active voice.
To use these rules, ensure the
references/directory is available to the LLM to provide specific examples and lists.- Banned phrases: Includes throat-clearing openers, emphasis crutches, business jargon, all adverbs, vague declaratives, and meta-commentary (detailed in
Quick start with Stop Slop
mainStop Slop is a skill designed to remove AI-typical patterns (predictable phrases, structures, and rhythms) from prose. Depending on your interface, use the following methods to implement it:
- Claude Code: Add the
stop-slop/folder as a skill. - Claude Projects: Upload
SKILL.mdand the files in thereferences/directory to your project knowledge. - Custom Instructions: Copy the core rules directly from
SKILL.mdinto your system instructions. - API Calls: Include the contents of
SKILL.mdin your system prompt. Note that reference files are intended to be loaded on demand.
# Implementation methods 1. Claude Code: Add this folder as a skill. 2. Claude Projects: Upload SKILL.md and reference files to project knowledge. 3. Custom instructions: Copy core rules from SKILL.md. 4. API calls: Include SKILL.md in your system prompt.- Claude Code: Add the
Apply the Core Rules of Stop Slop
mainTo eliminate AI patterns, follow these eight core rules:
- Cut filler phrases: Remove throat-clearing openers, emphasis crutches, and all adverbs.
- Break formulaic structures: Avoid binary contrasts, negative listings, dramatic fragmentation, rhetorical setups, and false agency.
- Use active voice: Ensure every sentence has a human subject performing an action. Avoid passive constructions and inanimate objects performing human actions (e.g., avoid "the complaint becomes a fix").
- Be specific: Avoid vague declaratives (e.g., avoid "The reasons are structural"). Name specific things and avoid lazy extremes like "every," "always," or "never."
- Put the reader in the room: Avoid a "narrator-from-a-distance" voice. Use "You" instead of "People," and use specifics instead of abstractions.
- Vary rhythm: Mix sentence lengths. Use two items instead of three. End paragraphs differently. Do not use em dashes.
- Trust readers: State facts directly. Skip softening, justification, or hand-holding.
- Cut quotables: If a sentence sounds like a potential pull-quote, rewrite it.
Perform Quick Checks on prose
mainBefore finalizing prose, run through this checklist to identify and fix AI-like patterns:
- Adverbs: Kill them.
- Passive voice: Find the actor and make them the subject.
- Inanimate agency: If an inanimate thing is doing a human verb (e.g., "the decision emerges"), name the person instead.
- Wh- words: If a sentence starts with a Wh- word, restructure it.
- Throat-clearing: Cut phrases like "here's what/this/that."
- Contrasts: Replace "not X, it's Y" structures with a direct statement of Y.
- Sentence rhythm: If three consecutive sentences match in length, break one.
- Paragraph endings: If a paragraph ends with a punchy one-liner, vary the structure.
- Em-dashes: Remove them.
- Vague declaratives: Replace phrases like "The implications are significant" with the specific implication.
- Distance: Replace "narrator-from-a-distance" voices (e.g., "Nobody designed this") by putting the reader in the scene.
- Meta-joiners: Delete phrases like "The rest of this essay..." and let the text move naturally.
Eliminate filler and unnecessary reassurance
mainRemove hedging words (e.g., "most") and throat-clearing phrases. Avoid ending segments with permission-granting or reassuring phrases (e.g., "And that's okay") that do not add substantive value to the core message.
Before: "It turns out that most teams struggle with alignment. The uncomfortable truth is that nobody wants to admit they're confused. And that's okay." After: "Teams struggle with alignment. Nobody admits confusion."Remove business jargon stacks
mainIdentify and eliminate clusters of corporate jargon such as "In today's fast-paced landscape," "lean into discomfort," or "navigate uncertainty with clarity." Replace these with the core message expressed in as few words as possible.
Before: "In today's fast-paced landscape, we need to lean into discomfort and navigate uncertainty with clarity. This matters because your competition isn't waiting." After: "Move faster. Your competition is."Remove rhetorical scaffolding
mainAvoid using rhetorical setups or questions to introduce a point (e.g., "What if I told you..." or "Here's what I mean..."). Replace the scaffolding with a direct claim to increase impact and clarity.
Before: "What if I told you that the best teams don't optimize for productivity? Here's what I mean: they optimize for learning. Think about it." After: "The best teams optimize for learning, not productivity."Identify and remove throat-clearing and binary contrast
mainAvoid starting sentences with conversational openers like "Here's the thing" or "It turns out that". Instead of using binary contrast structures (e.g., "Not because X. Because Y.") or emphasis crutches (e.g., "Let that sink in"), use direct, declarative statements to convey information more efficiently.
Before: "Here's the thing: building products is hard. Not because the technology is complex. Because people are complex. Let that sink in." After: "Building products is hard. Technology is manageable. People aren't."Avoid dramatic fragmentation
mainAvoid using performative emphasis through fragmented, single-word sentences (e.g., "Speed. Quality. Cost."). Instead, consolidate these ideas into a single, cohesive sentence to avoid unnecessary dramatic effect.
Before: "Speed. Quality. Cost. You can only pick two. That's it. That's the tradeoff." After: "Speed, quality, cost—pick two."Score prose quality with the Stop Slop rubric
mainYou can evaluate the quality of prose using the Stop Slop scoring system. Rate each of the following five dimensions on a scale of 1-10:
Dimension Question Directness Statements or announcements? Rhythm Varied or metronomic? Trust Respects reader intelligence? Authenticity Sounds human? Density Anything cuttable? Threshold: A total score below 35/50 indicates that the text requires revision.
Replace Business Jargon with plain language
mainAvoid corporate jargon and replace it with direct, plain language to improve clarity.
Avoid Use instead Navigate (challenges) Handle, address Unpack (analysis) Explain, examine Lean into Accept, embrace Landscape (context) Situation, field Game-changer Significant, important Double down Commit, increase Deep dive Analysis, examination Take a step back Reconsider Moving forward Next, from now Circle back Return to, revisit On the same page Aligned, agreed