workbuddy_skills/humanizer/README.md

Humanizer

A standalone Claude Code skill that transforms AI-generated text into natural human writing. Drop it into any plugin. No dependencies, no MCP server, no configuration.

What it does

• Detects 55 AI writing patterns (P1-P55, based on Wikipedia's "Signs of AI Writing" + 2025-2026 community research + the wider humanizer ecosystem)
• Rewrites text to sound like a specific human wrote it
• Injects authentic voice using burstiness and perplexity principles
• Three modes: scan-only, full rewrite, in-place file editing
• 5 voice profiles: casual, professional, technical, warm, blunt
• Zero dependencies. Pure Markdown. Works in every editor that reads skill files.

Installation

As a standalone skill

mkdir -p ~/.claude/skills/humanizer
cp SKILL.md ~/.claude/skills/humanizer/

Inside a plugin

Copy SKILL.md into your plugin's skills/humanizer/ directory. Add to your plugin's skill registry if applicable.

Usage

# Full rewrite (default)
/humanizer "Your AI-sounding text goes here"

# Scan only: report patterns without changing text
/humanizer "text" --mode detect

# Score the AI-tell density (0-100, lower is more human)
/humanizer "text" --mode detect --score

# Edit a file in place
/humanizer --mode edit --file src/docs/README.md

# Specify voice
/humanizer "text" --voice casual

# Aggressive mode + iterate to convergence (max 3 passes)
/humanizer "text" --aggressive --iterate 3

# Layer purpose-specific rules on top of voice
/humanizer "text" --voice warm --purpose marketing

Voice options

Voice	Best for
casual	Blog posts, social media, informal docs
professional	Business communication, formal docs
technical	API docs, READMEs, code comments
warm	Tutorials, onboarding, support content
blunt	Internal comms, reviews, direct feedback

Purpose presets (--purpose)

Layered on top of voice. Add content-type rules without losing voice flavor.

Purpose	Effect
essay	No contractions, formal headings, structured arguments
email	Greetings allowed, signoff allowed, no markdown
marketing	Short paragraphs, concrete benefits, one CTA at end
technical	Code blocks preserved, precise jargon retained
general	No purpose-specific overrides (default)

Brand voice file

Drop a humanizer-context.md at the project root with your samples and banned phrases. Auto-loaded if present.

How it works

1. Parse: Extracts text and flags from arguments
2. Detect: Scans for 55 AI patterns across 6 categories (content, language, style, communication, filler, craft/forensic) + emerging 2026 patterns
3. Inject: Applies voice profile, varies sentence length (burstiness), increases word unpredictability (perplexity)
4. Verify: Checks output against detection patterns, sentence variance, and the "who wrote this?" test
5. Output: Clean text with change summary

Pattern categories

Category	Patterns	Examples
Content	P1-P8	Significance inflation, notability name-dropping, -ing phrases, copula avoidance
Language & Style	P9-P18	Negative parallelisms, em dash overuse, bold abuse, list syndrome
Communication	P19-P21	Chatbot artifacts, disclaimers, sycophancy
Filler & Hedging	P22-P30	Filler phrases, hedging, generic conclusions, uniform sentence length
Emerging (2026)	P31-P43	Elegant variation, citeturn markup leaks, utm_source=chatgpt URLs, treadmill effect
Craft & Forensic	P44-P55	False agency, diff-anchored writing, reasoning-chain artifacts, unicode obfuscation, argument residue

Deep dives and provenance live in references/patterns.md; the core SKILL.md is standalone and does not require it.

Credits

Built from research across:

• Wikipedia: Signs of AI writing
• William Strunk Jr., The Elements of Style (1918)
• Community research from Reddit, HackerNews, and writing communities

License

MIT