humanizer
Skill4 starsChanged 54 days agoMITView on GitHub
Remove AI-writing tells from text - 65 catalogued patterns plus measured AI-detector results. Use when humanizing a draft, editing text to sound human or natural, or lowering an AI detector score before publishing.
188 other projects use a version of this.
Adopted by
Most recently taken up by
- aditya-vermax/skillstheir own version, first seen Nov 8, 2026
- chrisleekr/skillstheir own version, first seen Nov 8, 2026
- xhqing/CommunityManagerAgenttheir own version, first seen Nov 8, 2026
- CloudChef/atlasclaw-providerstheir own version, first seen Nov 8, 2026
- Fractera/Agent-Engineering-Infrastructuretheir own version, first seen Nov 8, 2026
- Fractera/Agentic-Engineering-Infrastructuretheir own version, first seen Nov 8, 2026
Used with
Projects with it also use economy-mode, personal-voice 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.
Microsoft AzureSkilleconomy-mode
Shifts Layer 3 model selection to cost-optimized alternatives when economy mode is active.
Also in 4 projects that use this
petermuirurithuoSkillpersonal-voice
Captures the user's personality, communication style, and values. Use this skill whenever responding to the user, drafting anything on their behalf (emails, CVs, messages, opinions, explanations), or whenever tone, word choice, or how an opinion is delivered matters. Apply it by default for any prompt, not only when the user explicitly asks for "my style" or "my voice.
Also in 3 projects that use this
Microsoft AzureSkillarchitectural-proposals
How to write comprehensive architectural proposals that drive alignment before code is written
Also in 3 projects that use this
- +9 more from Azure
Other versions188 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 188
- NousResearch/hermes-agent★ 262ksame name
- blader/humanizer★ 63ksame name
- QuivrHQ/quivr★ 40ksame name
- The-Vibe-Company/quivr★ 40ksame name
- rommapp/romm★ 14ksame name
- github/gh-aw★ 5.6ksame name
- latitude-dev/latitude-llm★ 4.7ksame name
- github/squad★ 3.4ksame name
- compozy/compozy★ 2.9ksame name
- SRombauts/SQLiteCpp★ 2.8ksame name
178 more not listed
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 repository18 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- agent-browserSkill
- ai-writing-detectorSkill
- animate-svgSkill
- browserbaseSkill
- clickhouseSkill
- commitSkill
- geist-designSkill
- generate-faviconSkill
- generate-imageSkill
- google-indexingSkill
- google-search-consoleSkill
- google-searchSkill
- keyword-researchSkill
- parallelSkill
- remove-backgroundSkill
- reviewSkill
- web-uiSkill
The file
We split this skill into the rules it gives an agent
3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.
0
Common
Most of the 175 edited versions we read keep these.
2
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
- Distinctive: line 36
Verify: - read it aloud. Sounds like Wikipedia?
- Distinctive: line 116
Publish gate: never publish - to a CMS, repo, MCP endpoint, file or anywhere else - until both loops below have run and the final score is …
- Very specific: line 150
All 65 patterns, one line each.
“Common” is measured: kept by at least 6 in 10 of the 175 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
Humanizer: remove AI writing patterns
Strip the signs of AI-generated text, then add the human tells detectors look for. Based on Wikipedia's "Signs of AI writing" (WikiProject AI Cleanup) plus hands-on testing against the Pangram detector.
Current models already avoid the obvious tells unprompted. What earns its keep here is the measured, counterintuitive part: structure beats vocabulary, polishing makes things worse, and some topics cannot be rescued at all.
Process
- Assess the content type - set a realistic target from the difficulty table below before editing anything.
- Remove AI patterns - scan for all 65 patterns in the index below. The index is enough to spot them; open the reference file for any pattern whose fix you need worked through.
- Add human patterns - specific numbers and timeframes, self-deprecating asides, admitted uncertainty, varied sentence rhythm, casual transitions ("Look," "Anyway," "Point is,"), broken parallelism in lists. Removing tells without adding voice leaves sterile text that still flags.
- Verify - read it aloud. Sounds like Wikipedia? Add voice. Sounds over-polished? Put roughness back. Report the rewrite plus a short changelog: patterns removed, human patterns added, structural changes.
Narrative-first structure
The highest-leverage move, and the one most often skipped. For how-to, guide or advice content, lead with narrative and weave structure in.
Measured: pure narrative scores 30-35% AI, pure how-to 60-100%, narrative with structure woven in 40-50% and it reads better and it still ranks.
Open with a specific personal experience. Establish the problem through narrative, not bullets. Introduce solutions as things you tried, not "Step 1, Step 2". Keep headers, bold and lists sparse, for scanning only. Close with reflection, not a CTA. So "## How to Build Backlinks / - Digital PR: ..." becomes "I wasn't planning to write another backlinks post. Google keeps saying they matter less. Yet every time I look at actual data - my own sites, client sites - links are still the biggest factor. ... ## Digital PR (the best ROI right now) / Took me a while to come around on this one."
Measured detector results
Real Pangram runs, not estimates:
- Narrative blog post: 100% -> 35% AI. Aggressive humanization works.
- How-to guide: 100% -> 53-90% per segment; individual sections improved, the overall label stayed "AI".
- AI/SEO industry post: 100% -> 100% AI, segments 99.98% -> 99.91%. Barely moved despite anecdotes, self-deprecation, tangents, casual headers, fragments and varied structure.
Voice work has a ceiling, and structure and topic set it.
Content-type difficulty
| Content type | Difficulty | Realistic target |
| Personal narrative | Easy | Below 30% AI |
| Opinion / hot take | Easy | Below 35% AI |
| Mixed narrative + advice | Medium | Below 45% AI |
| How-to guide | Hard | 50-70% AI (win at segment level) |
| Pure listicle | Very hard | May not drop below 60% |
| AI / SEO / marketing topics | Near-impossible | May stay 100% regardless of effort |
A personal essay drops from 80% to 30% on voice changes alone. The same effort on a how-to moves 100% to 60%, because the structure itself is the signal.
The polished-rewrite trap
Over-editing increases detection scores. Clean rewrites routinely score higher than the rough originals they replaced - one measured pair went 50% (tidy rewrite) versus 35% (rougher version, same content). Detectors flag consistent sentence lengths, perfect parallel structure, smooth transitions and the absence of false starts. Leave the rough edges in.
Related traps: structure (how-to formats flag regardless of voice), consistency (uniform sentence length), authority (confident expertise reads as AI - admit uncertainty), parallel headers ("What works: A", "What works: B" repeating is an instant flag).
Topic-based detection bias
Some topics are so heavily represented in detector training data that they flag on subject matter rather than style: AI/ML, SEO and digital marketing, SaaS growth, productivity optimization, crypto, "future of X" analysis.
Decide early whether such content needs to pass detection at all. If it does, the only remaining lever is full restructuring into personal narrative. Otherwise accept the score and publish - a useful piece that reads as human to human readers is fine when detection scores do not gate your distribution.
Target metrics
Narrative: below 40% is good, below 30% excellent. Structured: 50-70% overall is expected, so measure by segment - get 2-3 segments below 60%. If three passes cannot get below 60%, stop humanizing and restructure.
Publishing workflow
Publish gate: never publish - to a CMS, repo, MCP endpoint, file or anywhere else - until both loops below have run and the final score is acceptable. Every article, single or batched, no exceptions for momentum or deadlines or "I'll humanize them after"; drafting and shipping in one pass produces detectable AI prose every time. About to call a publish, create-post or commit tool with text that hasn't been through both loops? Stop and run them first.
Loop 1 - humanize, then detect. Apply this skill to the full draft, then run
the ai-writing-detector skill's detector:
./scripts/detect detect <file> --input-format markdown --output json. Capture
fraction_ai and fraction_ai_assisted. If fraction_ai is below 25% and
fraction_ai_assisted below 40%, skip Loop 2.
Loop 2 - re-humanize the flagged segments, then detect again. Use the segment-level output to find the highest-scoring passages and rewrite only those: break parallel and symmetrical structure, replace listicle scaffolding with narrative, add a specific anecdote, named product, concrete number or first-person aside every ~300 words, cut closing-paragraph macro framing.
Final fraction_ai | Action |
| Below 25% | Publish. |
| 25-50% | Acceptable if the voice is genuinely distinct and the format is structurally constrained (listicle, monthly guide, medical, finance - known topic and format bias). Note the score in the report. |
| Above 50% | Do not publish. Restructure the piece (listicle to narrative, survey to Q&A) and rerun the loops, or escalate to the user with the segment scores and ask whether to publish anyway. |
Why this order, and only two loops: humanize first so the detector reports the remaining scaffolding instead of the obvious tells you were always going to fix - detecting raw output wastes a cycle and biases the rewrite toward whatever that first run flagged, missing structural tells. Two loops, not three or more: if the score is still high after two, the piece needs structural redesign, not more humanization passes.
Pattern index
All 65 patterns, one line each. (+) marks patterns that are things to add,
not tells to remove. Full before/after treatment lives in the reference files.
Content (1-6) - references/patterns.md
- Inflated significance - "stands as a testament", "pivotal moment", "evolving landscape", "reflects broader".
- Notability padding - lists of media coverage, "active social media presence".
- Superficial -ing tails - "highlighting...", "ensuring...", "reflecting..." bolted onto sentences.
- Promotional language - "nestled", "vibrant", "breathtaking", "rich cultural heritage", "boasts a".
- Vague attribution - "Experts argue", "Industry reports", "Observers have cited".
- "Challenges and future prospects" sections - "Despite these challenges, ... continues to thrive".
Language and grammar (7-12) - references/patterns.md
- AI vocabulary - delve, crucial, intricate, tapestry, underscore, landscape, showcase; magic adverbs (quietly, deeply, fundamentally).
- Copula avoidance - "serves as", "boasts", "features" where "is"/"has" belongs.
- Negative parallelism - "It's not just X, it's Y", "Not only... but...".
- Rule of three - forced triplets to sound comprehensive.
- Elegant variation - synonym cycling for one referent (protagonist/main character/central figure/hero).
- False ranges - "from X to Y" where X and Y aren't on a scale.
Style (13-18) - references/patterns.md
- Em dash overuse.
- Boldface overuse - mechanical emphasis on phrases.
- Inline-header vertical lists - "- User Experience: The user experience...".
- Title Case headings.
- Emojis decorating headings or bullets.
- Curly quotes and Unicode decoration - smart quotes, arrows in running prose.
Communication (19-21) - references/patterns.md
- Chatbot artifacts - "I hope this helps", "Certainly!", "let me know".
- Knowledge-cutoff disclaimers - "as of my last update", "while specific details are limited".
- Sycophantic tone - "Great question!", "You're absolutely right".
Filler and hedging (22-24) - references/patterns.md
- Filler phrases - "in order to", "due to the fact that", "it is important to note".
- Excessive hedging - "could potentially possibly be argued".
- Generic positive conclusions - "exciting times lie ahead", "a step in the right direction".
Blog posts (25-32) - references/blog-patterns.md
- "You did X" openings - three short beats ending in "You're proud."
- "The dirty secret" / "nobody talks about" trope.
- Marketing jargon - "top-of-funnel", "low-friction", "community engagement".
- Formulaic advice lists - valid points forced into parallel bullets.
- Generic section headers - descriptive and Wikipedia-flavoured instead of opinionated.
- Missing vulnerability - advice delivered from detached authority.
- Cliché transitions - "move the needle", "here's the kicker", "let that sink in".
- (+) "Welcome to the club" - naming a shared frustration to build solidarity.
Detector-driven (33-46) - references/detector-testing.md
- The polished-rewrite trap - clean edits score higher than rough ones.
- (+) Personal anecdotes with specific numbers - "200+ points once", "maybe 30 launches".
- (+) Self-deprecating parenthetical asides - "(yes I'm that person)".
- (+) Admitted confusion - "I don't fully understand it but it works".
- (+) Sentence fragments - "Wild." "Works though." "Yeah yeah,".
- (+) Casual quantifiers - "like 40-60 words max", "roughly 28%".
- (+) Specific sequences of events - narrate the steps instead of summarizing them.
- Detector-flagging structures - numbered steps, parallel bullets, FAQ format, uniform header+paragraph rhythm.
- Content-type difficulty - narrative easy, how-to hard, AI/SEO near-impossible (table above).
- (+) Converting lists to narrative - same information as flowing prose with asides.
- Repeated header pattern - "What works: A", "What works: B", "What works: C".
- (+) Conversational transitions - "So", "Look,", "Here's the thing:" instead of "Moreover".
- (+) Named emotions about specific things - "that one stung", not "the results were disappointing".
- Topic-based detection bias - AI/SEO/marketing topics flag on subject matter.
Sentence and paragraph structure (47-52) - references/patterns.md
- Dramatic countdown - "Not a framework. Not a library. Something far more fundamental."
- Self-posed rhetorical questions - "The result? A mass exodus."
- Anaphora abuse - consecutive sentences opening on the same word.
- Gerund fragment litany - "Building trust. Breaking barriers. Creating opportunity."
- Short punchy fragment overuse - one-sentence paragraphs manufacturing drama.
- Listicle in a trench coat - "The first... The second... The third...".
Tone and voice (53-58) - references/patterns.md
- Patronizing analogies - "Think of a database index as a book's table of contents".
- Futurism invitation - "Imagine a world where...".
- False vulnerability - "I'll be honest:" that resolves straight back into confidence.
- Asserting obviousness - "The truth is simple", "it all comes down to one thing".
- Pedagogical voice - "Let's break this down", "let's unpack this".
- Invented concept labels - "the visibility paradox", pseudo-academic coinages.
Composition (59-65) - references/patterns.md
- Fractal summaries - the same point in the intro, the section, and the conclusion.
- Dead metaphor - one metaphor's vocabulary appearing 4+ times.
- Historical analogy stacking - "Just as the printing press...", "Like the Industrial Revolution...".
- One-point dilution - a single argument restated ten ways to fill space.
- Content duplication - near-verbatim repeats between intro, body and conclusion.
- Signposted conclusion - "In conclusion", "At the end of the day".
- Formulaic introduction - "In today's rapidly evolving digital landscape".
When to read the references
references/patterns.md- before/after examples for 1-24 and 47-65, the personality-and-soul guidance, two worked full-document rewrites. Read when you need a specific pattern's fix worked through, or when a rewrite comes back technically clean but voiceless.references/blog-patterns.md- patterns 25-32. Read when the text is a blog post, marketing page, or startup/SaaS content.references/detector-testing.md- patterns 33-46, the iterative test loop and restructuring criteria. Read when the text will be scored by a detector, when a score stops moving between passes, or before deciding a piece needs structural redesign.
Attribution
Patterns 1-24: Wikipedia:Signs of AI writing (WikiProject AI Cleanup), drawn from thousands of observed instances on Wikipedia. Patterns 25-32: detector testing on marketing content, January 2026. Patterns 33-45 and the iterative process: hands-on Pangram API testing, January 2026, which took a narrative blog post from 51% to 35% across five iterations. Pattern 41 (content-type difficulty) came from how-to and listicle testing where aggressive humanization only moved segments from 91-100% to 53-90% while the overall label stayed "AI" - the finding that established structure matters as much as voice. Pattern 46 (topic bias) came from an AI/SEO post that stayed at 100% through every available technique. Patterns 47-65: adapted from tropes.fyi (March 2026), ~30 recurring rhetorical moves in LLM output.
From Wikipedia: "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."
From detector testing: detectors look for the absence of human patterns as much as the presence of AI ones. Removing tells is half the job. And for some formats the structure itself is the signal, so no amount of voice work moves the label.
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.

