content-humanizer · oakoss — Claude Code skill: what it does, how to install
content-humanizer rewrites model-written drafts so they read like a person wrote them: sentence rhythm, tone, and the hedging that gives AI text away.
MIT 225 installs ★ 29 updated 2026-08-17
npx skills add oakoss/agent-skills --skill content-humanizer -a claude-codeWhat content-humanizer does
The skill takes a finished draft and reworks it in stages: structure first, voice next, polish last. A quick-reference table names the usual machine habits: flat rhythm, passive constructions, vague claims like “significant improvement”, hedging, filler, mechanical bullet lists. Each row comes with a fix, down to alternating short and long sentences.
A second table covers mistakes made while editing: reaching for a thesaurus, tearing out structure to sound casual, chopping every sentence short. Four reference files ship alongside it in references/ — writing patterns, tone and voice, AI pattern removal, and advanced patterns such as E-E-A-T signals and burstiness.
Point it away from code and technical specs, where precision matters more than voice; for code comments and READMEs the skill defers to de-slopify. Install runs through the skills CLI with npx.
What it helps with
- strip hedging and filler from a model-written draft
- match a blog post to a brand voice
- break up paragraphs that all run the same length
- turn a bullet list into readable prose
- find the lines that make a draft sound machine-written
Example prompts for the agent
- Rewrite this draft so it reads like a person wrote it: cut the hedging and vary the rhythm.
- Set the voice for our landing page first, then edit the copy to match it.
- Which paragraphs here still sound like AI? Show the fix for each one.
How to install content-humanizer
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill content-humanizer -a claude-code2Manually: put the files in place
~/.claude/skills/content-humanizer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/content-humanizer/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill content-humanizer -a codex2Manually: put the files in place
.agents/skills/content-humanizer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill content-humanizer -a cursor2Manually: put the files in place
.cursor/skills/content-humanizer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install oakoss/agent-skills skills/content-humanizer2Manually: put the files in place
.github/skills/content-humanizer/SKILL.md1Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill content-humanizer -a gemini-cli2Platform CLI
gemini skills install https://github.com/oakoss/agent-skills --path skills/content-humanizerManually: put the files in place
.devin/skills/content-humanizer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add oakoss/agent-skills --skill content-humanizer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about content-humanizer
How to install content-humanizer in Claude Code?
Run npx skills add oakoss/agent-skills --skill content-humanizer -a claude-code. The skill file lands at ~/.claude/skills/content-humanizer/SKILL.md.
What does content-humanizer do?
It rewrites AI-generated prose so it reads as human-written: sentence rhythm, tone matched to the audience, and fewer hedges or filler phrases.
Does it work for code comments and READMEs?
No. On code and technical specs precision beats voice, and the skill points to de-slopify for comment and README cleanup instead.
Source text
SKILL.md · MIT
--- name: content-humanizer description: > Makes AI-generated prose sound natural and human-written. Covers tone analysis, sentence variation, voice consistency, readability improvement, and AI-typical pattern removal including hedging, filler words, and over-qualification. Use when improving blog posts, marketing copy, or narrative documentation. Use for tone consistency, readability, sentence rhythm, and removing AI-typical writing patterns. license: MIT metadata: author: oakoss version: '1.1' --- # Content Humanizer ## Overview Content humanizer transforms AI-generated prose into writing that reads as natural and intentional. It covers sentence rhythm, tone calibration, audience adaptation, and systematic removal of patterns that signal machine authorship. Applies to blog posts, marketing copy, email campaigns, narrative documentation, and any long-form prose. **When to use:** Polishing AI-drafted blog posts, adapting marketing copy for a specific brand voice, improving readability of narrative documentation, rewriting content that feels robotic or formulaic. **When NOT to use:** On code or technical specifications where precision matters more than voice. On content that was already human-written and reads naturally. For removing AI artifacts from code comments or READMEs (use the `de-slopify` skill instead). ## Quick Reference | Pattern | Technique | Key Points | | ------------------- | --------------------- | ----------------------------------------------------------------- | | Flat rhythm | Sentence variation | Mix short (5-word) and long (20+ word) sentences | | Passive voice | Active rewriting | Subject performs the action; aim for 80-90% active | | Abstract claims | Concrete language | Replace "significant improvement" with specific numbers | | Hedging phrases | Direct assertion | Delete "it's worth noting" and state the fact | | Filler vocabulary | Plain language | "utilize" becomes "use", "leverage" becomes "use" | | Over-qualification | Confident tone | Remove unnecessary caveats and balanced-to-a-fault phrasing | | List addiction | Prose conversion | Convert mechanical bullet lists into flowing paragraphs | | Generic transitions | Contextual connectors | Replace "furthermore" and "moreover" with idea-specific links | | Uniform paragraphs | Varied structure | Break predictable paragraph lengths and opening patterns | | Missing voice | Brand calibration | Define audience, formality level, and personality before editing | | No E-E-A-T signals | Experience injection | Add first-person anecdotes, specific data, authoritative sources | | Low burstiness | Length variation | Alternate 3-word and 25-word sentences to break uniformity | | Low perplexity | Word unpredictability | Replace formulaic phrases with domain-specific, concrete language | ## Common Mistakes | Mistake | Correct Pattern | | -------------------------------------------- | ------------------------------------------------------------------- | | Replacing AI words with a thesaurus | Rewrite the sentence; synonym swaps create awkward phrasing | | Removing all structure to sound casual | Keep headings and organization; rewrite prose within the structure | | Over-correcting into choppy fragments | Read aloud after editing; recombine sentences that lost flow | | Editing without defining target voice | Set persona, audience, and formality level before starting | | Treating humanization as a single pass | Use multiple passes: structure, then voice, then polish | | Making every sentence short and punchy | Vary length deliberately; monotone short sentences feel robotic too | | Adding personality through exclamation marks | Voice comes from word choice and rhythm, not punctuation | | Ignoring paragraph-level patterns | AI writes uniform paragraphs; vary length and opening structure | ## Delegation - **Scan a repository for prose files that need humanization**: Use `Explore` agent - **Rewrite an entire blog or documentation site**: Use `Task` agent - **Define a brand voice guide and editorial standards**: Use `Plan` agent > If the `de-slopify` skill is available, delegate code comment cleanup and technical writing artifact removal to it. > Otherwise, recommend: `npx skills add oakoss/agent-skills --skill de-slopify` ## References - [Writing patterns: sentence variation, active voice, concrete language, and rhythm](references/writing-patterns.md) - [Tone and voice: brand consistency, audience adaptation, and formality levels](references/tone-and-voice.md) - [AI pattern removal: detecting and rewriting common AI tells](references/ai-pattern-removal.md) - [Advanced patterns: E-E-A-T signals, burstiness, perplexity variation, and structural rhythm](references/advanced-patterns.md)
© oakoss · MIT · oakoss/agent-skills
Similar skills
All skills for Writing and docs →content-humanizer by other authors comes first.