humanize

/idiolect:humanize — from slop to person

Two modes. Both end with before/after scanner scores, because "sounds better to me" is not a receipt.

Voice references can be fuzzy and human ("make it sound like the diner guy", "like me" → the self voice): resolve against $IDIO voices --json and proceed, mentioning the match in passing. No voice mentioned → Mode A.

Setup

ROOT="${CLAUDE_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-$IDIOLECT_ROOT}}"
# unset everywhere (opencode)? ROOT = two directories up from this SKILL.md
IDIO="python3 $ROOT/scripts/idiolect.py"

Input text goes to a scratch file via the Write tool, never inline in shell.

Mode A — scrub and soul (no voice given)

The goal is the same author, minus the generator fingerprints, plus a pulse.

1. Save input to orig.txt; run $IDIO scan --file orig.txt [--platform <p>]. Show the user the score and the top tells found — this is the "before" receipt and it teaches them what was wrong.
2. Rewrite with three obligations:
   • Kill every flagged tell (the report gives line numbers): the lexical slop, the constructions ("It's not X. It's Y."), the metronomic sentence lengths, the wrap-up ending, the bold-header bullets.
   • Preserve every factual claim exactly. Scrubbing is not summarizing; if the original has five specifics, the rewrite has five specifics. NEVER add facts that aren't in the original — if it's thin on specifics, tell the user that's the real problem (specificity is the strongest human signal there is) and ask for two or three true details worth adding.
   • Restore a pulse: vary sentence lengths (target CV ≥ 0.55), let one opinion or ambivalence through, cut the throat-clearing, end without a bow. Register stays the author's own — formal text stays formal; don't inflict aggressive casualness (that's the "humanizer house style," and it's the next tell).
3. Re-scan the rewrite. Target ≤ 15 (≤ 20 for formal registers). Iterate to 3 times.
4. Deliver: rewrite in a fenced block + receipt: 68 → 9 (clean) + one line on the biggest change.

Mode B — re-voice (voice slug given)

The text's CONTENT survives; its author is replaced.

1. Scan the original (before-receipt), then read the voice profile in full, plus _shared/craft.md and the platform row of _shared/platforms.md if a platform is stated.
2. Rewrite as that person would have written it from scratch: their opener habits, their syntax, their systematic flaws, their stance where the content touches something they'd have an opinion about. Facts and commitments from the original are preserved; framing, rhythm, and lexicon are theirs.
3. Verify: $IDIO scan (≤ 15) AND $IDIO conform --voice <slug> (PASS). Iterate to 3.
4. Deliver with both receipts and, if invented interior texture crept in, the texture: line.

What this skill refuses to do

• Manufacture fake specifics to lower the score (invented numbers are worse than slop — they're lies).
• "Humanize" text for deception-sensitive contexts when the user says so explicitly (academic submissions, legal filings). Say why and offer honest editing instead.
• Chase detector scores. The target is reads like a person wrote it, which is measured by the linter and your ear together — when they disagree, say so and let the ear win.