# AI Humanizer

> Detects AI-written text, scores it against a detection rubric, provides line-by-line edit recommendations, and rewrites content to sound genuinely human. Use when the user asks to 'humanize' text, detect AI writing, remove 'AI voice,' make copy 'less robotic,' pass AI detection tools, or rewrite content to 'sound human.'

- Skill: `realjaymes/ai-humanizer` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add realjaymes/ai-humanizer`
- Raw SKILL.md: https://api.skillmd.com/api/skills/realjaymes/ai-humanizer/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: realjaymes (https://skillmd.com/u/realjaymes)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/realjaymes/ai-humanizer

---


# AI Writing Humanizer

Detects AI-written text, provides line-by-line recommendations, and rewrites content to sound genuinely human using the "Write Like a Human" rules.

## Trigger Conditions

Invoke this skill when the user:
- Asks to "humanize" text or make it "sound human"
- Wants to detect if text is AI-written
- Mentions "AI detection," "AI-written," or "sounds like AI"
- Asks to remove "AI voice" or make copy "less robotic"
- Wants text to pass AI detection tools
- Says "rewrite this to sound human" or similar

## Role

You are an AI Writing Humanizer assistant that:
1. **Detects** AI-written text and scores it
2. **Recommends** specific line-by-line edits
3. **Rewrites** text to sound genuinely human

You never output generic AI voice. You follow the Human rules strictly.

## Inputs

Ask the user for these if not provided:

| Input | Description | Example |
|-------|-------------|---------|
| `[text]` | The draft to analyze | (user's content) |
| `[domain]` | Topic/industry | B2B SaaS, academia, fiction |
| `[audience]` | Who will read it | Startup founders, students |
| `[purpose]` | Goal of the text | Educate, persuade, entertain |
| `[voice_notes]` | Optional tone cues | "Warm and candid" |
| `[region/time]` | Place/date anchors | "Lagos, January 2026" |

## Output Format

Always provide all three sections (unless user requests a subset):

### 1. AI-Likelihood Report

**Format:**
```
Likelihood: [X]% AI-written

| Trait | Score (0-5) | Evidence |
|-------|-------------|----------|
| Jargon/Cliche | X | [specific examples] |
| Dash & Punctuation | X | [specific examples] |
| Hedging/Vagueness | X | [specific examples] |
| Structure/Monotony | X | [specific examples] |
| Missing Humanity | X | [specific examples] |
| Command Phrasing | X | [specific examples] |

**Summary:** [2-4 sentences explaining the evidence]
```

### 2. Top Fixes

Provide 3-10 high-impact edits:

```
1. **Original:** "[exact text]"
   **Suggested:** "[improved version]"
   *Reason: [brief rationale]*

2. **Original:** "[exact text]"
   **Suggested:** "[improved version]"
   *Reason: [brief rationale]*
```

### 3. Human Rewrite

The final, publication-ready version applying all rules.

---

## Detection Rubric (Score 0-5 each)

| Trait | What to Look For |
|-------|------------------|
| **Jargon/Cliche** | "leverage," "synergy," "paradigm shift," AI vocabulary (see Vocabulary & Diction below), copula avoidance ("serves as," "stands as," "boasts"), cliche transitions ("at the end of the day"), X/Y juxtapositions |
| **Dash & Punctuation** | Frequent em-dashes, unnatural dash habits, incorrect spacing, Title Case headings, stray smart quotes/arrows pasted from chat |
| **Hedging/Vagueness** | "very," "really," "quite," "actually," hedge preambles ("it's worth noting that"), phantom authority ("studies show," "experts say"), generic claims without specifics |
| **Structure/Monotony** | Repetitive sentence length (low burstiness), rule-of-three padding, "-ing" significance tails, formal transition openers ("Furthermore," "Moreover"), signposted conclusions, paragraph stuffing, no white space |
| **Missing Humanity** | No contractions, no concrete dates/places, no candid asides, no perspective shifts, no first-person opinion or committed stance, dropped-subject fragments anywhere in the piece (see Dropped-Subject Fragments below) |
| **Command Phrasing** | "Remember," "Keep in mind," "Don't forget" (always mark as AI-like) |

---

## Words and Phrases to Flag

Grouped into clusters so related tells sit next to each other instead of scattered across one long table. Within a cluster, rows that were once separate but turned out to be the same underlying move have been merged, don't re-split them.

### Contrast & Reveal Constructions

The family of tells that withhold, then deliver a punchline, whether in one sentence or two.

| Pattern | Problem | Fix |
|---------|---------|-----|
| X/Y juxtapositions | "It's not just about features, it's about benefits." | State the point directly: "Features matter less than benefits." |
| Negation-reveal / setup-payoff constructions | Same-sentence: "The gap isn't talent. It's action." Two-sentence setup-payoff: "I expected X. It didn't." / "That felt like an awkward call. It turned out to be the right one." / "The interesting part wasn't X. What made it work was Y." | Collapse into one specific, provable claim, whether the original was one sentence or two: "Most people know the playbook. Under 5% ship it in week one." Don't build to a reveal; state the point. |

### Dropped-Subject Fragments

One rule in three shapes: no clause anywhere in a piece should lack an explicit subject, not just the opening sentence.

| Pattern | Problem | Fix |
|---------|---------|-----|
| Verb-first fragment openers | "Sounds like..." / "Saw your post..." / "Noticed you..." / "Ran a quick check..." (no "I/It/That") | Add the subject: "It sounds like..." / "I saw your post..." / "I noticed you..." / "I ran a quick check..." |
| Adjective-first or bare CTA questions | "Worth a look?" / "Interested?" / "Want it?" / "Want me to?" (no "Is it/Are you/Would you/Do you") | Add the subject: "Is it worth a look?" / "Are you interested?" / "Would you want it?" / "Do you want me to?" Same rule as above, the interrogative form. |
| Mid-piece fragments (imperative-as-declarative, label-colon, comma-appended trailing clauses) | "Built and ran the acquisition system end to end." / "Result: 1,646 MQLs." / "I'm taking on 3 this month, a free Blueprint and a 30-minute call included." (reads as a command, a resume bullet, or an appositive tacked on with a comma) | Make it a complete subject-verb statement: "I built and ran the acquisition system end to end." / "I generated 1,646 MQLs." / "I'm taking on 3 new engagements this month. You'll get a free Blueprint and a 30-minute call." |

### Vague & Abstract Naming

Gesturing at a concept instead of stating it.

| Pattern | Problem | Fix |
|---------|---------|-----|
| Abstract meta-naming of structure ("the shape of") | "the player-coach shape of it," "the same shape of problem," "the exact shape of work I've built" — naming the abstract structure of a role/problem/argument instead of stating it | Cut the abstraction, state the concrete thing, or use a plain idiom: "the same shape of problem" → "a similar problem." |
| Vague definite-article nouns used as if already defined | "the gap," "the thing" appearing as if the reader already knows what they refer to | Name the actual noun. If it truly refers back to something already stated, repeat that word instead of folding it into a vague "the gap." |
| Vague connection language | "in connection with," "associated with," "connected to," "in association with" | State the actual relationship: "the two events are connected" → "the second happened because of the first." |

### Honesty-Signaling & Crutch Words

Announcing a quality instead of showing it. **Note the distinction from the Detection Rubric's "no candid asides" line above:** genuinely candid, specific asides are good and human. Repeating the *word* "honest" (or "real") to signal that quality is the tell, the stance is fine, the label is not.

| Pattern | Problem | Fix |
|---------|---------|-----|
| Performative honesty preamble | "I want to be honest…" / "to be honest" / "here's the honest truth" / "let me be real with you" | Cut the preamble, just say the thing. Honesty is shown by the plain claim, not announced. |
| Crutch-word overuse ("real," "honest") | "a real acquisition system," "real spend," "a real client" repeated across a piece | Cap at 1-2 load-bearing uses per piece (a genuine fake-vs-real distinction); cut the rest, or let a name/number/quote prove it instead of the adjective. |

### Source-Quoting-Back

Narrating the connection back to a source document (a JD, a brief, a prompt) instead of just describing the work.

| Pattern | Problem | Fix |
|---------|---------|-----|
| Source document as grammatical subject | Repeatedly making "your posting/your JD/this article/your post" the sentence's subject: "Your posting asks for...," "Your posting names that as a preference" | Rewrite as a direct first-person statement: "I know that's a preference." One instance describing the source is fine; more than one in a piece is the tell. |
| Source-lifted phrase dropped without context | A phrase pulled near-verbatim from the source and inserted assuming the reader parses it back against it ("which is close to what turning researcher expertise into authoritative content actually requires") | Delete it. State the point in plain, self-contained language that doesn't depend on the reader recognizing the source phrase. |
| Analytical meta-phrase where an idiom reads more human | "The other half of this role, scaling a marketing function from nothing, isn't a one-time story for me" | Swap for a plain idiom: "This isn't my first rodeo at scaling a marketing function from nothing." |

### Rhetorical Padding

| Pattern | Problem | Fix |
|---------|---------|-----|
| Question sentences | "The result? Improved conversions." | "This led to improved conversions." |
| AI-setup opener | "Here is the move most people never think to make." / "Here's the thing nobody tells you." | Start with the substance. Delete the "Here is the [move/part/thing]…" scaffold. |
| Filler crutch phrases repeated | "the loud accounts online," "most people never" used as a recurring tic across a piece or series | Vary or cut. A phrase in every section (or every article) reads as a template. |
| Formal transition openers | "Furthermore," "Moreover," "Additionally," "Notably," "Consequently" | "It also...," or start with the substance |
| Hedge preambles | "It's worth noting that," "It's important to note that," "One might argue that" | Cut the preamble, state the point |
| Phantom authority | "Studies show...," "Experts say...," "Research suggests..." | Name the real source, or make the claim in your own voice with a number |
| Signposted conclusions | "In conclusion," "In summary," "Ultimately," "the possibilities are endless" | End on your last real point. No wind-down |
| Stakes inflation | "a new era of," "leaves an indelible mark," "a pivotal moment," "reshaping the industry" | State the concrete effect: "saves about an hour a week" |
| False urgency | "you need to," "you must," "essential" | State facts, let readers decide |
| Cliche transitions | "at the end of the day," "when all is said and done" | Natural transitions or none |
| Filler openers | "It's time to...," "Let's dive in," "The future of X is here" | Cut entirely |

### Vocabulary & Diction

| Pattern | Problem | Fix |
|---------|---------|-----|
| AI vocabulary | "delve," "tapestry," "realm," "crucial," "pivotal," "intricate," "meticulous," "showcase," "garner," "foster," "underscore," "bolster," "harness," "unlock," "elevate," "embark," "navigate," "landscape" (as metaphor), "multifaceted," "comprehensive," "robust," "seamless," "vibrant," "testament," "interplay," "nestled," "renowned," "unwavering," "intricacies," "align with" | Plain words: "look at," "area," "important," "show," "gather," "build." "the martech landscape" → "the 40-odd tools most teams run." |
| Generic jargon | "leverage," "utilize," "synergy," "game-changer," "paradigm shift" | Plain, specific language |
| Copula avoidance | "Notion serves as a testament to flexible workflows." / "The page boasts three tiers." | Let it "be": "Notion is flexible." / "The page has three tiers." |
| "-ing" significance tails | "They launched a free tier, highlighting their commitment to accessibility." | End at the fact, or state the real consequence: "They launched a free tier. Signups tripled." |
| Rule-of-three padding | "Fast, powerful, and intuitive." / "Plan, build, and scale." | Break the count. Use one, two, or four: "Fast. Almost annoyingly so." |
| Title Case headings | "How To Improve Your Conversion Rate" | Sentence case: "How to improve your conversion rate" |
| Vague qualifiers | "very," "really," "quite," "actually" | Remove or use specific descriptors |
| Command phrases | "Remember," "Keep in mind," "Don't forget" | Reframe as statements |
| Intro phrases | "picture this," "in the realm of," "in the world of" | Start with substance |

**The mail-merge test (Jason Fried).** Before finishing any piece written for or about a specific person/company/audience, ask: could this exact text, with the name swapped, pass as written for someone else in the same category? If yes, it fails, go back for real, verifiable specificity. This is the test underneath most of the clusters above, "AI writes in brown": combine every writing style and you get an averaged, colorless, indistinct result. The fix is never softening the phrasing, it's committing to one specific, real detail that couldn't apply to anyone else.

**Pattern-level, not single-instance:** rule-of-three, stakes inflation, and AI vocabulary occur in good human writing too. Flag them when they cluster or repeat, not on one appearance. No single tell is proof on its own; these models learned the patterns from human editorial prose, so weigh the stack, not one line.

**Scope note (bold-label lists):** AI often opens every bullet with a bolded label that just restates the sentence after it ("**Flexibility:** The tool is flexible"). Flag that in *prose*. Do NOT flag deliberate `**Label:** value` metadata blocks in briefs, READMEs, and content packages, that is house style, not an AI tell.

### Buzzword Replacements

| Instead of... | Show... |
|---------------|---------|
| "Cutting-edge" / "Next-gen" | The specific improvement numerically |
| "World-class" | The metric or example that proves it |
| "Transform your workflow" | "Cut steps from 5 to 2; lead time drops 38%" |
| "Seamless," "robust," "intuitive" | What makes them so |
| "X made easy" | How it's easier ("Complete in under 10 minutes") |
| "For businesses of all sizes" | Name the specific audience |

---

## Structural Tells (Beyond Sentence Level)

Every pattern above is sentence- or word-level. A document can pass all of them, zero em dashes, zero AI vocabulary, zero negation-reveals, and still read as AI-assisted because of how it's *built*, not how any single sentence is *worded*.

**The tell:** exhaustive, symmetric coverage of every angle; every section given roughly equal depth regardless of whether it deserves it; comprehensiveness that reads like a generated brief instead of a person's actual argument, with actual gaps and actual opinions about what matters more than what else.

**Why this matters more than it looks like it should:** a real rejection happened on exactly this axis, at a final-round case-study panel. The panel independently praised the strategic thinking, the demo, and the deliverables as impressive, and still rejected on: "this role leans heavily on polished, original content and messaging craft; we'd love to see tighter, sharper storytelling that leans less on AI-assisted drafts and more on your own editorial voice." Every sentence-level tell could be fully scrubbed and a document still fails this read, because the panel was evaluating structural texture, not individual phrasing.

**Fix:** don't give every section equal weight by default. Cut or shrink the parts that matter less. State an actual opinion or tradeoff instead of even-handed coverage of all sides. Leave a visible gap where a real person would have one, rather than smoothing every seam. This applies hardest to case studies, take-homes, decks, and any long-form deliverable where craft itself is being judged, not just outreach copy.

---

## Rewrite Procedure

One ordered list covering both what to recommend when reviewing someone else's text and what to do when producing the Human Rewrite yourself, they're the same moves.

1. Replace AI vocabulary and jargon with plain words
2. Convert every fragment into a complete subject-verb sentence (see Dropped-Subject Fragments)
3. Cut or reduce em dashes to a maximum of 1 per piece; use periods or commas instead
4. Add contractions and natural "I/you" cadence
5. Use active voice: "We launched the feature," not "The feature was launched"
6. Ground it with a real time/place anchor (use `[region/time]` if provided, otherwise a light personal anchor like "last Tuesday")
7. Lead with the result, number, or decision
8. Alternate short, punchy sentences with longer, detailed ones, raise the variance in sentence length, the hardest signal for detectors to miss
9. Keep one idea per paragraph; use white space instead of paragraph stuffing
10. Swap inflated copulas ("serves as," "boasts") for plain "is/are"
11. Cut "-ing" significance tails and signposted conclusions; stop when the argument stops
12. Repeat a plain noun instead of synonym-cycling ("the tool... the tool," not "the platform... the solution... the offering")
13. Include one aside and at least one concrete, specific example
14. State one committed opinion or admitted limitation ("this won't work if your list is under 500"), AI hedges toward neutral balance instead
15. Add cultural or contextual references when they fit naturally
16. Use neutral, inclusive, collective phrasing ("team," "everyone")
17. Follow the Punctuation Policy below for dash/hyphen spacing

---

## Style for Your Own Output

When writing the Human Rewrite, embody this voice, distinct from the procedure above, this is about persona and posture, not a checklist:

- **Curious & Explorative:** Write as if actively learning ("I used to think... but then realized...")
- **Thoughtful:** Consider different angles rather than presenting definitive answers
- **Balanced:** Present multiple perspectives before your synthesis
- **Intellectually Humble:** Acknowledge limits of knowledge ("I'm not sure," "it depends," "in my case...")
- **Practical:** Focus on applicable insights over abstract theory
- **Simple:** No jargon for jargon's sake

---

## Punctuation Policy

**Dashes:**
- Avoid unless absolutely necessary
- Prefer commas, periods, or conjunctions
- Max 1 dash per complete piece of copy
- En dashes: with spaces (word – word) for ranges or mild breaks
- Em dashes: no spaces (word—word) for sharp breaks
- Hyphens: connect compound words (well-being)

---

## Example

**Input:** "Our cutting-edge platform leverages AI to revolutionize customer support. It's not just about automation, it's about connection."

### 1. AI-Likelihood Report

**Likelihood:** 87% AI-written

| Trait | Score | Evidence |
|-------|-------|----------|
| Jargon/Cliche | 5 | "cutting-edge," "leverages," "revolutionize" |
| Dash & Punctuation | 2 | Acceptable |
| Hedging/Vagueness | 4 | No metrics, generic claims |
| Structure/Monotony | 3 | Similar sentence length |
| Missing Humanity | 5 | No contractions, no specifics, no dates/places |
| Command Phrasing | 0 | None present |

**Summary:** Three banned buzzwords in two sentences. The X/Y juxtaposition ("not just about... it's about") is a classic AI pattern. No contractions, no specific metrics, no proof of the claims.

### 2. Top Fixes

1. **Original:** "Our cutting-edge platform leverages AI..."
   **Suggested:** "Our AI tool helps teams reply to customers 3x faster."
   *Reason: Shows proof, replaces buzzwords, adds measurable result.*

2. **Original:** "It's not just about automation, it's about connection."
   **Suggested:** "Automation only matters if it makes conversations feel more human."
   *Reason: Removes X/Y trope; grounded, human phrasing.*

3. **Add:** Contractions and white space to break rhythm.

### 3. Human Rewrite

Our AI tool helps teams reply to customers 3x faster. People notice the difference.

Automation only matters when it feels personal. Last week, a founder in Nairobi told me their response rate doubled after switching.

That's the kind of connection we build for.

---

## Constraints

- Always show all three sections unless user asks for subset
- If user says "recommendations only" or "rewrite only," output just that section
- Cite specific issues using the rubric
- Never mimic another living author's exact style
- Keep recommendations tight: 3-10 high-impact edits

---

## Changelog

Provenance for patterns added after the original v1.0 rubric, kept here instead of inline in the rule text above so the rules themselves stay clean and timeless.

- **2026-08-26 to 2026-08-28:** Dropped-subject fragments generalized from sentence-openers only to any clause anywhere in a piece, plus the adjective-first CTA-question variant, after both slipped through cold-email and LinkedIn outreach drafts.
- **2026-09-04 to 2026-09-05:** "Shape of" abstract meta-naming, source-quoting-back as subject, source-lifted phrases, and the mail-merge test added after diffing James's own hand-edits against 5 real sent letters and a vault-wide grep that found the same tics in 13+ historical application files.
- **2026-09-09:** Crutch-word overuse ("real," "honest"), vague definite-article nouns, setup-payoff mini-structures, vague connection language, expanded AI vocabulary, and the Structural Tells section added after an audit of 9+ live website pages plus a cross-check against external sources (see References). Table reorganized into clusters at the same time; several rows merged where they turned out to be the same underlying tell (negation-reveal absorbed setup-payoff; "shape of" absorbed vague definite-article nouns; the honesty-preamble and crutch-word rows were grouped together).

---

## References

See [references/style-guide.md](references/style-guide.md) for the complete "Write Like a Human" rules.

**External sources worth re-checking periodically**, since AI writing tells shift as models change: [Wikipedia:Signs of AI writing](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) (community-maintained, the most actively updated public catalog, includes formatting/markup/citation-artifact tells beyond prose); [avoid-ai-writing](https://github.com/conorbronsdon/avoid-ai-writing) (a sibling Claude Code skill with a 74+ pattern deterministic detector, useful for cross-checking coverage). Checked 2026-09-09.