Humanizer: Remove AI-sounding patterns with 35 rules
A Markdown skill that removes AI-sounding prose with 35 patterns while preserving code and facts.
GitHub blader/humanizer Updated 2026-09-04 Branch main Stars 51.1K Forks 4.1K
Markdown Skills CLI AI writing Claude Code 2.1.142+

🧭 Decision Guide

Try it if you

  • Your agent supports skills and you need to process AI-generated Markdown prose
    The README's “How it works” says “it works with any agent that supports skills” and states that file mode changes only prose.
  • You want to check AI-writing signals against Wikipedia's 35 patterns
    The README's “The 35 patterns” section lists 35 patterns sourced from Wikipedia's “Signs of AI writing”.
  • You can provide the source facts or a 2-3 paragraph writing sample
    The README says factual details must come from the source or writer and supports voice matching from a writing sample.

Skip it if you

  • Your agent does not support skills or your environment is outside the listed installation paths
    The README explicitly lists Skills CLI, the Claude Code plugin, Claude Desktop skill upload, and copying `SKILL.md` manually.
  • The task requires Humanizer to invent missing names, numbers, dates, or citations
    The README's “How it works” says these details “must come from the source or the writer” and that “It does not make things up”.
  • You need release history, version data, or contributor activity to assess maintenance
    Project metadata reports 0 contributors, 0 releases, and “No releases” as the latest version.

Requirements

  • README text: "Because it is just Markdown, it works with any agent that supports skills."
  • The Skills CLI installation command is: `npx skills add blader/humanizer --global`
  • Claude Code must be “2.1.142 or newer” to install the plugin.
  • Claude Desktop requires uploading the repository ZIP as a skill; manual installation copies `SKILL.md`.

First step (verbatim from README)

npx skills add blader/humanizer --global

Watch out

  • File mode changes only prose and leaves code, data, frontmatter, and link targets unchanged
    The README's “How it works” section explicitly lists these preserved elements.
  • Technical and reference prose remains neutral and plain by default
    The README says “Technical and reference prose stays neutral and plain”.
  • The first rewrite and a short critique appear before the final version
    The README says pasted text shows the first rewrite and a short critique of remaining artificial-sounding text.

Not stated in the README

  • The README does not list specific supported agent names or a complete compatibility matrix.
  • The README provides no performance, context-length, batch-size, or runtime-cost data.
  • The README provides no test suite, accuracy figures, human evaluation, or coverage metrics for the 35 patterns.
  • The README does not explain whether text is sent to external models, how long data is retained, or the privacy boundary.
  • The README omits the “Style patterns” and “Version history” sections, so the complete rules and change history cannot be checked.

💡 Deep Analysis

6
No I only allow Humanizer to rewrite language and common AI-writing patterns, but I need a guarantee that the article will pass any AI-detection system. Can this project meet that requirement?
For: A blog author who wants a guarantee of passing any AI-detection system while allowing only language-level rewriting without changing facts

No. The project is intended to reduce common AI-writing patterns, not to guarantee passage through every detection system.

  • The README defines the tool as rewriting AI-sounding text so it reads like a person wrote it, using 35 patterns from Wikipedia as editorial guidance.
  • It preserves the original claims and forbids inventing names, numbers, dates, quotes, or citations; it does not create a verifiable proof of human authorship.
  • The project insight explicitly warns against treating it as an AI detector or as a guarantee for bypassing detection.
  • The README provides no independent detector, objective score, deterministic output, or compatibility testing against any detection system.
  • README, “Humanizer”: “Humanizer rewrites AI-sounding text so it reads like a person wrote it, without changing what it says.”
  • README, “How it works”: “Humanizer uses 35 patterns from Wikipedia's 'Signs of AI writing'”
  • README, “How it works”: “It does not make things up.”
  • Project insight, “user_experience / common_pitfalls”: it does not guarantee passing any detection system
/humanizer

[paste your text here]
Not stated in the README:The README provides no test results or pass rates for any specific AI detector.;It does not define an objective score for what “reads like a person wrote it” means.
No I am processing high-risk text containing academic citations and critical numbers, and no new facts may be added. Can Humanizer deliver the final draft without human review?
For: A researcher editing legal, medical, financial, or citation-heavy academic content who cannot tolerate fabricated names, numbers, dates, quotes, or citations

No. It should not be used to deliver a high-risk document without human review. Humanizer prohibits fabrication, but the project insight explicitly excludes unsupervised use for high-risk content.

  • The README requires every name, number, date, quote, citation, and other factual detail to come from the source or the writer.
  • It checks the rewrite against the original claims after the first pass, which reduces risk but is not an independent fact-verification mechanism.
  • The project insight notes that the underlying agent can still introduce semantic drift, omit qualifiers, or merge sentences incorrectly.
  • Legal, medical, financial, academic-citation, and high-risk technical documents are specifically identified as unsuitable for use without human review.
  • README, “How it works”: “A name, number, date, quote, citation, or other factual detail must come from the source or the writer.”
  • README, “How it works”: “Then it checks the draft against those patterns and the original claims”
  • Project insight, “user_experience / usage_limitations”: unsuitable for legal, medical, financial, academic-citation, or high-risk technical documents without human review
  • Project insight, “user_experience / common_pitfalls”: semantic drift, omitted qualifiers, or incorrectly merged sentences may occur
Not stated in the README:The README does not describe the algorithm, coverage, or verifiable accuracy of factual-consistency checks.;It does not specify citation parsing, source access, or legal and academic-format validation.
Yes I use Claude Code 2.1.142 and also need Codex or Cursor to use the same rules. Is Humanizer suitable as a shared skill without adding a separate service or runtime?
For: A developer using Claude Code 2.1.142, Codex, or Cursor who wants to reuse the same writing rules across an Agent Skills workflow

Yes. Humanizer fits because it is an Agent Skill written as Markdown, so it does not require a separate service, database, or compiled runtime.

  • The README says it works with “any agent that supports skills” because it is just Markdown.
  • Installation is available through the Skills CLI, a Claude Code plugin, Claude Desktop upload, or manual copying of SKILL.md.
  • The Claude Code plugin requires version 2.1.142 or newer, which matches your stated constraint.
  • The rules and multi-stage workflow are prompt-driven, so they can be reused across agents. However, output quality still depends on each agent’s instruction-following behavior and context window.
  • README, “Humanizer”: “Because it is just Markdown, it works with any agent that supports skills.”
  • README, “Installation”: Skills CLI, Claude Code plugin, Claude Desktop upload, and manual installation
  • README, “Installation”: “Claude Code 2.1.142 or newer can install the plugin instead”
npx skills add blader/humanizer --global
Not stated in the README:The README does not provide a complete compatibility matrix for Claude Code, Codex, and Cursor.;It does not specify output consistency, performance, or context-window requirements across agents.
Yes I can provide two to three paragraphs of my own writing and want to preserve my rhythm, word choice, punctuation, and deliberate quirks. Will Humanizer flatten the article into its default polished style?
For: A personal writer or researcher who can provide two to three paragraphs of sample writing and wants to preserve a personal voice

Yes, provided that you supply the sample together with the target text. The README explicitly says the sample takes precedence over the default style rules.

  • The usage section supports “2-3 paragraphs of your own writing for voice matching.”
  • Humanizer follows the sample’s rhythm, word choice, punctuation, and deliberate quirks rather than forcing a uniformly polished voice.
  • For personal writing, it says it keeps the writer’s style; technical and reference prose remains neutral and plain.
  • The project insight also identifies a limitation: voice matching may be unstable when the sample is too short, internally inconsistent, or from a substantially different genre.
  • README, “Match your voice”: “paste 2-3 paragraphs of your own writing for voice matching”
  • README, “Match your voice”: “Humanizer follows the sample's rhythm, word choice, punctuation, and deliberate quirks.”
  • README, “How it works”: “For personal writing, Humanizer keeps the writer's style.”
  • Project insight, “user_experience / common_pitfalls”: matching may be unstable with samples that are too short, inconsistent, or from a different genre
/humanizer

Here's a sample of my writing for voice matching:
[paste 2-3 paragraphs of your own writing]

Now humanize this text:
[paste AI text to humanize]
Not stated in the README:The README provides no quantitative relationship between sample length, genre differences, and voice-matching quality.;It provides no automated score or regression test for style preservation.
It depends We need to process multiple Markdown files and require each file to change only in prose. Does the README provide a batch-processing interface rather than supporting only pasted text or one file path at a time?
For: A documentation team processing multiple Markdown files while requiring code, data, frontmatter, and link targets to remain unchanged

It depends. Humanizer supports file-level prose rewriting, but the README does not promise batch APIs or recursive directory processing, so suitability for an automated document set is unconfirmed.

  • The file example in the Usage section supplies one path: Humanize the prose in docs/launch-post.md.
  • The file-processing rule explicitly preserves code, data, frontmatter, and link targets, which addresses the structural requirement for an individual file.
  • Because the project runs as a Markdown Skill inside an agent rather than as a standalone batch engine, multi-file iteration depends on the particular agent workflow.
  • The README does not document batch CLI flags, concurrency behavior, retry handling, or an output-directory convention.
  • README, “Usage”: “To rewrite a file, give Humanizer its path”
  • README, “Usage”: “Humanize the prose in docs/launch-post.md”
  • README, “How it works”: “it changes only the prose, leaving code, data, frontmatter, and link targets alone.”
  • Project insight, “solution_analysis / usage_limitations”: not an independent text-processing engine and mainly targets Markdown and Agent Skills workflows
Humanize the prose in docs/launch-post.md
Not stated in the README:The README does not describe recursive directories, batch input, concurrency, or retry behavior.;It does not specify naming, backup, or diff-output behavior for batches.
It depends I need to rewrite the prose in `docs/launch-post.md` without changing code, data, frontmatter, or link targets. Is Humanizer suitable for processing this file directly?
For: A technical documentation author maintaining Markdown files containing code blocks, structured data, frontmatter, and links

It depends. The README explicitly targets this Markdown workflow, but protection for complex structures still depends on the connected agent following the skill instructions correctly.

  • For file input, the README says it changes “only the prose,” leaving code, data, frontmatter, and link targets alone.
  • The workflow performs an initial rewrite, checks the result against 35 patterns and the original claims, and revises remaining issues.
  • This makes it appropriate for language-level cleanup of AI-sounding prose.
  • However, Humanizer is not an independent document-processing engine; structural protection is enforced through the agent’s behavior. The README does not document compatibility with complex templates, deeply nested Markdown, or special CMS syntax.
  • README, “How it works”: “it changes only the prose, leaving code, data, frontmatter, and link targets alone.”
  • README, “How it works”: “It makes a first pass... Then it checks the draft against those patterns and the original claims”
  • Project insight, “user_experience / common_pitfalls”: complex nested Markdown, template syntax, or special document formats may still be modified accidentally
Humanize the prose in docs/launch-post.md
Not stated in the README:The README does not define automated tests or failure detection for structural preservation.;It does not list the supported range of complex Markdown, template syntax, or CMS formats.

✨ Highlights

  • Based on Wikipedia's 35 AI-writing patterns
  • Preserves meaning without inventing names, numbers, or citations
  • File mode changes prose while preserving code and data
  • Matches rhythm and word choice from a writing sample
  • Repository metadata lists 0 contributors and 0 releases

🔧 Engineering

  • Checks drafts and original factual claims against 35 patterns
  • Processes pasted text or file paths through /humanizer
  • File rewriting preserves code, frontmatter, and link targets
  • Matches a personal voice from a 2-3 paragraph sample

⚠️ Risks

  • It requires an agent supporting skills, but compatibility is unspecified
  • With 0 contributors and 0 releases, maintenance continuity is unknown
  • Missing facts are not invented and must come from the source or writer

👥 For who?

  • Agent users with Skills CLI can install it directly
  • Markdown authors who need to remove AI-sounding prose
  • Claude Code 2.1.142+ users can install the plugin