borghei/content-humanizer
> Transform AI-generated content into human-sounding writing via AI pattern detection, rhythm restoration, and authenticity scoring. Use when content sounds robotic, uses AI cliches, or the user wants to humanize or fix AI writing.
npx skills add https://github.com/borghei/Claude-Skills --skill content-humanizer
Transform machine-sounding content into writing that reads like it came from a real person with real opinions and real experience.
content humanizer, AI content, humanize writing, AI detection, natural writing, authentic content, AI cliches, robotic writing, brand voice, personality injection, writing rhythm, AI patterns, content authenticity, human voice, AI tells, content polishing, voice consistency, writing style, content quality
Before humanizing, confirm these inputs. If any is unknown or vague, ASK — do not assume:
Stop rule: ask only the 2-3 that most change the output. If the user says "just draft it," proceed and list your assumptions at the top of the artifact.
Scan content without editing. Produce an annotated report.
Step 1: Run Detection Scan
Flag every instance in these categories with severity ratings:
Step 2: Count and Score
| Metric | Threshold |
|--------|-----------|
| AI tells per 500 words | < 3 = minor edits needed, 3-7 = significant editing, 8+ = full rewrite |
| Unique paragraph structures | < 3 patterns in 1,000+ words = AI fingerprint |
| Vague claims without attribution | Any = flag each one |
| Sentences starting with "It is" | > 3 per 1,000 words = flag |
Step 3: Deliver Audit Report
## AI Pattern Audit
Content: [Title or description]
Word count: [X]
AI Tell Count: [X] (Critical: [X], Medium: [X], Minor: [X])
Recommendation: [Minor edits / Significant editing / Full rewrite]
### Critical Issues
[Each issue with line reference, pattern category, and specific fix]
### Medium Issues
[Same format]
### Minor Issues
[Same format]
Transform the content from AI-sounding to authentically human.
Step 1: Remove AI Filler Words
Never just delete — always replace with something better or restructure the sentence:
| AI Phrase | Replacement Options |
|-----------|-------------------|
| "delve into" | "look at," "dig into," "break down," or restructure without the phrase |
| "the [X] landscape" | "how [X] works today," "the current state of [X]" |
| "leverage" | "use," "apply," "put to work" |
| "crucial" / "vital" / "pivotal" | State the thing and let it be self-evidently important |
| "furthermore" / "moreover" | Start the next sentence directly, or use "and" or "also" |
| "robust" / "comprehensive" | Replace with specific description of what it actually covers |
| "facilitate" / "foster" | "help," "make easier," "allow," "create" |
| "navigate this challenge" | "handle this," "deal with this," "get through this" |
| "in order to" | "to" |
| "it is important to note that" | Delete the phrase; start with the actual note |
| "it goes without saying" | If it goes without saying, do not say it |
| "at the end of the day" | Delete entirely or replace with specific conclusion |
| "a wide range of" | Specify the range or say "many" |
Step 2: Fix Sentence Rhythm
AI produces uniform sentence length (18-22 words per sentence). The ear goes numb.
Deliberately vary:
Target rhythm patterns:
Step 3: Replace Generic with Specific
Every vague claim is an invitation to doubt:
Before: "Many companies have seen significant improvements by implementing this strategy."
After (if you have data): "HubSpot published their onboarding funnel data in 2023 — companies that hit first-value in 7 days showed 40% higher 90-day retention."
After (if you do not have data): "I don't have a controlled study to cite, but in every SaaS onboarding flow I've worked on, the pattern is the same: earlier activation = higher retention."
Honest qualification beats vague authority.
Step 4: Vary Paragraph Structure
Break the uniform pattern (Statement > Explanation > Example > Bridge):
Step 5: Add Friction and Imperfection
Real people:
After removing AI patterns, inject the brand's specific personality.
Step 1: Extract Voice from Examples
If brand guidelines exist, reference them. If not, request one example of writing the brand loves. Extract:
Step 2: Apply Voice Techniques
| Technique | How to Apply |
|-----------|-------------|
| Personal anecdotes | "We saw this firsthand when building X" |
| Direct address | Talk to the reader as "you," not "users" or "teams" |
| Opinions without apology | "We think the industry is wrong about this" |
| The aside | Brief parenthetical showing you know more than you are saying |
| Rhythm signature | Match the sentence pattern from the brand's best examples |
| Controlled imperfection | Strategic fragments, direction changes, honest qualifications |
Step 3: Consistency Check
After voice injection, verify:
These words appear disproportionately in AI-generated text:
Tier 1 — Instant Tells:
delve, landscape (metaphorical), crucial, vital, pivotal, leverage, robust, comprehensive, holistic, foster, facilitate, ensure, navigate (metaphorical), utilize, furthermore, moreover, in addition
Tier 2 — Suspicious in Clusters:
streamline, optimize, innovative, cutting-edge, game-changer, paradigm, synergy, ecosystem, empower, unlock, harness, transformative, seamless
AI hedges constantly because it does not want to be wrong:
Every paragraph follows the same SEEB pattern:
Statement > Explanation > Example > Bridge
Real writing varies. Some paragraphs are one sentence. Some are lists. Some are questions followed by answers. Some digress and come back.
AI replaces specific claims with vague ones to avoid being wrong:
One or two em-dashes per piece: fine. Em-dash in every other paragraph: AI fingerprint.
AI asserts confidently about things nobody can be certain about. "Companies that do X are more successful." According to what data? Based on what sample size?
AI conclusions restate the introduction:
"In this article, we explored X, Y, and Z. By implementing these strategies, you can achieve..."
No human concludes like this. Real conclusions add something new or nail the exit line.
AI writing has metronomic consistency. Every sentence is roughly the same length. The reader's attention flatlines.
Map sentence lengths and deliberately vary them:
Before (AI rhythm):
> Content marketing is an essential strategy for modern businesses. It helps build trust with potential customers over time. Creating high-quality content requires careful planning and execution. The most effective content strategies combine data-driven insights with creative storytelling.
Every sentence: 8-10 words. Same structure. Same length.
After (human rhythm):
> Content marketing works. Not because it is clever — because it builds trust before you ever ask for a sale. That takes time. It takes planning. And honestly? It takes more failed drafts than anyone likes to admit. But the companies that figure it out — the ones that combine real data with stories that actually land — they win. Not quickly. But permanently.
Mixed length. Fragments. Questions. Repetition for emphasis. Direction changes.
| Pattern | When to Use |
|---------|-------------|
| Long. Short. | After complex explanation, punch with a short statement |
| Question? Answer. | Engage the reader, then satisfy the curiosity |
| Claim. Evidence. So what? | Make a point, prove it, explain why it matters |
| List. Then prose. | Present options or items, then return to narrative |
| Confession. Lesson. | Admit a mistake, extract the learning |
Every vague claim must become either specific or honestly qualified. There is no third option.
| Vague | Specific Alternative | Honest Qualification |
|-------|---------------------|---------------------|
| "Many companies" | "In a 2024 Gartner survey of 1,200 enterprises" | "In the teams I've worked with" |
| "Studies show" | "A Stanford study published in Nature (2023)" | "I haven't seen controlled studies, but the pattern is..." |
| "Significant improvement" | "A 34% reduction in churn over 6 months" | "Noticeable improvement — I'd estimate 20-30% range" |
| "Industry leaders" | "Stripe, Notion, and Linear" | "The companies I'd point to as examples" |
| "Best practices" | "[Organization]'s published framework recommends" | "What I've seen work consistently" |
| "Growing trend" | "Adoption grew from 12% to 47% between 2022 and 2025" | "Anecdotally, I'm seeing more teams try this" |
Before (AI-generated):
> It is crucial to leverage your existing customer data in order to effectively navigate the competitive landscape. Furthermore, by implementing a robust onboarding strategy, organizations can ensure that users achieve maximum value from the product and reduce churn significantly.
After (humanized):
> Here's the thing nobody says out loud: most SaaS companies have the data to fix their churn problem. They just do not look at it until after customers leave.
>
> Your activation funnel tells you everything. Your best cohorts, your worst, the exact moment the drop-off happens. You do not need another tool — you need someone to stop ignoring what the tool is already showing you.
>
> Nail onboarding first. Everything else is downstream.
Before (AI-generated):
> In the rapidly evolving landscape of digital marketing, it is essential for businesses to leverage cutting-edge strategies to stay ahead of the competition. By implementing a comprehensive content marketing approach, organizations can foster meaningful connections with their target audience and drive sustainable growth.
After (humanized):
> Digital marketing changes fast. That part is true. But the companies that actually grow? They are not chasing every new tactic. They are doing the boring stuff well.
>
> Write content people want to read. Answer questions your customers actually ask. Do it consistently for 12 months. It is not exciting advice. But it works — and the "cutting-edge strategies" usually do not.
10. Flag the specificity gap — You can make prose flow better, but you cannot invent proof points. If the piece makes five vague claims with zero data, the author needs to provide the specifics. Flag this clearly.
| Problem | Likely Cause | Fix |
|---------|-------------|-----|
| Content still sounds AI-generated after humanization pass | Only surface-level word replacements done — structural uniformity and hedging patterns remain | Run all three passes in order: filler removal, rhythm repair, specificity replacement. Address structure, not just words |
| Brand voice inconsistent after editing | Voice injection done without reference examples or clear guidelines | Request one example of writing the brand loves before injecting voice; extract formality, humor, and relationship stance |
| Over-humanized technical documentation | Personality injection applied to content that needs clarity over personality | Match humanization level to content type — docs need clarity; blog posts and marketing copy need personality |
| Specificity gaps flagged but cannot be filled | Writer does not have access to real data, expert quotes, or original research | Flag clearly as "author must provide" — humanizer cannot invent proof points. Honest qualification beats vague authority |
| AI detection tools still flagging content | Structural patterns (SEEB uniformity) persist despite word-level changes | Vary paragraph structures deliberately — single-sentence paragraphs, questions, fragments, asides, confessions |
| Readability dropped after humanization | Informal language and fragments reduced Flesch score | Balance personality with readability — fragments are fine but complex vocabulary can hurt scores. Target Flesch 60-70 |
| Google SynthID or similar tool detects AI origin | Content was generated with tools that embed watermarks (e.g., Google Gemini) | Rewrite substantially rather than editing in place; change structure, not just words. SynthID detection is statistical |
In scope:
Out of scope:
Known limitations:
# Score content for AI patterns and generate audit report
python scripts/readability_scorer.py article.md --json
# Detect AI filler words and hedging patterns with counts
python scripts/ai_pattern_detector.py article.md --verbose
# Analyze content for humanization opportunities
python scripts/content_scorer.py article.md --json
Take borghei/content-humanizer from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.