Skip to main content
skill CX Codex

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

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add oakoss/agent-skills --skill content-humanizer -a claude-code
Open on GitHub

What 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-code

2Manually: put the files in place

~/.claude/skills/content-humanizer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/content-humanizer/

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.

From the same set106

The whole set →
drizzle-orm Equips coding agents with schema conventions, query patterns, and migration workflows for Drizzle ORM across PostgreSQL, MySQL, and SQLite. CX Codex +1 263installs brand-designer brand-designer is a Claude Code skill for building visual brand identities, from logos to brand guidelines. It responds to requests for palettes, typography systems, and social media templates. CX Codex +1 242installs tailwind A Tailwind CSS v4 skill for themes, components, dark mode, container queries, v3 migrations, shadcn/ui, and build troubleshooting. CX Codex +1 233installs vitest-testing vitest-testing adds Vitest patterns and best practices to Claude Code. Helps write reliable unit, component, and hook tests without typical async mistakes. CX Codex +1 226installs zod-validation zod-validation guides AI coding agents through Zod v4 schema validation in TypeScript. Helps write schemas, parse incoming payloads, and generate JSON Schema definitions. CX Codex +1 222installs tanstack-form This skill guides TanStack Form v1 usage in React, covering state, validation, and submission. Use it for complex forms and changing field lists. CX Codex +1 222installs knowledge-graph-builder The knowledge-graph-builder skill guides knowledge-graph design, graph database choice, and graph-plus-vector retrieval. Use it for Graph RAG, entity resolution, and fact checks. CX Codex +1 222installs pino-logging Set up structured Pino logging in Node.js, including request context, sensitive-field redaction, transports, and framework integrations. CX Codex +1 217installs

Project sponsors

Companies that keep this analytics open