master-humanizer

A disciplined editorial skill for Claude Code. Removes generic model residue from drafts while preserving meaning, factual claims, citations, code, and authorial voice.

This skill is not a detector-evasion tool.

Synthesized from concepts in eleven open humanizer projects (blader/humanizer, Aboudjem/humanizer-skill, jpeggdev/humanize-writing, gabelul/slopbuster, 199-biotechnologies/humanise-text-skill, glebis/claude-skills, devswha/patina, Byk3y/no-slop, lguz/humanize-writing-skill, apoapostolov/humanizer, brandonwise/humanizer). See SOURCE_REVIEW.md for the per-repo concept map.

Multilingual: the skill is written for English but is language-agnostic in structure. It will operate on other languages best-effort; language-specific pattern packs are not yet shipped.

Install

macOS / Linux

chmod +x master-humanizer/scripts/install.sh
bash master-humanizer/scripts/install.sh

Windows (PowerShell)

.\master-humanizer\scripts\install.ps1

The installer validates the bundle, removes any prior install at ~/.claude/skills/master-humanizer, and copies the skill into place.

Validate

python3 master-humanizer/scripts/validate_skill.py

Exits 0 on PASS.

Use

Invoke from Claude Code by referencing the skill in a prompt. Example:

Use the master-humanizer skill in professional mode. Rewrite this so it sounds authored, direct, and non-generic while preserving all facts:

<paste text>

Other modes:

• diagnose — return only an analysis of AI-tells; do not rewrite
• rewrite — produce edited prose
• voice-match — infer the author's voice from a sample, then rewrite a target
• audit — run the audit checklist on the user's own rewrite

Genre modes: professional, academic, email, mba_applications, technical, casual.

Test

Use examples/test_input.md with the prompt above. Compare against examples/test_output.md as a reference rewrite.

Share with someone else

After install, generate a portable zip:

bash master-humanizer/scripts/zip_skill.sh

This produces /Users/aliha/personal/master-humanizer.zip (or, if run from elsewhere, a zip alongside the skill folder). The recipient unzips it and runs the same scripts/install.sh (macOS/Linux) or scripts/install.ps1 (Windows) to install into their own ~/.claude/skills/.

Layout

master-humanizer/
  SKILL.md               -- self-contained skill definition
  README.md              -- this file
  SOURCE_REVIEW.md       -- what was synthesized and what was discarded
  patterns/              -- diagnostic taxonomy
  modes/                 -- per-genre rewrite rules
  workflows/             -- step-by-step procedures
  examples/              -- before/after, test pair
  scripts/               -- install + validate

SKILL.md is self-contained; the other files are supplementary references.