Claude Code plugin that strips machine-generated writing patterns from your documentation.
LLM-generated text has tells: em-dashes for dramatic effect, corporate jargon clusters ("leverage a robust ecosystem"), passive voice, hedge phrases, and stiff constructions like "It is important to note that." This plugin detects 15 categories of these patterns and fixes them.
/install actually-useful-ai/humanize
/humanize # scan README.md, CHANGELOG.md, docs/*.md in cwd
/humanize src/docs/ # scan a specific directory
/humanize README.md # scan a specific file
/humanize --dry-run # report without making changes
/humanize --strict # also auto-fix medium-confidence patterns
| Pattern | Confidence | Example |
|---|---|---|
| Em-dashes | 0.95 | "provides--and this is critical--updates" |
| Corporate jargon | 0.90 | "leverage", "synergy", "ecosystem" |
| Buzzword clusters | 0.90 | "optimized, scalable, future-proof" |
| Stiff construction | 0.90 | "It is important to note that..." |
| Redundancy | 0.95 | "advance planning", "past history" |
| LLM attribution | 1.0 | "Claude generated this", "the assistant" |
| Solo "we" to "I" | 0.90 | "We implemented" in solo context |
| Passive voice | 0.85 | "The data is processed by the system" |
| Hedge phrases | 0.80 | "might potentially", "could perhaps" |
| Formal metadata | 0.85 | "This document provides an overview" |
| Success metrics | 0.85 | "improves performance by up to 80%" |
| Acronyms | 0.80 | Unexpanded on first use |
| Transition phrases | 0.75 | "Furthermore", "Moreover" |
| Excessive dates | 0.75 | Timestamps in narrative prose |
| Over-structuring | 0.70 | Numbered lists for 2-3 items |
- Checkpoint -- commits any uncommitted changes before touching files
- Scan -- applies all 15 detection patterns with confidence scores
- Transform -- auto-fixes high-confidence (>0.9), suggests medium (0.7-0.9), flags low (<0.7)
- Report -- shows a summary with before/after diffs
- Never modifies code blocks, URLs, or citations
- Never changes meaning or removes attribution to real people
- Skips CLAUDE.md files (system instructions, not prose)
- Always creates a git checkpoint before making changes
- Shows diff previews for all changes
The plugin also enforces a terminology ban: no "AI-powered", "AI-enhanced", "AI-driven", or "AI" used as a standalone noun. Use "LLM", "language model", or name the specific model instead.
MIT