agentleFS
nc9nc9/skills/humanizer/SKILL.md

humanizer

Skill4 starsChanged 54 days agoMITView on GitHub

Remove AI-writing tells from text - 65 catalogued patterns plus measured AI-detector results. Use when humanizing a draft, editing text to sound human or natural, or lowering an AI detector score before publishing.

188 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use economy-mode, personal-voice and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • Microsoft AzureSkill

    economy-mode

    Shifts Layer 3 model selection to cost-optimized alternatives when economy mode is active.

    Also in 4 projects that use this

  • petermuirurithuoSkill

    personal-voice

    Captures the user's personality, communication style, and values. Use this skill whenever responding to the user, drafting anything on their behalf (emails, CVs, messages, opinions, explanations), or whenever tone, word choice, or how an opinion is delivered matters. Apply it by default for any prompt, not only when the user explicitly asks for "my style" or "my voice.

    Also in 3 projects that use this

  • Microsoft AzureSkill

    architectural-proposals

    How to write comprehensive architectural proposals that drive alignment before code is written

    Also in 3 projects that use this

  • +9 more from Azure

The file

We split this skill into the rules it gives an agent

3 rules. 0 are common, 2 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 175 edited versions we read keep these.

  • 2

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Verify: - read it aloud. Sounds like Wikipedia?

    line 36
  2. Distinctive:

    Publish gate: never publish - to a CMS, repo, MCP endpoint, file or anywhere else - until both loops below have run and the final score is …

    line 116
  3. Very specific:

    All 65 patterns, one line each.

    line 150

“Common” is measured: kept by at least 6 in 10 of the 175 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Humanizer: remove AI writing patterns

Strip the signs of AI-generated text, then add the human tells detectors look for. Based on Wikipedia's "Signs of AI writing" (WikiProject AI Cleanup) plus hands-on testing against the Pangram detector.

Current models already avoid the obvious tells unprompted. What earns its keep here is the measured, counterintuitive part: structure beats vocabulary, polishing makes things worse, and some topics cannot be rescued at all.

Process

  1. Assess the content type - set a realistic target from the difficulty table below before editing anything.
  2. Remove AI patterns - scan for all 65 patterns in the index below. The index is enough to spot them; open the reference file for any pattern whose fix you need worked through.
  3. Add human patterns - specific numbers and timeframes, self-deprecating asides, admitted uncertainty, varied sentence rhythm, casual transitions ("Look," "Anyway," "Point is,"), broken parallelism in lists. Removing tells without adding voice leaves sterile text that still flags.
  4. Verify - read it aloud. Sounds like Wikipedia? Add voice. Sounds over-polished? Put roughness back. Report the rewrite plus a short changelog: patterns removed, human patterns added, structural changes.

Narrative-first structure

The highest-leverage move, and the one most often skipped. For how-to, guide or advice content, lead with narrative and weave structure in.

Measured: pure narrative scores 30-35% AI, pure how-to 60-100%, narrative with structure woven in 40-50% and it reads better and it still ranks.

Open with a specific personal experience. Establish the problem through narrative, not bullets. Introduce solutions as things you tried, not "Step 1, Step 2". Keep headers, bold and lists sparse, for scanning only. Close with reflection, not a CTA. So "## How to Build Backlinks / - Digital PR: ..." becomes "I wasn't planning to write another backlinks post. Google keeps saying they matter less. Yet every time I look at actual data - my own sites, client sites - links are still the biggest factor. ... ## Digital PR (the best ROI right now) / Took me a while to come around on this one."

Measured detector results

Real Pangram runs, not estimates:

  • Narrative blog post: 100% -> 35% AI. Aggressive humanization works.
  • How-to guide: 100% -> 53-90% per segment; individual sections improved, the overall label stayed "AI".
  • AI/SEO industry post: 100% -> 100% AI, segments 99.98% -> 99.91%. Barely moved despite anecdotes, self-deprecation, tangents, casual headers, fragments and varied structure.

Voice work has a ceiling, and structure and topic set it.

Content-type difficulty

Content typeDifficultyRealistic target
Personal narrativeEasyBelow 30% AI
Opinion / hot takeEasyBelow 35% AI
Mixed narrative + adviceMediumBelow 45% AI
How-to guideHard50-70% AI (win at segment level)
Pure listicleVery hardMay not drop below 60%
AI / SEO / marketing topicsNear-impossibleMay stay 100% regardless of effort

A personal essay drops from 80% to 30% on voice changes alone. The same effort on a how-to moves 100% to 60%, because the structure itself is the signal.

The polished-rewrite trap

Over-editing increases detection scores. Clean rewrites routinely score higher than the rough originals they replaced - one measured pair went 50% (tidy rewrite) versus 35% (rougher version, same content). Detectors flag consistent sentence lengths, perfect parallel structure, smooth transitions and the absence of false starts. Leave the rough edges in.

Related traps: structure (how-to formats flag regardless of voice), consistency (uniform sentence length), authority (confident expertise reads as AI - admit uncertainty), parallel headers ("What works: A", "What works: B" repeating is an instant flag).

Topic-based detection bias

Some topics are so heavily represented in detector training data that they flag on subject matter rather than style: AI/ML, SEO and digital marketing, SaaS growth, productivity optimization, crypto, "future of X" analysis.

Decide early whether such content needs to pass detection at all. If it does, the only remaining lever is full restructuring into personal narrative. Otherwise accept the score and publish - a useful piece that reads as human to human readers is fine when detection scores do not gate your distribution.

Target metrics

Narrative: below 40% is good, below 30% excellent. Structured: 50-70% overall is expected, so measure by segment - get 2-3 segments below 60%. If three passes cannot get below 60%, stop humanizing and restructure.

Publishing workflow

Publish gate: never publish - to a CMS, repo, MCP endpoint, file or anywhere else - until both loops below have run and the final score is acceptable. Every article, single or batched, no exceptions for momentum or deadlines or "I'll humanize them after"; drafting and shipping in one pass produces detectable AI prose every time. About to call a publish, create-post or commit tool with text that hasn't been through both loops? Stop and run them first.

Loop 1 - humanize, then detect. Apply this skill to the full draft, then run the ai-writing-detector skill's detector: ./scripts/detect detect <file> --input-format markdown --output json. Capture fraction_ai and fraction_ai_assisted. If fraction_ai is below 25% and fraction_ai_assisted below 40%, skip Loop 2.

Loop 2 - re-humanize the flagged segments, then detect again. Use the segment-level output to find the highest-scoring passages and rewrite only those: break parallel and symmetrical structure, replace listicle scaffolding with narrative, add a specific anecdote, named product, concrete number or first-person aside every ~300 words, cut closing-paragraph macro framing.

Final fraction_aiAction
Below 25%Publish.
25-50%Acceptable if the voice is genuinely distinct and the format is structurally constrained (listicle, monthly guide, medical, finance - known topic and format bias). Note the score in the report.
Above 50%Do not publish. Restructure the piece (listicle to narrative, survey to Q&A) and rerun the loops, or escalate to the user with the segment scores and ask whether to publish anyway.

Why this order, and only two loops: humanize first so the detector reports the remaining scaffolding instead of the obvious tells you were always going to fix - detecting raw output wastes a cycle and biases the rewrite toward whatever that first run flagged, missing structural tells. Two loops, not three or more: if the score is still high after two, the piece needs structural redesign, not more humanization passes.

Pattern index

All 65 patterns, one line each. (+) marks patterns that are things to add, not tells to remove. Full before/after treatment lives in the reference files.

Content (1-6) - references/patterns.md

  1. Inflated significance - "stands as a testament", "pivotal moment", "evolving landscape", "reflects broader".
  2. Notability padding - lists of media coverage, "active social media presence".
  3. Superficial -ing tails - "highlighting...", "ensuring...", "reflecting..." bolted onto sentences.
  4. Promotional language - "nestled", "vibrant", "breathtaking", "rich cultural heritage", "boasts a".
  5. Vague attribution - "Experts argue", "Industry reports", "Observers have cited".
  6. "Challenges and future prospects" sections - "Despite these challenges, ... continues to thrive".

Language and grammar (7-12) - references/patterns.md

  1. AI vocabulary - delve, crucial, intricate, tapestry, underscore, landscape, showcase; magic adverbs (quietly, deeply, fundamentally).
  2. Copula avoidance - "serves as", "boasts", "features" where "is"/"has" belongs.
  3. Negative parallelism - "It's not just X, it's Y", "Not only... but...".
  4. Rule of three - forced triplets to sound comprehensive.
  5. Elegant variation - synonym cycling for one referent (protagonist/main character/central figure/hero).
  6. False ranges - "from X to Y" where X and Y aren't on a scale.

Style (13-18) - references/patterns.md

  1. Em dash overuse.
  2. Boldface overuse - mechanical emphasis on phrases.
  3. Inline-header vertical lists - "- User Experience: The user experience...".
  4. Title Case headings.
  5. Emojis decorating headings or bullets.
  6. Curly quotes and Unicode decoration - smart quotes, arrows in running prose.

Communication (19-21) - references/patterns.md

  1. Chatbot artifacts - "I hope this helps", "Certainly!", "let me know".
  2. Knowledge-cutoff disclaimers - "as of my last update", "while specific details are limited".
  3. Sycophantic tone - "Great question!", "You're absolutely right".

Filler and hedging (22-24) - references/patterns.md

  1. Filler phrases - "in order to", "due to the fact that", "it is important to note".
  2. Excessive hedging - "could potentially possibly be argued".
  3. Generic positive conclusions - "exciting times lie ahead", "a step in the right direction".

Blog posts (25-32) - references/blog-patterns.md

  1. "You did X" openings - three short beats ending in "You're proud."
  2. "The dirty secret" / "nobody talks about" trope.
  3. Marketing jargon - "top-of-funnel", "low-friction", "community engagement".
  4. Formulaic advice lists - valid points forced into parallel bullets.
  5. Generic section headers - descriptive and Wikipedia-flavoured instead of opinionated.
  6. Missing vulnerability - advice delivered from detached authority.
  7. Cliché transitions - "move the needle", "here's the kicker", "let that sink in".
  8. (+) "Welcome to the club" - naming a shared frustration to build solidarity.

Detector-driven (33-46) - references/detector-testing.md

  1. The polished-rewrite trap - clean edits score higher than rough ones.
  2. (+) Personal anecdotes with specific numbers - "200+ points once", "maybe 30 launches".
  3. (+) Self-deprecating parenthetical asides - "(yes I'm that person)".
  4. (+) Admitted confusion - "I don't fully understand it but it works".
  5. (+) Sentence fragments - "Wild." "Works though." "Yeah yeah,".
  6. (+) Casual quantifiers - "like 40-60 words max", "roughly 28%".
  7. (+) Specific sequences of events - narrate the steps instead of summarizing them.
  8. Detector-flagging structures - numbered steps, parallel bullets, FAQ format, uniform header+paragraph rhythm.
  9. Content-type difficulty - narrative easy, how-to hard, AI/SEO near-impossible (table above).
  10. (+) Converting lists to narrative - same information as flowing prose with asides.
  11. Repeated header pattern - "What works: A", "What works: B", "What works: C".
  12. (+) Conversational transitions - "So", "Look,", "Here's the thing:" instead of "Moreover".
  13. (+) Named emotions about specific things - "that one stung", not "the results were disappointing".
  14. Topic-based detection bias - AI/SEO/marketing topics flag on subject matter.

Sentence and paragraph structure (47-52) - references/patterns.md

  1. Dramatic countdown - "Not a framework. Not a library. Something far more fundamental."
  2. Self-posed rhetorical questions - "The result? A mass exodus."
  3. Anaphora abuse - consecutive sentences opening on the same word.
  4. Gerund fragment litany - "Building trust. Breaking barriers. Creating opportunity."
  5. Short punchy fragment overuse - one-sentence paragraphs manufacturing drama.
  6. Listicle in a trench coat - "The first... The second... The third...".

Tone and voice (53-58) - references/patterns.md

  1. Patronizing analogies - "Think of a database index as a book's table of contents".
  2. Futurism invitation - "Imagine a world where...".
  3. False vulnerability - "I'll be honest:" that resolves straight back into confidence.
  4. Asserting obviousness - "The truth is simple", "it all comes down to one thing".
  5. Pedagogical voice - "Let's break this down", "let's unpack this".
  6. Invented concept labels - "the visibility paradox", pseudo-academic coinages.

Composition (59-65) - references/patterns.md

  1. Fractal summaries - the same point in the intro, the section, and the conclusion.
  2. Dead metaphor - one metaphor's vocabulary appearing 4+ times.
  3. Historical analogy stacking - "Just as the printing press...", "Like the Industrial Revolution...".
  4. One-point dilution - a single argument restated ten ways to fill space.
  5. Content duplication - near-verbatim repeats between intro, body and conclusion.
  6. Signposted conclusion - "In conclusion", "At the end of the day".
  7. Formulaic introduction - "In today's rapidly evolving digital landscape".

When to read the references

  • references/patterns.md - before/after examples for 1-24 and 47-65, the personality-and-soul guidance, two worked full-document rewrites. Read when you need a specific pattern's fix worked through, or when a rewrite comes back technically clean but voiceless.
  • references/blog-patterns.md - patterns 25-32. Read when the text is a blog post, marketing page, or startup/SaaS content.
  • references/detector-testing.md - patterns 33-46, the iterative test loop and restructuring criteria. Read when the text will be scored by a detector, when a score stops moving between passes, or before deciding a piece needs structural redesign.

Attribution

Patterns 1-24: Wikipedia:Signs of AI writing (WikiProject AI Cleanup), drawn from thousands of observed instances on Wikipedia. Patterns 25-32: detector testing on marketing content, January 2026. Patterns 33-45 and the iterative process: hands-on Pangram API testing, January 2026, which took a narrative blog post from 51% to 35% across five iterations. Pattern 41 (content-type difficulty) came from how-to and listicle testing where aggressive humanization only moved segments from 91-100% to 53-90% while the overall label stayed "AI" - the finding that established structure matters as much as voice. Pattern 46 (topic bias) came from an AI/SEO post that stayed at 100% through every available technique. Patterns 47-65: adapted from tropes.fyi (March 2026), ~30 recurring rhetorical moves in LLM output.

From Wikipedia: "LLMs use statistical algorithms to guess what should come next. The result tends toward the most statistically likely result that applies to the widest variety of cases."

From detector testing: detectors look for the absence of human patterns as much as the presence of AI ones. Removing tells is half the job. And for some formats the structure itself is the signal, so no amount of voice work moves the label.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.