Humanize Docs

Overview

This skill transforms robotic AI-generated documentation into prose that sounds like an actual human wrote it. Think: destroying checkbox spam, dismantling perfect paragraph structures, and injecting the kind of conversational flow you'd get from a colleague explaining something over coffee.

The approach is aggressive deformalization - not just tweaking tone, but fundamentally restructuring how information flows to break AI's predictable patterns.

When You Need This

Clear signals you're dealing with AI-generated docs:

• Checkbox overload: - [x] Task 1: Do the thing (AC: #1)
• CAPS LOCK emphasis for CRITICAL IMPORTANT NOTES
• 8+ code templates embedded in a single document
• Every section has exactly 3 perfectly balanced paragraphs
• Headers like "LLM Developer Guardrails" (literally instructions for robots)
• Phrases: "Certainly, here is...", "It's important to note that...", "Furthermore..."

Examples from the wild: