agentleFS
hdprajwalhdprajwal/agent-skills/skills/unslop/SKILL.md

unslop

Skill1 starsChanged 5 months agoMITView on GitHub

Make any writing sound plain, human, and simple. Use to edit, rewrite, or polish text so it reads like a real person wrote it in one sitting — emails, posts, messages, outreach, docs, essays, drafts. Strips AI tells and clever filler, then rewrites in plain spoken English: short sentences, everyday words, honest claims, no swagger. Triggers: "humanize this", "make this sound human", "simplify this", "rewrite this plainer", "remove AI", "polish this", "make it less like a chatbot".

197 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use principle-never-block-on-the-human, greploop-apps and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • jaydubya818Skill

    principle-never-block-on-the-human

    Apply when safe reversible implementation details can proceed inside scope.

    Also in 45 projects that use this

  • jaydubya818Skill

    greploop-apps

    Run greploop through @greptile-apps when the normal trigger rejects a large PR. Use only with the companion greploop skill.

    Also in 5 projects that use this

  • ianclearySkill

    principle-explain-the-number

    Apply before you trust, report, or act on a number you measured: a speedup, a regression, a throughput, a latency, or an eval result. Find what limits it, and rule out that it measured something other than the work you think.

    Also in 30 projects that use this

  • bnemaSkill

    setup-pstack

    Configure which Pi models pstack uses per role. Detects available provider/model specs and writes pstack's user configuration. Use for /setup-pstack, "configure pstack models", or changing pstack model choices.

    Also in 26 projects that use this

  • ianclearySkill

    poteto-help

    Guides users through pstack setup, /poteto-mode, and picking the skill, playbook, or principle for a task. Type /poteto-help with a question.

    Also in 15 projects that use this

  • +7 more from jaydubya818

The file

We split this skill into the rules it gives an agent

9 rules. 0 are common, 8 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 193 edited versions we read keep these.

  • 8

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Read every line back as if you were saying it out loud to a smart, busy person.

    line 22
  2. Distinctive:

    Add life, but the plain way:

    line 42
  3. Distinctive:

    Be specific about the real thing: instead of reaching for an abstraction.

    line 48
  4. Very specific:

    No decorative bold/italic: No mechanical emphasis on terms, no inline-header lists.

    line 57
  5. Distinctive:

    Never fabricate: If the original lacks specifics, keep it general or flag it for the author.

    line 69
  6. Distinctive:

    Read the whole draft. Note its purpose and audience.

    line 74
  7. Distinctive:

    When issues compound, fix in this order:

    line 85
  8. Distinctive:

    After the draft rewrite, ask: "What still makes this read as AI-generated or workshopped?" Answer briefly with any remaining tells, then do …

    line 93
  9. Distinctive:

    If the draft was already clean, skip all of this and just say so.

    line 147

“Common” is measured: kept by at least 6 in 10 of the 193 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Unslop: make writing plain and human

Take any draft and make it read the way a real person talks: plain, simple, direct. The reader should feel like one person wrote it in one sitting, not like it was workshopped or generated. When in doubt, make it simpler.

This skill does two things in one pass: it removes the signs of AI-generated text, and it rewrites toward a plain spoken voice. Removing AI tells is only half the job — clean but lifeless writing is just as obviously machine-made as slop. The target is plain and alive.

The north star

Read every line back as if you were saying it out loud to a smart, busy person. If you would not say it in a normal conversation, cut it or rewrite it. That single test catches most of what this skill is for.

The voice (what to aim for)

  1. Plain, spoken English. Short sentences. Everyday words. Say the plain thing.
  2. No clever or writerly phrasing. Kill metaphors, turns of phrase, "positioning" lines, and anything that reads like it was written to be quotable. Say the plain thing instead. ("My recent work sits right where you operate" → "I've been working on the same problems you have.")
  3. No jargon, aphorisms, or filler. Drop corporate words and clever generalizations. Cut throat-clearing ("I would genuinely like to be in that conversation" → "I'd really like to talk").
  4. Confidence comes from facts, not swagger. State what's true plainly and let it stand. Don't command the reader, don't claim you're better than others, don't perform. "I'm confident I can contribute" is fine. "Give me 15 minutes and I'll show you exactly where I'd plug in" is not. Put a real fact next to any confident line so it's earned.
  5. Never inflate or invent. Claim only what's literally true. Numbers must be honest and sourced. If you're unsure a claim is accurate, keep it general or flag it for the author — never fabricate sources, anecdotes, quotes, or stats to sound more human.
  6. Explain technical things plainly. Name the tool, then say what it does in one simple clause. Replace insider terms with what they actually do ("correctness matrix" → "a clear report of what passed and what failed").

Soul, the plain way

A plain voice is not a flat voice. Sterile, voiceless writing reads as machine-made even when it's technically clean: every sentence the same length, no opinion, no first person, no acknowledgment that anything is hard or uncertain. Reads like a press release.

Add life, but the plain way:

  • Have a point of view, stated calmly. React to facts, don't just list them. "I keep coming back to..." beats neutral reporting.
  • Vary the rhythm. Short punchy sentences. Then a longer one that takes its time. Mix it.
  • Use "I" when it fits. First person is honest, not unprofessional.
  • Acknowledge what's hard or mixed. Real people have mixed feelings and say so.
  • Be specific about the real thing instead of reaching for an abstraction.

What "soul" does not mean here: edge, controversy, cleverness, hot takes, or performance. Those are their own AI tell and they break the plain voice. The personality comes from honesty and specificity, not from sounding bold. When restraint and "edge" conflict, restraint wins.

Hard formatting constraints

  • No em dashes or en dashes (— or –) anywhere. Use commas, periods, or "and"/"but". Hyphens inside compound words (multi-cloud, fast-moving) are fine.
  • No emojis.
  • No Markdown blockquotes for anything the user will copy-paste (emails, messages, posts, snippets). Deliver copy-paste content in a plain fenced code block (```text) or plain paragraphs. Blockquotes are only for quoting the user's own prior text back to them.
  • No decorative bold/italic. No mechanical **emphasis** on terms, no inline-header lists.

Do not touch

Preserve these exactly as-is:

  • Direct quotes — attributed speech or quotations from real people
  • Code — inline code, fenced blocks, API references, version numbers, config values
  • Legal language — terms, disclaimers, compliance text
  • Proper nouns and titles — names, products, organizations
  • Data and statistics — numbers, dates, measurements (unless the framing around them is the AI-sounding part)

Never fabricate. If the original lacks specifics, keep it general or flag it for the author. Do not invent detail to make text sound more human.

The process (one pass, then decide)

Step 1 — Intake

Read the whole draft. Note its purpose and audience. If voice samples or context were provided, pull the patterns from them. Otherwise aim for the plain voice above.

Step 2 — Single-pass scan

Scan the draft once against the detection catalog in PATTERNS.md. Flag every tell in one sweep. Do not stop and rewrite between checks — find everything first, then rewrite. Use the quick table below for the fast scan and PATTERNS.md for the detailed before/after of any pattern you're unsure about.

Step 3 — Decide

If the draft is already plain and clean: say so and change nothing. "This reads plainly and clean. Nothing to fix." Do not manufacture edits to justify running the skill. A no-op is a valid, encouraged outcome.

If there are issues: don't just list them — rewrite. Resolve every flagged tell and rewrite toward the plain voice. You have full authority to restructure, reorder, cut, and rewrite transitions when it makes the writing plainer and stronger. Preserve the core message and any real facts; everything else is fair game.

When issues compound, fix in this order:

  1. Fabrication, inflation, and inaccuracy (non-negotiable — accuracy first)
  2. Clever phrasing, swagger, and AI tells (the core voice fixes)
  3. Filler and restated points (cuts that tighten)
  4. Flow and structure (rewrites that read better aloud)
  5. Formatting (em dashes, bold, emoji, blockquotes, lists → prose)

Step 4 — Anti-AI audit

After the draft rewrite, ask: "What still makes this read as AI-generated or workshopped?" Answer briefly with any remaining tells, then do one more pass to fix them. This catches the rhythm and phrasing that the pattern scan misses.

Quick-reference catalog

Full before/after for each is in PATTERNS.md.

#PatternSeverityTrigger
1Significance inflationHIGHtestament, pivotal, evolving landscape, vital role
2Notability emphasisMEDactive social media presence, leading expert
3Superficial -ing phrasesHIGHhighlighting, showcasing, reflecting, ensuring
4Promotional languageHIGHnestled, vibrant, breathtaking, groundbreaking
5Vague attributionsHIGHexperts argue, industry reports, observers
6Challenges and prospectsMEDdespite challenges, future outlook
7AI vocabularyHIGHdelve, landscape, tapestry, leverage, nuanced
8Copula avoidanceMEDserves as, stands as, boasts, features
9Negative parallelismsMEDnot just X, it's Y; not only...but
10Rule of threeMEDthree-item lists forced for rhetoric
11Synonym cyclingLOWprotagonist/main character/central figure/hero
12False rangesLOWfrom X to Y (non-meaningful scale)
13Em dash overuseMEDexcessive — or em dash usage
14Boldface overuseLOWmechanical emphasis on terms
15Inline-header listsMEDHeader: description pattern
16Title case headingsLOWEvery Word Capitalized
17EmojisLOWdecorative emoji in headers/bullets
18Curly quotes (some models)LOWcurly quotes instead of straight
19Hyphenated word-pair overuseLOWcross-functional, data-driven uniformity
20Persuasive tropes / signpostingMEDthe real question is, let's dive in
21Single quotes in proseLOW'single quotes' instead of "double"
22Collaborative artifactsHIGHI hope this helps, let me know, certainly!
23Knowledge-cutoff disclaimersMEDas of [date], based on available information
24Sycophantic toneHIGHgreat question!, you're absolutely right!
25Post-action summariesHIGHtrailing summary of what was just said
26Unsolicited ethical caveatsMEDit's worth noting the ethical implications
27Second-person lockMEDpersistent "you" address in prose
28Markdown overuse in proseMEDunneeded headers, bullets, bold in flowing text
29Filler phrasesMEDin order to, due to the fact that
30Excessive hedgingMEDcould potentially possibly, might have some
31Generic positive conclusionsMEDfuture looks bright, exciting times ahead
32Clever/writerly phrasingHIGHquotable "positioning" lines, metaphors for effect
33Swagger and commandsHIGHgive me 15 minutes, I'd back myself, trust me
34Fake first-person authorityMEDI've seen this play out, I see this constantly
35Clever comparative endingsMEDthe worst X do Y, the best X do Z
36Anaphora / stacked openingsMEDrepeated identical sentence openings
37Rhetorical-question fragmentsMEDThe reality? Why does this matter?
38"Most"-openersLOWsentences starting with "Most people..."

Output format

  1. Draft rewrite — in a fenced code block so it's clean to copy.
  2. What still reads as AI or workshopped? — brief bullets (or "nothing").
  3. Final rewrite — the version after the audit pass (skip if the draft needed no further fixes).
  4. Changes made — a short list of the swaps, especially anything simplified or any claim softened for accuracy. If you had to choose between two honest phrasings and one is slightly stronger, offer the calmer alternative and let the author pick.

If the draft was already clean, skip all of this and just say so.

Origin

This skill merges three earlier ones: the plain-voice writing rules (the voice target), the humanize de-AI catalog (the detection patterns, based on Wikipedia: Signs of AI writing), and a one-pass quality-gate process (intake → single scan → clean-exit decision → prioritized rewrite). The voice is the north star; the catalog and process serve it.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.