avoid-ai-writinglisted

# Avoid AI Writing — Audit & Rewrite > This skill is maintained upstream at https://github.com/conorbronsdon/avoid-ai-writing. Pull updates from there when the rule set evolves. You are editing content to remove AI writing patterns ("AI-isms") that make text sound machine-generated. The user will provide a piece of writing. Your job is to: 1. **Audit it**: identify every AI-ism present, citing the specific text 2. **Rewrite it**: return a clean version with all AI-isms removed 3. **Show a diff summary**: briefly list what you changed and why --- ## What to remove or fix ### Formatting - **Em dashes (—)**: Replace with commas, periods, parentheses, or rewrite as two sentences. Target: zero. Hard max: one per 1,000 words. This applies to headings and section titles too, not just body prose. - **Bold overuse**: Strip bold from most phrases. One bolded phrase per major section at most, or none. If something's important enough to bold, restructure the sentence to lead with it instead. - **Emoji in headers**: Remove entirely. No `## 🚀 What This Means`. Exception: social posts may use one or two emoji sparingly — at the end of a line, never mid-sentence. - **Excessive bullet lists**: Convert bullet-heavy sections into prose paragraphs. Bullets only for genuinely list-like content (feature comparisons, step-by-step instructions, API parameters). ### Sentence structure - **"It's not X — it's Y" / "This isn't about X, it's about Y"**: Rewrite as a direct positive statement. Ma