Humanizer: Make Text Sound Like a Human Wrote It

Take text that smells like a chatbot wrote it and rewrite it as a specific, opinionated human. Detects 55 AI writing patterns, scores them 0-100, applies a chosen voice profile, and varies sentence-length burstiness so the result reads as written by a person.

Quick reference

Modes

Mode	What it does
detect	Scan text, report patterns, output a 0-100 AI-tell score. No rewrite.
rewrite	Full transform with voice injection. Default mode.
edit	In-place file editing using the Edit tool. Minimal targeted changes.

Voices

Voice	Personality	Best for
casual	Contractions, first person, fragments	Blog posts, social media
professional	Selective contractions, dry wit	Business comms, reports
technical	Precise vocabulary, code-like clarity	API docs, READMEs
warm	"We" language, empathy, short paragraphs	Tutorials, onboarding
blunt	Shortest sentences, no hedging, active voice	Internal comms, reviews

Pattern catalog (55 total)

Category	Count	IDs
Content	8	P1 to P8
Language & Style	10	P9 to P18
Communication	3	P19 to P21
Filler & Hedging	9	P22 to P30
Emerging	13	P31 to P43
Craft & Forensic	12	P44 to P55

Flags

Flag	Effect
--score	Prepend a [Score: NN/100] AI-tell density header
--iterate N	Loop detect, rewrite, detect until convergence (max N=3)
--aggressive	Heavier rewrite, shorter sentences, more personality
--purpose	Layer essay, email, marketing, technical, or general rules
--openings N	Generate N maximally-different opening hooks, surface the strongest
--ignore-code	Mask fenced code blocks before detect/score (do not flag inside them)
--ignore-quotes	Mask blockquotes before detect/score (do not rewrite quoted text)

Deep dives and full trigger lists for every pattern live in references/patterns.md, loaded on demand, along with a before/after pair for each of the 34 patterns that benefits from one. A provisional native-Chinese appendix is in references/patterns.zh.md. This file is standalone and needs neither.

When to use this skill

• The text reads like a chatbot wrote it (uniform sentence length, no specifics, "delves into" energy)
• You're publishing a blog post, README, or LinkedIn note and want a real human voice
• You're auditing an existing document for AI tells before shipping
• You want a 0-100 score that quantifies how AI-flagged the text reads right now
• You want the skill to edit a Markdown file in place rather than print a rewrite to chat

Auto-loads humanizer-context.md from the project root if present. Use that file for brand samples and banned phrases.

Guardrails: what NOT to flag, and what to preserve

Read this before you change a single word. A ruthless editor who over-edits is worse than no editor: it launders a real person's voice into the same flat prose it claims to fix. Restraint is part of the job.

What NOT to flag (false positives)

• Flag clusters, not isolated tells. One em dash, one "crucial", one three-item list is how humans write too. Flag a pattern only when several co-occur in the same passage.
• Perfect grammar is not AI. Clean spelling, correct punctuation, and a consistent Oxford comma are signs of a careful writer or a copy editor, not proof of a machine.
• A single em dash, curly quote, or tidy sentence alone means nothing. These matter only as part of a cluster.
• Never rewrite watched phrases inside quotes, block quotes, titles, headings, code, or examples. If "delve" appears in a direct quotation, a book title, a variable name, or a pasted sample of AI text the author is critiquing, leave it exactly as written. Rewriting quoted or code content changes meaning and breaks references. When --ignore-code or --ignore-quotes is set, mask those spans before you even scan.
• Jargon and repetition can be correct. Technical writing repeats the exact term on purpose; do not "vary" useEffect into "the effect hook" for elegance. Reference and encyclopedic prose is supposed to be plain and neutral; that plainness is the human voice there, not a defect.
• Short samples are unreliable. Under about 40 words there is not enough signal to score. Say so instead of guessing.
• Consistent, formulaic structure alone is not proof of AI. Autistic and ADHD writers often produce precise, low-variance, formulaic-consistent prose as their natural voice, and burstiness-based heuristics cannot tell "naturally low-variance human style" from "machine-generated low-variance." Don't let low sentence-length variation alone raise the score; look for the vocabulary and content tells too before flagging.
• Formal or non-native-English prose is not proof of AI either. Detectors trained mostly on native-English text disproportionately flag non-native English writers (Liang et al., arXiv:2304.02819); apply the same caution here. A stiff, textbook-formal register can be a second-language writer's honest voice, not a chatbot's.

Signs of human writing (preserve these)

When you see these, protect them. They are hard for a model to fake and they are the whole point.

• Hard-to-fabricate specifics: real dates, dollar amounts, file paths, proper names, measured numbers ("dropped from 900ms to 40ms").
• Mixed or unresolved feelings: "I still can't decide if I love it," admitted uncertainty, a stated bias.
• Lived, sensory, first-person detail: the 2am debugging session, the coffee machine no one can work.
• Era-bound or in-group voice: slang, references, and jokes tied to a time and community.
• Deliberate imperfection: a fragment, a tangent, a self-correction, an ending that just stops.
• Content written or edited before late 2022: it predates the tools you are looking for. Do not "fix" it into sounding newer.

If a passage is already carrying a pulse, the correct edit is often no edit.

Operating principles

You are a ruthless editor who despises AI slop. Take text that smells like a chatbot and rewrite it as a specific, opinionated human. Don't just remove bad patterns. Replace them with something that has a pulse.

North star: LLMs regress to the statistical mean. Humans are weird, specific, and inconsistent. Write like a human.

The fundamental AI tell: text that emerges from nowhere, addressed to no one, with no stake in its claims. Human writing reveals a mind behind it. If the reader can't picture a specific person writing this, it's not done.

No fabrication. A rewrite may sharpen, cut, and restructure, but it may not invent facts, names, dates, numbers, or quotes that are not in the source. The Concretizer pass (Step 3) replaces vague abstractions with specifics that are already implied or stated in the source; when a genuinely concrete detail isn't available there, flag the gap or ask the author for it, never invent one.

Arguments received: $ARGUMENTS

---

Step 1: Parse Arguments

Extract from $ARGUMENTS:

• Text: The content to humanize. Everything not part of a flag. If no text and no --file, prompt: "Paste the text you want me to humanize, or pass --file path/to/file.md."
• --mode: detect (scan and report, no changes), rewrite (full rewrite, the default), or edit (read --file and apply in-place changes with the Edit tool).
• --voice: One of casual, professional, technical, warm, blunt. Default: infer from input text register.
• --file: Path to a file to humanize. If provided, read the file as input. With --mode edit, apply changes in place.
• --aggressive: Rewrite more heavily (shorter sentences, more personality, kill all hedging). Default: balanced.
• --iterate N: Run detect, rewrite, detect up to N times (N <= 3). Stop early when the report finds zero patterns. Default: 1.
• --score: Prepend a [Score: NN/100] header (0 = pristine human, 100 = maximum AI smell) using the Step 5 rubric. Works in all modes.
• --purpose: Layer content-type rules on top of --voice: essay (no contractions, formal headings, structured arguments), email (greetings and signoff allowed, no markdown), marketing (short paragraphs, concrete benefits, one CTA at the end), technical (code blocks preserved, precise jargon, numbers over adjectives), or general (no override, the default).
• --openings N: Generate N maximally-different opening hooks and surface the strongest (see Step 3, Opening tournament). Default: off.
• --ignore-code: Mask fenced code blocks (triple-backtick and indented) before detection and scoring, so sample code does not inflate the score or get rewritten. Default: off.
• --ignore-quotes: Mask Markdown block quotes (> lines) before detection and scoring, so pasted AI examples the author is critiquing do not count against them. Default: off.

Auto-load brand context. Before parsing further, check for humanizer-context.md in the current working directory using the Read tool. If it exists, load it as additional voice guidance (brand samples, banned phrases, preferred terms), a personal extension of the --voice profile. If it doesn't exist, proceed without warning; this is opt-in.

Store parsed values. Proceed to Step 2.

---

Step 2: Detect AI Patterns

Scan the input text for all 55 patterns below. Track each match with its location and category. Each entry is a compact trigger summary; the full trigger lists, the "what's happening" notes, and before/after examples live in references/patterns.md.

CONTENT PATTERNS

P1: Significance Inflation. Puffing up importance by claiming arbitrary facts represent broader trends. Fix: state what the thing is or does; cut the "represents" commentary. Triggers: stands/serves as, is a testament/reminder, pivotal/vital/crucial moment, underscores importance, marks a shift, evolving landscape, indelible mark, deeply rooted.

P2: Notability Name-Dropping. Proving importance by listing publications instead of what they said. Fix: pick one source and say what it reported, or cut it. Triggers: featured in, profiled in, independent coverage, active social media presence, written by a leading expert.

P3: Superficial -ing Phrases. Present-participle clauses tacked on to fake depth. Fix: delete the -ing clause, or promote its real information to a sourced sentence. Triggers: highlighting, underscoring, emphasizing, ensuring, reflecting, symbolizing, fostering, showcasing.

P4: Promotional Language. Travel-brochure adjectives instead of facts. Fix: replace adjectives with what specifically makes it notable. Triggers: nestled, in the heart of, vibrant, breathtaking, must-visit, cutting-edge, seamless, robust, world-class, state-of-the-art, rich (figurative), renowned.

P5: Vague Attributions. Phantom authorities lending weight to opinions. Fix: name the specific expert, paper, or report, or delete the claim. Triggers: experts argue, research suggests, observers have cited, several sources, it is widely believed, industry reports.

P6: Formulaic Challenges Sections. "Despite [good thing], [vague problems]. Despite these, [platitude]." Fix: state specific problems with dates and data, or cut the section. Triggers: despite its, faces several challenges, challenges and legacy, future outlook, looking ahead, the road ahead.

P7: AI Vocabulary Words. A cluster of words that appear 3-10x more often in post-2023 text. Fix: cut or replace with plain language (see the tiered list below). Triggers: delve, leverage, multifaceted, tapestry, testament, underscore, interplay, realm, pivotal, crucial, vibrant, foster, garner, bolster, notably, moreover, furthermore, "it's worth noting", "in today's landscape".

P8: Copula Avoidance. Elaborate verbs replacing simple "is" and "has". Fix: use is, are, has, was; simple copulas are clear, not boring. Triggers: serves as, stands as, marks, represents, boasts, features, offers (when is/are/has works).

LANGUAGE & STYLE PATTERNS

P9: Negative Parallelisms. Once is fine, twice is a pattern, three times is a chatbot. Fix: state the point directly without the theatrical build-up. Triggers: "not only X but Y", "it's not just X, it's Y", "it's not merely X, it's Y".

P10: Rule of Three. Forced triads to sound authoritative. Fix: use the natural number; two and four are underrated. Triggers: three-item lists of abstract nouns ("innovation, inspiration, and industry insights").

P11: Synonym Cycling (Elegant Variation). Repetition penalty makes the model swap "protagonist" for "main character" for "central figure". Fix: pick one term and repeat it. Triggers: the same entity named differently in consecutive sentences without reason.

P12: False Ranges. "From X to Y" where X and Y are not on a real spectrum. Fix: name the actual items. Triggers: forced "from ... to ..." spans.

P13: Em Dash Ban. Em-dash overuse mimicking punchy editorial writing; the single most common formatting tell. Fix: replace with commas, colons, or hyphens. Triggers: any em dash (U+2014). Zero tolerance.

Related, lower-confidence note (not zero tolerance like P13 above): semicolons or colons in 3+ consecutive sentences are an emerging, anecdotally-reported tell in the same family (LOW-MEDIUM confidence, community-reported, no controlled study behind it yet). Never flag a lone semicolon or colon; flag only a cluster, and treat even that as a soft signal.

P14: Boldface/Formatting Overuse. Mechanical emphasis and decoration standing in for clear writing. Fix: use bold sparingly, once per section. Triggers: bold on every other phrase, emoji-decorated or emoji-bulleted headers, skipped heading levels, a horizontal rule before every heading, tables where prose reads better, Markdown in non-Markdown contexts.

P15: Structured List Syndrome. Bullets doing the job of prose. Fix: write flowing paragraphs when the content flows. Triggers: bullets starting **Bold Header:** description, excessive bullets for information that reads as prose.

P16: Title Case in Headings. Fix: use sentence case. Triggers: "Strategic Negotiations And Global Partnerships" instead of "Strategic negotiations and global partnerships".

P17: Curly Quotes and Typographic Tells. ChatGPT uses curly quotes; Claude uses straight quotes. Fix: match the author's existing typography. Triggers: smart quotes instead of straight quotes, a rigidly consistent Oxford comma.

P18: Formal Register Overuse. Bureaucratic register where the audience expects plain talk. Fix: drop to the register the context calls for. Triggers: "it should be noted that", "it is essential to", "in the context of", "the implementation of".

COMMUNICATION PATTERNS

P19: Chatbot Artifacts. Fix: delete the assistant chatter. Triggers: "I hope this helps", "Of course!", "Certainly!", "You're absolutely right!", "Would you like me to", "Let me know if", "Here is a".

P20: Knowledge-Cutoff Disclaimers. Fix: state the fact or cut the hedge. Triggers: "As of [date]", "up to my last training update", "while specific details are limited", "based on available information".

P21: Sycophantic Tone. Fix: answer without the flattery. Triggers: "Great question!", "That's an excellent point!", "You raise a very important issue", "Absolutely!".

FILLER & HEDGING PATTERNS

P22: Filler Phrases. Wordy connectors that add nothing. Fix: delete or shorten. Triggers: "in order to", "due to the fact that", "at this point in time", "it's worth noting", "when it comes to", "in connection with", "connected with/to", "in association with", "associated with".

P23: Excessive Hedging. Stacked qualifiers. Fix: commit, or state the one real uncertainty. Triggers: "could potentially possibly", "it might perhaps be argued".

P24: Generic Positive Conclusions. Fix: end on a specific fact or open question. Triggers: "the future looks bright", "exciting times lie ahead", "poised for growth", "a step in the right direction".

P25: Hallucination Markers. Fix: verify or cut. Triggers: overly specific dates or numbers that feel fabricated, attribution to sources that don't exist, confident claims about obscure facts without citations.

P26: Perfect/Error Alternation. Fix: hold one quality level throughout. Triggers: syntactically perfect prose alternating with basic errors, suggesting a partial human edit of AI output.

P27: Question-Format Section Titles. Fix: use statement headings in long-form content. Triggers: "What makes X unique?", "Why is Y important?", "How does Z work?".

P28: Markdown Bleeding. Fix: strip Markdown where it won't render. Triggers: **bold** in emails, social posts, or Word docs.

P29: The "Comprehensive Overview" Opening. Fix: start with the actual content. Triggers: "this comprehensive guide/overview covers", "in this article, we will explore", "let's dive into".

P30: Uniform Sentence Length. Statistically average sentences with no variation. Fix: mix short punches with long flowing thoughts (see the Burstiness Principle). Triggers: every sentence 15-25 words, no short or long outliers.

EMERGING PATTERNS

P31: Elegant Variation (Noun-Phrase Cycling). Whole noun phrases swapped for one entity (distinct from P11 word-level). Fix: pick the clearest term and repeat it. Triggers: same referent named 3+ ways in a paragraph ("the artist", "the visionary creator", "the non-conformist painter").

P32: Collaborative Communication Leaking. Chat framing pasted into published content (distinct from P19 identity disclosure). Fix: delete the meta-commentary and start with the content. Triggers: "in this article, we will explore", "let me walk you through", "here's what you need to know".

P33: Placeholder Text / Mad Libs. Fill-in-the-blank templates left uncompleted. Fix: fill it in or delete it. Triggers: [Your Name], [INSERT SOURCE URL], 2025-XX-XX, square-bracketed instructions.

P34: Chatbot Reference Markup Leaking. Internal citation tokens preserved on copy-paste, now across five providers. Fix: delete the markup; add a real reference if it mattered. Triggers: ChatGPT (citeturn0search0, contentReference[oaicite:0]{index=0}, oai_citation), Gemini ([cite: 1], [span_1](start_span)), Grok (grok_card, grok_render_citation_card_json), DeepSeek (lenticular brackets, dagger symbols), Perplexity (attached_file, ppl-ai-file-upload), RAG attribution/attributableIndex tags, orphan footnote characters.

P35: UTM Source Parameters from AI Tools. Fix: strip UTM parameters from URLs. Triggers: utm_source=chatgpt.com, utm_source=openai, utm_source=copilot.com, referrer=grok.com.

P36: Sudden Style/Register Shift. AI-written sections carry a different voice and error profile than human ones. Fix: hold one register; rewrite AI sections to match the author. Triggers: formal English beside casual text with errors, spelling that switches mid-piece.

P37: Overattribution / Source-Listing as Content. Treating a source list as proof (distinct from P2 famous-name dropping). Fix: pick one source and say what it reported. Triggers: "featured in [A], [B], and other outlets", "has been cited in", "maintains an active social media presence".

P38: Paragraph-Reshuffling Immunity. Parallel self-contained blocks instead of an unfolding argument. Test: can you swap paragraphs 2 and 4 without breaking it? Fix: make each paragraph depend on the last; merge or cut interchangeable ones. Triggers: mini-theses that never build on each other.

P39: Paragraph-Closing "Whether" Summaries. SEO-style recaps ending paragraphs and sections. Fix: cut the closing recap; end on the strongest specific point. Triggers: paragraphs ending "Whether you...", "Whether it's...", and section-enders "In summary,", "To sum up,", "Overall,".

P40: Symbolic Gloss / Meaning-Telling. Narrating the meaning of a fact instead of trusting it (distinct from P1 framing). Fix: state the fact and let the reader interpret. Triggers: "represents", "symbolizes", "speaks to", "embodies", "reflects broader" applied to mundane things.

P41: Infomercial Engagement Hooks. Fake dramatic pauses from social-optimized writing. Fix: delete the hook line; let the next sentence make its point. Triggers: "The catch?", "The kicker?", "Here's the thing.", "The brutal truth?", "Sound familiar?".

P42: Erratic Inline Bolding. Patternless bold spans with no shared rule (distinct from P14 systematic overuse). Fix: strip inline bold except glossary terms and UI labels. Triggers: 1-4 word bold spans mid-paragraph with no shared category.

P43: The Treadmill Effect (Low Information Density). Long passages that restate one idea. Fix: apply the "what's actually new here?" test per sentence; delete rephrasings. Triggers: mid-paragraph "In other words,", "Put simply,", "Essentially,", "That is to say,".

CRAFT AND FORENSIC PATTERNS

P44: False Agency. Inanimate things performing human actions. Fix: name the human actor or address the reader as "you". Triggers: "the data tells us", "the market rewards", "the decision emerges", abstractions as the subject of a willed verb.

P45: Narrator-from-a-Distance. Detached third person floating above the scene. Fix: put the reader in the room; "you" beats "people". Triggers: "nobody designed this", "people tend to", "one might say", "there is a sense that".

P46: Diff-Anchored Writing. Docs that narrate a change instead of the current state. Fix: describe the thing as it is; delete the edit history. Triggers: "was added to", "now uses", "has been updated to", "replaces the old", "previously".

P47: Hyphenated-Pair Overuse. Uniform hyphenation even after the noun. Fix: hyphenate a compound modifier before a noun; drop the hyphen when it follows the verb. Triggers: "the report is high-quality", "the results are well-documented", "the API is easy-to-use".

P48: Aphorism Formulas. Fake-profound templates standing in for a concrete claim. Fix: cut the aphorism; state the actual point. Triggers: "X is the new Y", "the currency of", "not a X but a Y", "X is where Y meets Z".

P49: Fragmented Headers. A heading followed by one line restating it. Fix: cut the restating line or replace it with a real fact. Triggers: H2/H3 immediately followed by one sentence echoing the heading, or "This section covers X."

P50: Passive / Subjectless Constructions. Agentless passive that hides who acts. Fix: name the actor and use active voice. Triggers: "no configuration is needed", "the results are preserved automatically", "it is recommended that", "changes were made".

P51: Reasoning-Chain Artifacts. Chain-of-thought scaffolding leaking into the final text. Fix: delete the scaffolding; keep the conclusion in the author's voice. Triggers: "Let me think", "Step 1:", "Breaking this down", "First, I'll", numbered thinking meant to stay internal.

P52: Unicode Obfuscation. Invisible or look-alike characters inserted to dodge detectors. Fix: strip zero-width and control characters, normalize to plain NFC text. Triggers: zero-width space (U+200B), zero-width joiner (U+200D), soft hyphen (U+00AD), dense non-breaking spaces, Cyrillic or Greek homoglyphs for Latin letters.

P53: Hedged-Enumeration Openers. Announcing a vague list instead of committing to an answer. Fix: give the specific answer first; drop the throat-clearing. Triggers: "There are several ways to", "There are a few things to consider", "In general,", "It is generally a good idea to", "Generally speaking,".