humanize-text
Skill2 starsChanged 32 days agoMITView on GitHub
Write and rewrite natural, human-authored prose across articles, technical guides, and documentation while preserving voice, meaning, and nuance. Use when drafting, editing, or reviewing articles, blogs, documentation, READMEs, tutorials, technical explanations, product copy, release notes, social posts, or other prose that should sound specific, natural, and non-formulaic.
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
- BejeweledMe/codex-pro-agent-skillstheir own version, first seen Sep 6, 2026
- smyrick/skillstheir own version, first seen Sep 2, 2026
- DhruvPrajapati4/apply-kittheir 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
- smyrick/skills★ 2same name
- jasonfesta/design-agents★ 1same name
- DhruvPrajapati4/apply-kit★ 0same 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 repository11 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- cloudflare-email-workersSkill
- discord-activitiesSkill
- duckdb-wasmSkill
- mtcuteSkill
- openai-realtime-webrtcSkill
- openauthSkill
- restate-sdkSkill
- telegram-serverless-botSkill
- use-telegram-serverlessSkill
The file
Show its rules and text
We split this skill into the rules it gives an agent
29 rules. 0 are common, 29 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 4 edited versions we read keep these.
29
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 8
Write like a sharp human writer who understands the subject, not like an AI assistant producing polished generic prose.
- Distinctive: line 16
Keep strong original sentences.
- Distinctive: line 18
Do not unnecessarily restructure the writing.
- Distinctive: line 19
If the supplied text is already natural and effective, make minimal changes or leave it unchanged.
- Distinctive: line 22
Create new prose from the user's brief, audience, context, and examples.
- Distinctive: line 25
Use natural structure instead of rigid templates.
- Distinctive: line 26
Never invent personal opinions, feelings, stories, experiences, achievements, or anecdotes.
- Distinctive: line 27
Never invent facts, statistics, dates, sources, quotations, or technical behavior.
- Distinctive: line 37
Never claim to know whether a person or AI wrote the text.
- Distinctive: line 38
Never assign an AI-generated probability or score.
- Distinctive: line 54
Do not normalize dialect, regional phrasing, slang, or non-standard grammar unless it reduces clarity or the user asks for a more …
- Distinctive: line 68
Do not manufacture imperfections to make writing appear human.
- Distinctive: line 94
Do not make every paragraph equally polished, symmetrical, or similar in length.
- Distinctive: line 98
Treat these as contextual warnings, not banned words.
- Distinctive: line 118
Keep these patterns when they are useful, intentional, or characteristic of the writer.
- Distinctive: line 119
If a sentence sounds generically AI-written, rewrite the sentence rather than merely replacing one word.
- Distinctive: line 126
Verify behavior against code or an authoritative source when available.
- Distinctive: line 127
Put useful information early.
- Distinctive: line 128
Use a neutral instructional voice.
- Distinctive: line 131
Use active voice and present tense.
- Distinctive: line 134
Use inline code for commands, paths, identifiers, and values.
- Distinctive: line 135
Keep examples minimal and runnable.
- Distinctive: line 136
Never invent API behavior, configuration options, or command output.
- Distinctive: line 137
Use descriptive link text.
- Distinctive: line 139
Follow repository conventions when they conflict with these defaults.
- Distinctive: line 143
Before returning substantial prose:
- Distinctive: line 146
Remove generic or formulaic language.
- Distinctive: line 147
Remove repetition and unnecessary structure.
- Distinctive: line 151
Read it once as a human reader.
“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
Write like a sharp human writer who understands the subject, not like an AI assistant producing polished generic prose.
Modes
Edit
Improve supplied text with the minimum effective changes.
- Preserve meaning, facts, intent, voice, and personality.
- Keep strong original sentences.
- Fix awkward phrasing, repetition, filler, and formulaic language.
- Do not unnecessarily restructure the writing.
- If the supplied text is already natural and effective, make minimal changes or leave it unchanged.
Draft
Create new prose from the user's brief, audience, context, and examples.
- Match the requested tone and format.
- Use natural structure instead of rigid templates.
- Never invent personal opinions, feelings, stories, experiences, achievements, or anecdotes.
- Never invent facts, statistics, dates, sources, quotations, or technical behavior.
Detect
Audit text for formulaic or AI-like writing patterns without rewriting it.
- Identify observable patterns.
- Quote the relevant text.
- Explain briefly why it may sound formulaic.
- Suggest what could change.
Never claim to know whether a person or AI wrote the text. Never assign an AI-generated probability or score.
Preserve the writer
Preserve:
- Meaning and factual claims
- Nuance and uncertainty
- Intent
- Recognizable vocabulary
- Natural cadence
- Purposeful fragments
- Bluntness or informality
- Appropriate humor or profanity
- Deliberate rough edges
Do not normalize dialect, regional phrasing, slang, or non-standard grammar unless it reduces clarity or the user asks for a more standardized style.
Never invent:
- Facts
- Sources
- Quotes
- Personal experiences
- Emotions
- Opinions
- Achievements
- Benchmarks
- Technical behavior
Do not manufacture imperfections to make writing appear human.
Improve the prose
Prefer:
- Concrete nouns and specific details
- Direct verbs
- Simple words
- Natural sentence-length variation
- Active voice when clearer
- Focused paragraphs
- Headings and lists only when useful
Cut:
- Repetition
- Filler
- Throat-clearing
- Empty qualifiers
- Unnecessary introductions and conclusions
- Inflated claims
- Adjective stacking
- Corporate language
- Repeated explanations
Do not make every paragraph equally polished, symmetrical, or similar in length.
Watch for formulaic patterns
Treat these as contextual warnings, not banned words.
Watch for:
- Generic openings such as "In today's rapidly evolving..."
- "It's important to note..."
- "Furthermore", "Moreover", "In conclusion"
- Inflated or generic promotional language such as "groundbreaking", "revolutionary", "seamless", or "game-changing"
- Empty claims such as "plays a vital role"
- "Experts agree" or "studies show" without a named source
- Repeated "not X but Y" contrasts
- Forced rhetorical hooks
- Mechanical groups of three
- Decorative fragments
- Excessive em dashes or colons
- Repetitive punchy sentence patterns
- Synonym cycling
- Empty use of abstract or corporate vocabulary when a concrete word would be clearer
- Chatbot phrases such as "Of course", "I hope this helps", or "Let me know if..."
Keep these patterns when they are useful, intentional, or characteristic of the writer. If a sentence sounds generically AI-written, rewrite the sentence rather than merely replacing one word.
Technical documentation
For documentation:
- Identify the audience and goal.
- Verify behavior against code or an authoritative source when available.
- Put useful information early.
- Use a neutral instructional voice.
- Address the reader as "you".
- Prefer imperative verbs.
- Use active voice and present tense.
- Keep terminology consistent.
- Define unfamiliar terms and acronyms.
- Use inline code for commands, paths, identifiers, and values.
- Keep examples minimal and runnable.
- Never invent API behavior, configuration options, or command output.
- Use descriptive link text.
- Warn before destructive or irreversible operations.
- Follow repository conventions when they conflict with these defaults.
Final review
Before returning substantial prose:
- Preserve meaning, facts, uncertainty, and voice.
- Remove generic or formulaic language.
- Remove repetition and unnecessary structure.
- Check natural rhythm.
- Match the author, audience, and format.
- Confirm nothing was invented.
- Read it once as a human reader.
The objective is not "perfect writing".
The objective is writing that feels intentional, specific, credible, and naturally written by a person.
Default
Clear + natural + specific + concise + knowledgeable + appropriately conversational.
User style, audience, house style, and repository conventions take priority.
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.

