humanize-text
Skill0 starsChanged 2 months agoMITView on GitHub
Strip the tell-tale signatures of AI-generated prose so writing reads as naturally human. Removes em dashes and en dashes, converts smart quotes and other typographic Unicode to plain ASCII, and dials back robotic AI phrasing and structure. Use this as a finishing pass WHENEVER you generate, write, refine, rephrase, reword, polish, draft, or edit any prose the user will send or publish — emails, messages, docs, posts, cover letters, commit bodies, PR descriptions, blog text — even when the user only asks to "clean it up" or "make it sound natural" without naming AI. Do NOT apply it to code, code comments, config, or verbatim quotes.
6 other projects use a version of this.
Adopted by
Most recently taken up by
- podo/design-agent-skillstheir own version, first seen Nov 8, 2026
- jasonfesta/design-agentstheir own version, first seen Oct 15, 2026
- rijans/agent-skillstheir own version, first seen Oct 11, 2026
- BejeweledMe/codex-pro-agent-skillstheir own version, first seen Sep 6, 2026
- smyrick/skillstheir own version, first seen Sep 2, 2026
- promptmechanic/ai-toolboxtheir own version, first seen Aug 4, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- podo/design-agent-skills★ 32same name
- promptmechanic/ai-toolbox★ 14same name
- BejeweledMe/codex-pro-agent-skills★ 7same name
- rijans/agent-skills★ 2same name
- smyrick/skills★ 2same name
- jasonfesta/design-agents★ 1same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository10 other files it gives its agents.
- answer-questionsSkill
- apply-to-jobSkill
- extract-jdSkill
- find-and-applySkill
- find-jobsSkill
- ingest-resumeSkill
- render-resumeSkill
- resume-fit-reportSkill
- submit-applicationSkill
- tailor-resumeSkill
The file
We split this skill into the rules it gives an agent
5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
4
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
- Very specific: line 34
Leave ordinary hyphens in compound words alone (well-known, real-time, p99).
- Distinctive: line 44
Prefer plain equivalents (*use* over *utilize*, *show* over *underscore*).
- Distinctive: line 69
When you generate prose in a normal response, apply these fixes inline before you present it — the user should just receive clean text.
- Distinctive: line 71
When editing a file of prose, make the edits directly.
- Distinctive: line 75
If a change would distort meaning or the user explicitly wants a dash/quote kept, leave it and say why.
“Common” is measured: kept by at least 6 in 10 of the 4 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.
Files
humanize-text
AI-written prose has a recognizable fingerprint. The loudest tell is the em dash (—), which humans rarely type but models emit constantly, followed by smart quotes and a handful of stock phrases. This skill removes those signatures while preserving the writer's meaning and voice. Apply it as the last pass over any prose you produce for the user to send or publish.
The goal is text that reads as if a competent person typed it in a normal editor, not text that has been scrubbed into blandness. Fix the tells; keep the substance.
1. Punctuation and Unicode (the mechanical, high-signal fixes)
These are the strongest AI markers. Replace them thoughtfully — choose the punctuation a human would actually have used, don't just delete.
- Em dash
—: rewrite, don't blank out. Pick by role:- parenthetical aside → wrap in commas, or use parentheses
- a pause before a payoff/explanation → colon
- two independent clauses joined → split into two sentences, or use a semicolon
- Example:
We shipped it — finally.→We shipped it, finally. - Example:
Three services — auth, billing, search — went down.→Three services (auth, billing, search) went down.
- En dash
–:- number/date/page ranges → a hyphen, or the word "to" (
2019–2023→2019 to 2023) - used as a dash → treat like an em dash above
- number/date/page ranges → a hyphen, or the word "to" (
- Smart/curly quotes
“ ” ‘ ’→ straight"and'. - Ellipsis
…→ three periods..., or cut it (trailing ellipses read as AI hedging). - Non-breaking spaces, zero-width chars, and other stray Unicode → normal ASCII space or delete.
- Leave ordinary hyphens in compound words alone (
well-known,real-time,p99).
2. Phrasing tells (lighter touch — reduce, don't robotically purge)
Models overuse a stock vocabulary and a few sentence shapes. Trim them where they appear, but only if the replacement stays natural — don't mangle a fine sentence just to avoid a word.
- Inflated verbs/nouns: delve, leverage, utilize, foster, underscore, elevate, boast, harness, spearhead, tapestry, realm, landscape, testament, beacon. Prefer plain equivalents (use over utilize, show over underscore).
- Hollow intensifiers: seamless, robust, cutting-edge, game-changing, best-in-class, world-class, unlock, supercharge.
- Formulaic frames: "It's not just X, it's Y", "In today's fast-paced world", "At the end of the day", "When it comes to…" — cut or rephrase directly.
- Throat-clearing transitions stacked at sentence starts: Moreover, Furthermore, Additionally, In conclusion. Keep at most where they earn their place.
- Compulsive rule-of-three lists and perfectly parallel bullet phrasing — vary the rhythm; real writing is a little uneven.
- Emoji sprinkled into headings or bullets (unless the user's own style uses them).
3. What NOT to touch
Correctness matters more than de-AI-ing. Never alter:
- Code, code blocks, inline code, commands, file paths, URLs, regexes — a dash or quote there is syntax, not style.
- Verbatim quotations, names, citations, and literal strings the user must keep exact.
- Technical notation: ranges/signs where a hyphen is meaningful (
-1,x-y), version numbers, IDs. - The meaning, claims, or facts of the text. This is a style pass only.
Applying it
- When you generate prose in a normal response, apply these fixes inline before you present it — the user should just receive clean text.
- When editing a file of prose, make the edits directly.
- For a large plain-prose file,
scripts/humanize.py <file>does the safe mechanical pass (dashes, quotes, ellipses, stray Unicode) and skips fenced code blocks; the phrasing work in section 2 still needs your judgment. - If a change would distort meaning or the user explicitly wants a dash/quote kept, leave it and say why.
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
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.

