humanize-docs

# Humanize Docs Transforms robotic AI-generated documentation into prose that sounds like an actual human wrote it. The approach is **aggressive deformalization** — not just tweaking tone, but restructuring how information flows to break AI's predictable patterns. This is a different tool than the humanizer skill. Humanizer removes AI writing tells at the sentence/phrase level (em-dashes, rule-of-three, vague attributions, sycophantic openers). Humanize-docs attacks structural AI-ness: checkbox spam, template overload, perfect symmetry, emotional flatness across an entire document. ## When to use this Clear signals you're dealing with AI-generated docs: - Checkbox overload: `- [x] Task 1: Do the thing (AC: #1)` - CAPS LOCK for CRITICAL IMPORTANT NOTES - 8+ code templates embedded in one document - Every section has exactly 3 perfectly balanced paragraphs - Headers like "LLM Developer Guardrails" - Phrases: "Certainly, here is...", "It's important to note that...", "Furthermore..." ## Transformation workflow ### Step 1: Detect Quick test — does the doc have 5+ of these? - Perfect structural symmetry (every section same length) - Zero sentence length variation (all 15-20 words) - Checkbox addiction - Template embedding mania - Emotional flatness (no "wait, why?" or "honestly...") If yes, proceed. If no, it might already be human-written — don't over-transform. ### Step 2: Apply the five core transformations Execute in order. Don't apply all of them everywhere — humans...