Skip to content
Get packs

Guide · Open source

How to use Humanizer: rewrite AI text to sound human

Updated · written with AI from the project's own documentation and checked against our catalogue data

Humanizer is an agent skill that takes text written by an AI and rewrites it to remove common signs of machine writing, such as stock phrases, dramatic one-line closers and rigid formatting. It is built on Wikipedia's guide to signs of AI writing and works in Claude Code, Codex and other agents that support skills. This guide shows you how to install it, run it on your own text or files, and match the output to your voice.

Humanizerblader/humanizer · ★ 63.8k · MIT

Quick start

  1. 1Pick your agent. Choose Claude Code, Codex, Claude.ai or another agent that supports skills.
  2. 2Install the skill. Run the install command for your agent, such as the Codex Skills CLI command or the Claude Code plugin commands.
  3. 3Call /humanizer. Type /humanizer followed by your text, or ask in plain language to humanize it.
  4. 4Add a voice sample (optional). Paste two or three paragraphs of your own writing so the rewrite matches your rhythm and word choice.
  5. 5Review the output. Read the first rewrite, the critique and the final version, and check every name, number and date against your source.

Install Humanizer in your agent

Humanizer's install path depends on which agent you use. For Claude Code, add the plugin marketplace and install the plugin from inside Claude Code. The README says the plugin needs Claude Code 2.1.142 or newer; on older versions, use the Skills CLI instead.

For Codex, the Skills CLI installs Humanizer. The Skills CLI requires Node.js and npx. For Claude.ai and Claude Desktop, the README says to download the repository as a ZIP and upload it as a skill in Settings.

  • Claude Code: install via the plugin marketplace (needs 2.1.142 or newer)
  • Codex: use the Skills CLI command below
  • Claude.ai or Claude Desktop: download the ZIP and upload it in Settings
  • Other agents: use the Skills CLI with --agent '*', or copy SKILL.md into the agent's skill folder
npx skills add blader/humanizer --global --agent codex

Install for every supported agent

To install Humanizer for every agent the Skills CLI supports, run the command below. The README names Gemini CLI, GitHub Copilot and Windsurf as examples.

Leave off --global to install only in the current project. If your agent is not known to the Skills CLI, copy SKILL.md into its skill folder by hand.

npx skills add blader/humanizer --global --agent '*'

Run your first rewrite

Once installed, the skill answers to /humanizer. You can call it directly with your text, or ask in plain language. To rewrite a file, give Humanizer its path.

When you paste text, Humanizer shows the first rewrite, a short critique of anything that still sounds artificial, and the final version. When you point it at a file, it changes only the prose and leaves code, data, frontmatter and link targets alone.

  • Paste text after /humanizer to rewrite it
  • Ask in plain language, for example 'Please humanize this text'
  • Give a file path to rewrite the prose in that file
/humanizer [paste your text here]

Match the rewrite to your own voice

If you want the output to sound more like you, include a sample of your own writing with the text you want rewritten. The README says Humanizer follows the sample's rhythm, word choice, punctuation and deliberate quirks, including dashes if you use them.

Use two or three paragraphs of your writing as the sample. Personal writing keeps the writer's opinions and quirks, while technical and reference prose stays neutral and plain.

/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]

Know what Humanizer will and won't do

Humanizer changes style without changing what the text says. It does not make things up: a name, number, date, quote or citation must come from your source or from you. If a sentence needs a detail that is missing, Humanizer asks instead of inventing one.

The README is clear that Humanizer edits for human readers. It is not designed to get past AI detectors, and the README says detectors still flag most of its output. Check facts yourself before you publish.

  • It rewrites stock phrases, dramatic closers and rigid formatting
  • It does not add or verify facts
  • It is not a tool for evading AI detectors

What people use it for

  • Cleaning up a launch post or blog draft that an AI helped write
  • Tidying project documentation or README text for stiff, inflated phrasing
  • Rewriting a file in place with the prose changed and code left alone
  • Adjusting AI-drafted text to match your own sample writing

Frequently asked questions

Is Humanizer free?

Humanizer is released under the MIT licence, which the project lists. The README does not mention any paid tier, so check the licence file in the repository for the full terms.

What do I need to install Humanizer?

For Claude Code's plugin path you need Claude Code 2.1.142 or newer. For the Skills CLI commands, you need Node.js and npx. Older Claude Code versions can use npx skills instead.

Does Humanizer work with Codex?

Yes. The README gives the command npx skills add blader/humanizer --global --agent codex to install it for Codex.

Can Humanizer get my text past AI detectors?

No. The README says Humanizer is not designed to fool AI detectors and that detectors still flag most of its output. It is built to make text read naturally to people.

Does Humanizer check facts in my text?

No. It is meant to ask for missing details rather than invent them, and it does not add or verify facts. You should check names, numbers and dates yourself.

What is Humanizer based on?

Humanizer is built on Wikipedia's guide to signs of AI writing, which Wikipedia editors use to catch AI-generated text. It checks for 26 patterns in total.

New agent skills, repos and AI tools — every week

The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.

Our verdict

Humanizer suits writers who draft with an AI and want a more natural final text, developers using Claude Code or Codex who want a reusable cleanup step, and editors reviewing stiff docs or posts. If you need reliable AI-detector evasion, or you expect the tool to add or verify facts, pick something else, and if your agent does not support skills, expect to copy SKILL.md by hand.

Install options & downloads