Systems Lab

Agent skill

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.

activeSelf-containedInstructions only3,392 words

Filed under Content and SEO.

From realjaymes/marketingagentskills · 25 skill entries · 63 · pushed 2026-09-14

What it does when it runs

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.'

Automated analysis of the skill and the 1 file bundled beside it. A skill’s own description is written to be selected by an agent, so it describes the job and not the dependencies.

Keys and connectors you must supply
None found.
Hosts it reaches
No third-party host appears in the skill or its bundled files.
Tool permissions it declares
No allowed-tools in the frontmatter. It only issues instructions, so there is nothing to bound.
Actions present in the files
None. Instructions only.

Ask about ai-humanizer

Opens your assistant with this page's verified links already in the prompt.

Is this safe to install?ClaudeChatGPT
Adapt it to my stackClaudeChatGPT
What else do I need for it to workClaudeChatGPT
Rather ask a human? Talk to Cheetah
git clone --depth 1 --filter=blob:none --sparse https://github.com/realjaymes/marketingagentskills.git /tmp/marketingagentskills
git -C /tmp/marketingagentskills sparse-checkout set "skills/ai-humanizer"
mkdir -p ~/.claude/skills/ai-humanizer
cp -R "/tmp/marketingagentskills/skills/ai-humanizer/." ~/.claude/skills/ai-humanizer/

Picked up without a restart. A project skill of the same name is shadowed by your personal one. For one repository only, swap ~/.claude/skills for .claude/skills. Claude Code docs ↗

The folder is the same in every client that implements the format — 46 of them — so if yours is not above, only the destination changes.

Reproduced in full from realjaymes/marketingagentskills/blob/cf041d05c16829ef18c54fd61adde46ed2053d9f/skills/ai-humanizer/SKILL.md, which is licensed MIT (repository). 3,392 words, 29 headings.

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:

InputDescriptionExample
[text]The draft to analyze(user's content)
[domain]Topic/industryB2B SaaS, academia, fiction
[audience]Who will read itStartup founders, students
[purpose]Goal of the textEducate, 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)

TraitWhat 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 & PunctuationFrequent 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/MonotonyRepetitive sentence length (low burstiness), rule-of-three padding, "-ing" significance tails, formal transition openers ("Furthermore," "Moreover"), signposted conclusions, paragraph stuffing, no white space
Missing HumanityNo 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, each row covers one underlying move, and variants of that move share its row (the setup-payoff construction lives in the negation-reveal row). Keep variants together instead of splitting them into new rows.

Contrast & Reveal Constructions

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

PatternProblemFix
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 constructionsSame-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.

PatternProblemFix
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.

PatternProblemFix
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 itCut 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 toName 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.

PatternProblemFix
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 pieceCap 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.

PatternProblemFix
Source document as grammatical subjectRepeatedly 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 contextA 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

PatternProblemFix
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 seriesVary 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

PatternProblemFix
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

TraitScoreEvidence
Jargon/Cliche5"cutting-edge," "leverages," "revolutionize"
Dash & Punctuation2Acceptable
Hedging/Vagueness4No metrics, generic claims
Structure/Monotony3Similar sentence length
Missing Humanity5No contractions, no specifics, no dates/places
Command Phrasing0None 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

Evidence Base

Several patterns beyond the original rubric rest on specific evidence. Knowing the source helps when judging an edge case.

  • Dropped-subject fragments anywhere in a piece, including the adjective-first CTA question: a check limited to sentence openers let clause-level fragments through in cold-email and LinkedIn outreach drafts, so the rule covers every clause.
  • "Shape of" meta-naming, the source document as subject, source-lifted phrases, and the mail-merge test: a diff of James's own hand-edits against 5 sent application letters surfaced these tics, and a vault-wide grep found the same tics in 13+ earlier application files.
  • Crutch-word overuse ("real," "honest"), vague definite-article nouns, setup-payoff constructions, vague connection language, the expanded AI vocabulary list, and the Structural Tells section: an audit of 9+ live website pages surfaced these, cross-checked against the external sources under References.

References

See 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 (community-maintained, the most actively updated public catalog, includes formatting/markup/citation-artifact tells beyond prose); avoid-ai-writing (a sibling Claude Code skill with a 74+ pattern deterministic detector, useful for cross-checking coverage). Checked 2026-09-09.

Files bundled with it

These load only when the skill asks for them, so they cost nothing until it runs.

Other skills for the same job

Different authors, same problem. Matched on the words in the skill name, across every library in the catalogue except this one.

Need help setting it up?

This page tells you what ai-humanizer does and what it needs. Cheetah builds the agent setup it runs inside: data, CRM, sequencing and the guardrails.

Book a call →

The directory stays free. There is nothing gated behind this.