$git clone https://github.com/blader/humanizerA portable agent skill that removes signs of AI-generated writing from text, making it sound more natural and human. It is plain Markdown, so it can run in any harness that supports skill-style instructions.
| 1 | # Humanizer |
| 2 | |
| 3 | [](https://skills.sh/blader/humanizer) |
| 4 | |
| 5 | A portable agent skill that removes signs of AI-generated writing from text, making it sound more natural and human. It is plain Markdown, so it can run in any harness that supports skill-style instructions. |
| 6 | |
| 7 | ## Installation |
| 8 | |
| 9 | ### Skills CLI |
| 10 | |
| 11 | Install globally with the cross-agent skills CLI so Humanizer is available in every project: |
| 12 | |
| 13 | ```bash |
| 14 | npx skills add blader/humanizer --global |
| 15 | ``` |
| 16 | |
| 17 | Update an existing install: |
| 18 | |
| 19 | ```bash |
| 20 | npx skills update humanizer --global |
| 21 | ``` |
| 22 | |
| 23 | To install globally into every supported agent harness: |
| 24 | |
| 25 | ```bash |
| 26 | npx skills add blader/humanizer --global --agent '*' |
| 27 | ``` |
| 28 | |
| 29 | To target one configured harness, pass its agent name: |
| 30 | |
| 31 | ```bash |
| 32 | npx skills add blader/humanizer --global --agent <agent-name> |
| 33 | ``` |
| 34 | |
| 35 | Omit `--global` for a project-local install that can be committed and shared with collaborators. Start a new agent session or reload skills after installation. |
| 36 | |
| 37 | ### Claude Code plugin |
| 38 | |
| 39 | Claude Code users can also install Humanizer as a plugin: |
| 40 | |
| 41 | ``` |
| 42 | /plugin marketplace add blader/humanizer |
| 43 | /plugin install humanizer@humanizer |
| 44 | ``` |
| 45 | |
| 46 | The skill is then invoked as `/humanizer:humanizer`. |
| 47 | |
| 48 | ### Manual |
| 49 | |
| 50 | Any agent harness can use the skill directly because the runtime artifact is `SKILL.md`. Install it wherever your harness expects skill directories, or copy `SKILL.md` into an existing skill folder. |
| 51 | |
| 52 | For example: |
| 53 | |
| 54 | ```bash |
| 55 | git clone https://github.com/blader/humanizer.git /path/to/your/skills/humanizer |
| 56 | ``` |
| 57 | |
| 58 | Or, if you already have this repo cloned: |
| 59 | |
| 60 | ```bash |
| 61 | mkdir -p /path/to/your/skills/humanizer |
| 62 | cp SKILL.md /path/to/your/skills/humanizer/ |
| 63 | ``` |
| 64 | |
| 65 | ## Usage |
| 66 | |
| 67 | Invoke the skill however your agent harness exposes installed skills. Common forms include a slash command or a direct request: |
| 68 | |
| 69 | ``` |
| 70 | /humanizer |
| 71 | |
| 72 | [paste your text here] |
| 73 | ``` |
| 74 | |
| 75 | ``` |
| 76 | Please humanize this text: [your text] |
| 77 | ``` |
| 78 | |
| 79 | Point it at a file and the skill rewrites it in place: |
| 80 | |
| 81 | ``` |
| 82 | Humanize the prose in docs/launch-post.md |
| 83 | ``` |
| 84 | |
| 85 | ### Voice Calibration |
| 86 | |
| 87 | To match your personal writing style, provide a sample of your own writing: |
| 88 | |
| 89 | ``` |
| 90 | /humanizer |
| 91 | |
| 92 | Here's a sample of my writing for voice matching: |
| 93 | [paste 2-3 paragraphs of your own writing] |
| 94 | |
| 95 | Now humanize this text: |
| 96 | [paste AI text to humanize] |
| 97 | ``` |
| 98 | |
| 99 | The skill will analyze your sentence rhythm, word choices, and quirks, then apply them to the rewrite instead of producing generic "clean" output. |
| 100 | |
| 101 | ## Overview |
| 102 | |
| 103 | Based on [Wikipedia's "Signs of AI writing"](https://en.wikipedia.org/wiki/Wikipedia:Signs_of_AI_writing) guide, maintained by WikiProject AI Cleanup. This comprehensive guide comes from observations of thousands of instances of AI-generated text. |
| 104 | |
| 105 | The skill also includes a final "obviously AI generated" audit pass and a second rewrite, to catch lingering AI-isms in the first draft. |
| 106 | |
| 107 | Rewrites follow a no-fabrication rule: they never add facts, names, dates, or citations that aren't in the source text. Specificity has to come from the source or the author, not from the rewrite. |
| 108 | |
| 109 | ### Key Insight from Wikipedia |
| 110 | |
| 111 | > "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." |
| 112 | |
| 113 | ## 33 Patterns Detected (with Before/After Examples) |
| 114 | |
| 115 | ### Content Patterns |
| 116 | |
| 117 | | # | Pattern | Before | After | |
| 118 | |---|---------|--------|-------| |
| 119 | | 1 | **Significance inflation** | "marking a pivotal moment in the evolution of..." | "was established in 1989 as part of a wider decentralization" | |
| 120 | | 2 | **Notability name-dropping** | "cited in NYT, BBC, FT, and The Hindu" | Trim the list; keep only sourced context | |
| 121 | | 3 | **Superficial -ing analyses** | "symbolizing... reflecting... showcasing..." | Remove, or keep only what the source supports | |
| 122 | | 4 | **Promotional language** | "nestled within the breathtaking region" | "is a town in the Gonder region" | |
| 123 | | 5 | **Vague attributions** | "Experts believe it plays a crucial role" | Name a real source or cut the |