markdown-doc-surgeon

Rebalance and tighten markdown documentation that has grown unwieldy. Compresses bloated edge-case sections, verbose code examples, and lengthy DO/DON'T addendums back into proportion with core content — without losing information. Works on READMEs, system prompts, agent skills, API docs, and any markdown reference material. Activate on 'clean up docs', 'tighten documentation', 'rebalance markdown', 'compress docs', 'documentation cleanup', 'doc is too long', 'simplify docs'. NOT for: writing new documentation from scratch (use skill-writer), copyediting prose style, or converting between formats.