README.md

AI text scores ~0.00 burstiness. Humans score ~+0.70.
Humanizer rewrites the gap. 43 patterns, 5 voices, one Markdown file, zero API calls.

Try it in your browser →  ·  Install in 5 seconds  ·  Read the source

_{The chart is the whole pitch. AI writes in monotone. Humans don't. Detectors notice. So do readers.}

_{Real terminal capture: detect, rewrite, re-detect, converge. No marketing tricks, just the score before and after.}

Get started

Install (one command)

Project-scoped (travels with your repo):

mkdir -p .claude/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .claude/skills/humanizer/SKILL.md

Global (available in every project):

mkdir -p ~/.claude/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o ~/.claude/skills/humanizer/SKILL.md

That's it. No config. No dependencies. Claude Code picks it up automatically.

Use from your AI editor

Humanizer is a pure Markdown skill file. Add it to your editor's skill directory, then use the /humanizer command.

/humanizer "Your AI-generated text here"

mkdir -p .cursor/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .cursor/skills/humanizer/SKILL.md

mkdir -p .github/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .github/skills/humanizer/SKILL.md

mkdir -p .codex/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .codex/skills/humanizer/SKILL.md

mkdir -p .gemini/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .gemini/skills/humanizer/SKILL.md

mkdir -p .windsurf/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .windsurf/skills/humanizer/SKILL.md

mkdir -p .continue/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o .continue/skills/humanizer/SKILL.md

clawhub install humanizer-skill

mkdir -p ~/.openclaw/skills/humanizer && curl -sL \
  https://raw.githubusercontent.com/Aboudjem/humanizer-skill/main/skills/humanizer/SKILL.md \
  -o ~/.openclaw/skills/humanizer/SKILL.md

Note: Claude Code detects skills in .claude/skills/, ~/.claude/skills/, or any plugin's skills/ directory. No restart needed. Other editors may require referencing the file in their system prompt or configuration.

Usage

/humanizer "Your AI-generated text here"              # rewrite with default voice
/humanizer "text" --voice casual                      # pick a voice profile
/humanizer "text" --mode detect                       # scan only, no rewrite
/humanizer "text" --score                             # add 0-100 AI-tell score header
/humanizer --file docs/README.md --voice technical    # edit a file in place
/humanizer "text" --aggressive --iterate 3            # heavy rewrite, converge to zero patterns
/humanizer "text" --purpose marketing --voice warm    # purpose-specific rules + voice

Three modes, each for a different job:

rewrite is the default. You don't need to specify it.

Score yourself in 5 seconds

Run detect with --score on any text and you get a number you can quote:

$ /humanizer "In today's rapidly evolving landscape, AI is reshaping how we think about creativity..." --mode detect --score

[Score: 87/100, Pure AI smell]

Patterns found: 9
| #   | Pattern              | Text                              |
| P4  | Promotional          | "rapidly evolving landscape"      |
| P7  | AI Vocabulary        | "reshaping"                       |
| P22 | Filler               | "In today's"                      |
| P29 | Comprehensive Opening| meta-commentary about the article |
| P30 | Uniform Length       | sentences avg 19 words            |
| ...

After rewriting with /humanizer "..." --voice casual, the same text scores around 12/100. That delta is the entire point.

Bring your own brand voice

Drop a humanizer-context.md file at your project root with your brand samples and banned phrases. The skill auto-loads it as a personal extension of the --voice profile, so the rewrite sounds like you, not a preset.

What it does

You write with AI. The output sounds like a chatbot. Every sentence is the same length, the vocabulary is predictable, and phrases like "delve into" and "it's important to note" show up everywhere.

Humanizer detects 43 specific AI writing patterns and rewrites your text with real human rhythm, vocabulary, and voice. It doesn't swap synonyms. It rebuilds sentence structure, injecting the burstiness and unpredictability that make writing sound like a person wrote it.

Tip: This is about writing quality, not detection evasion. Good writing doesn't trigger AI detectors because it doesn't have the lazy patterns that detectors look for. Fix the writing, and the detection problem solves itself.

Before and after

_{Three real AI tells flagged, struck, replaced. The skill does this on text you paste.}

Technical documentation

Before: This comprehensive guide delves into the intricacies of our authentication system. The platform leverages cutting-edge JWT technology to provide a seamless, secure, and robust authentication experience. Additionally, it features a pivotal role-based access control system that serves as a testament to our commitment to security.

After (--voice technical): The auth system uses JWTs. Tokens expire after 15 minutes; refresh tokens last 7 days. Role-based access control restricts API endpoints by user role: admin, editor, and viewer each see different data. The token rotation logic is in src/auth/refresh.ts if you need to change the expiry windows.

Killed 9 AI patterns. Added real details. Cut word count by 40%.

Blog post

Before: In today's rapidly evolving technological landscape, artificial intelligence is reshaping how we think about creativity. This groundbreaking shift represents a pivotal moment in human history, one that underscores the intricate interplay between innovation and artistic expression.

After (--voice casual): I've been messing around with AI image generators for about six months now, and I still can't decide if I love them or if they make me uneasy. The outputs are technically impressive. I got a portrait last week that looked better than anything I could paint in a year. But there's something missing. It's like eating a perfect-looking meal that has no flavor.

Replaced abstract commentary with personal experience. Sentence lengths: 8, 31, 22, 4, 13 words. That's burstiness.

LinkedIn post

Before: Excited to announce that I've taken on a pivotal new role at TechCorp! This incredible opportunity represents a significant milestone in my professional journey. I'm deeply grateful to my amazing network for their unwavering support. #NewBeginnings #Innovation #Leadership #Grateful

After (--voice professional): Started a new job at TechCorp this week. I'm leading their developer tools team, 12 engineers building internal tooling that currently serves about 400 developers. First week has been drinking from the firehose: new codebase, new faces, new coffee machine I can't figure out. Nervous and excited in roughly equal measure.

No emojis. No hashtags. Real details instead of "pivotal milestone." The coffee machine line is more human than any amount of gratitude signaling.

Voice profiles

Every voice changes how the skill rewrites. Not just what words it picks, but the sentence structure, rhythm, and personality it injects.

How it works

A 4-pass editing system. Each pass has one job and never does the others.

graph LR
    A["Pass 1: Detect<br/><sub>Scan for 43 AI patterns<br/>across 5 categories</sub>"] --> B["Pass 2: Strip<br/><sub>Remove significance inflation,<br/>AI vocabulary, filler</sub>"]
    B --> C["Pass 3: Inject<br/><sub>Apply voice profile,<br/>burstiness, perplexity</sub>"]
    C --> D["Pass 4: Verify<br/><sub>Sentence variance check,<br/>blacklist scan, final test</sub>"]

    style A fill:#f5f3ff,stroke:#8b5cf6,color:#1e1b4b
    style B fill:#ede9fe,stroke:#8b5cf6,color:#1e1b4b
    style C fill:#ddd6fe,stroke:#8b5cf6,color:#1e1b4b
    style D fill:#8b5cf6,stroke:#7c3aed,color:#ffffff

Your text goes in. Clean, human-sounding writing comes out. The skill auto-detects which patterns are present and applies the minimum transformation needed. Pass 1 is non-destructive: you can run --mode detect to get the report without rewriting anything.

The science

AI detectors don't use magic. They measure two things, and both are well-documented in published research.

Burstiness is sentence length variation. Humans write a 3-word sentence, then a 40-word one, then a 12-word one. AI writes every sentence at roughly 18 words. Detectors measure this variance. Low variance = probably AI.

Perplexity is word predictability. AI picks the most statistically likely next word every time. Humans don't. We use surprising words, odd phrasing, personal references. High perplexity = probably human.

Word-swapping tools like QuillBot change individual words but leave the rhythm and predictability untouched. That's why they fail. You need structural transformation, not synonym replacement.

vs. alternatives

All 43 patterns

All P38-P43 are 2026 community discoveries sourced from HackerNews threads, Wikipedia's evolving editorial guideline, and writing practitioner blogs. Sources cited inline in SKILL.md.

Why not just...

"...use a better prompt?" Prompts help, but they can't enforce 43 specific pattern rules consistently. The skill has a checklist. It catches things you'd miss on your 50th revision.

"...use QuillBot or Undetectable.ai?" They swap words. The rhythm stays robotic, the sentence lengths stay uniform, the structure stays predictable. Detectors don't care about individual words. They care about patterns.

"...just edit it myself?" You absolutely can. But do you know all 43 patterns? Can you spot "copula avoidance" or "significance inflation" on sight? This skill is a ruthless editor that never gets tired and never misses a pattern.

Model compatibility

The skill is a Markdown prompt, so it runs on whichever model your editor wires up. Tested working on:

The patterns are model-agnostic. The voice profiles are model-agnostic. The only thing that varies is how creatively each model handles the "soul injection" step.

Trust

No telemetry. No data collection. No API calls. No cloud anything.

The entire skill is a single Markdown file (SKILL.md) that Claude Code reads locally. Your text never leaves your machine. There's nothing to audit because there's nothing running.

Note: Pure markdown skill. No JavaScript, no binaries, no network requests. Read the source yourself: it's one file.

File structure

your-project/
  .claude/
    skills/
      humanizer/
        SKILL.md    # the entire skill, one file

Contributing

Found a new AI pattern? Have a better fix? PRs welcome.

1. Fork the repo
2. Add your pattern to SKILL.md (follow the P1-P43 format)
3. Include a before/after example
4. Open a PR

See CONTRIBUTING.md for details, including the three-file lockstep update (badge count, CI threshold, CHANGELOG).

Lineage and credit

This skill is part of a wider family of humanizer tools. Direct lineage:

• @blader/humanizer, the original Claude skill that named this category. Different patterns, no voice profiles, no edit mode, but it lit the path.
• @softaworks/agent-toolkit, the humanizer plugin that proved Markdown skill files were the right distribution format.
• Wikipedia: Signs of AI writing, the public, open, citation-backed reference list that ~70% of P1-P30 are derived from.

What this fork adds: 43 numbered patterns (largest open catalog), 5 named voice profiles, three operating modes (detect/rewrite/edit), 8-editor install matrix, CI that enforces its own rules (no em dashes in the skill that bans em dashes), and a research-first README that cites primary sources for every claim.

If you used the older humanizers, this one will feel familiar but tighter. If you're new to the category, @blader's repo is also worth a read.

If this skill saved your writing from sounding like a chatbot, consider giving it a star.
It helps others find it.

_{Built by Adam Boudjemaa · MIT License · No telemetry · No data collection}