Stop Slop

repository·main·Indexed 9 days ago

https://github.com/hardikpandya/stop-slop

A 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.

Tokens
5.6K
Snippets
16
Records
31
Agent score
97%

What's inside Stop Slop

  1. Use Stop Slop to eliminate AI writing patterns

    main
    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.
  2. How Stop Slop identifies AI writing patterns

    main

    Stop Slop targets three specific categories of AI-generated 'slop':

    1. Banned phrases: Includes throat-clearing openers, emphasis crutches, business jargon, all adverbs, vague declaratives, and meta-commentary (detailed in references/phrases.md).
    2. 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).
    3. 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.

  3. Quick start with Stop Slop

    main

    Stop 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.md and the files in the references/ directory to your project knowledge.
    • Custom Instructions: Copy the core rules directly from SKILL.md into your system instructions.
    • API Calls: Include the contents of SKILL.md in 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.
  4. Apply the Core Rules of Stop Slop

    main

    To eliminate AI patterns, follow these eight core rules:

    1. Cut filler phrases: Remove throat-clearing openers, emphasis crutches, and all adverbs.
    2. Break formulaic structures: Avoid binary contrasts, negative listings, dramatic fragmentation, rhetorical setups, and false agency.
    3. 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").
    4. Be specific: Avoid vague declaratives (e.g., avoid "The reasons are structural"). Name specific things and avoid lazy extremes like "every," "always," or "never."
    5. Put the reader in the room: Avoid a "narrator-from-a-distance" voice. Use "You" instead of "People," and use specifics instead of abstractions.
    6. Vary rhythm: Mix sentence lengths. Use two items instead of three. End paragraphs differently. Do not use em dashes.
    7. Trust readers: State facts directly. Skip softening, justification, or hand-holding.
    8. Cut quotables: If a sentence sounds like a potential pull-quote, rewrite it.
  5. Perform Quick Checks on prose

    main

    Before 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.
  6. Eliminate filler and unnecessary reassurance

    main

    Remove 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."
  7. Remove business jargon stacks

    main

    Identify 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."
  8. Remove rhetorical scaffolding

    main

    Avoid 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."
  9. Identify and remove throat-clearing and binary contrast

    main

    Avoid 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."
  10. Avoid dramatic fragmentation

    main

    Avoid 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."
  11. Score prose quality with the Stop Slop rubric

    main

    You 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:

    DimensionQuestion
    DirectnessStatements or announcements?
    RhythmVaried or metronomic?
    TrustRespects reader intelligence?
    AuthenticitySounds human?
    DensityAnything cuttable?

    Threshold: A total score below 35/50 indicates that the text requires revision.

  12. Replace Business Jargon with plain language

    main

    Avoid corporate jargon and replace it with direct, plain language to improve clarity.

    AvoidUse instead
    Navigate (challenges)Handle, address
    Unpack (analysis)Explain, examine
    Lean intoAccept, embrace
    Landscape (context)Situation, field
    Game-changerSignificant, important
    Double downCommit, increase
    Deep diveAnalysis, examination
    Take a step backReconsider
    Moving forwardNext, from now
    Circle backReturn to, revisit
    On the same pageAligned, agreed