Overview
Humanizer is a Markdown skill you install into a coding agent and call with `/humanizer`. It takes a draft that reads as machine-written and rewrites it so it reads as though a person wrote it, while keeping every claim in the original. The project's stated premise is that a language model writes whatever fits the widest range of readers, and that this averaging is what produces the recognisable register — so the fix is a named checklist applied after the draft, not another instruction to the model that produced it.
The checklist is the substance of the tool. Twenty-five patterns are grouped into five sections, ordered by how strongly each one signals machine authorship: staging instead of stating (contrast constructions, one-line closers, artificial run-ups, strawmen), rhythm by rule (forced triads, repeated openings, dash overuse, stacked qualifiers, passive voice), inflation and borrowed authority (overused vocabulary, exaggerated importance, vague associations, sales language), formatting by rule (decorative bold, fancy headings, curly quotes) and leftovers (chatbot wrappers, knowledge disclaimers, repeated headings). The first five patterns justify an edit on their own; the rest have to appear more than once before the skill acts.
Running the skill is a loop rather than a single pass: it marks what it finds, drafts a rewrite without treating the original structure as fixed, validates the result against the same list, then produces the final text. Supplying two or three paragraphs of your own writing first makes it match your voice instead of a generic plain register. Humanizer is MIT-licensed, installs through the Skills CLI, the Claude Code plugin marketplace or a ZIP upload in Claude Desktop, and its README is explicit that the skill does not invent content while rewriting.
What it does
- `/humanizer` slash command that rewrites pasted text, a whole file, or the draft you name in plain language
- A fixed list of 25 AI-writing patterns in five sections, ordered by how strongly each signals machine authorship
- Tiered severity: the top five patterns justify an edit alone; the remaining twenty need repeat occurrences
- Voice matching — give it two or three paragraphs of your own writing and the rewrite follows your style
- Mark, draft, validate, finalise loop, so the rewrite is checked against the same list that produced it
- Installs through the Skills CLI, the Claude Code plugin marketplace, or as a ZIP upload in Claude Desktop
- A repository validator derives the pattern count from the headings and caps the skill file at 400 lines
Getting started
Humanizer is a skill, not a service — there is nothing to run or host. Install it into an agent that supports skills, then call it on a draft.
Install with the Skills CLI
The Skills CLI installs the skill globally, so any project can call it.
npx skills add blader/humanizer --globalOr install as a Claude Code plugin
On Claude Code 2.1.142 and newer, add the repository as a plugin marketplace and install from it. In Claude Desktop, download the repository as a ZIP and upload it as a skill instead.
/plugin marketplace add blader/humanizer
/plugin install humanizer@humanizerRewrite a draft
Call the skill directly and paste your text, ask for it in plain language, or point it at a file in the repository.
/humanizer
Please humanize this text: <your draft>
Humanize the prose in docs/launch-post.mdMatch your own voice
Paste two or three paragraphs of your own writing before the text you want rewritten, and the output follows your style rather than a generic plain register.
Here are 3 paragraphs I wrote: <samples>
Now humanize this draft in that voice: <your draft>Commands and code are distilled from the project's own documentation — always check the official repo for the latest.
When to use it
- Clean up a blog post, changelog or README that an agent drafted before it is published
- Give a team one shared, versioned definition of what "sounds like AI wrote it" instead of per-reviewer taste
- Rewrite agent output in your own voice by seeding the skill with a few samples of your writing
- Read the pattern list as a style reference — it names the habits rather than only removing them
How Humanizer compares
Humanizer alongside other open-source agent skills & plugins tools AI/TLDR tracks, ranked by GitHub stars.
| Tool | Stars | What it does |
|---|---|---|
| Superpowers | ★ 283k | A composable skills plugin that installs a spec-first, TDD, subagent-driven development methodology into Claude Code, Codex, Cursor, Gemini CLI and other coding harnesses. |
| ECC | ★ 252k | An installable plugin that adds 68 agents, 286 skills, hooks, rules, memory and an agent-config security scanner to Claude Code, Codex and other coding harnesses. |
| NoBuzz | ★ 254 | A Claude Code skill (/debuzz) that pipes Claude's last reply through the Antigravity CLI and prints back a plain-English version in one of three audience modes. |
| AREX-Skill | ★ 219 | A library of 5,000+ executable Agent Skills distilled from 1,000+ ML repositories, plus the DisCo CLI that distils a repository into skills and a router that narrows them to one branch. |
| Portal AI Plugins | ★ 216 | Spotify's plugin marketplace that brings Portal's software catalog, docs search and actions into Claude Code, Codex and Cursor, plus shunt, which routes bulk file reads to a cheaper model. |
| Vomit | ★ 191 | A Go CLI that hooks into Claude Code and pipes each reply through a local LLM, so the agent's output is rewritten in plainer language before it reaches the terminal. |
| Humanizer | — | An agent skill that rewrites AI-sounding prose against 25 named writing patterns, without changing the claims |