Writing Skills

Overview

Writing skills IS Test-Driven Development applied to process documentation.

Skills use a 3-tier progressive disclosure model:

1. Frontmatter (always loaded, ~30 tokens) -- name + description only
2. SKILL.md body (loaded on trigger, <=150 lines) -- Quick Start, core principles, reference table
3. references/ (loaded on demand, unlimited) -- detailed guides, examples, checklists

This skill demonstrates the pattern it teaches: core workflow here, deep detail in references/.

REQUIRED: superpowers-bd:test-driven-development, superpowers-bd:rule-of-five-plans

Quick Start

1. Confirm need -- Is this a repeated failure pattern? (Not one-off, not project-specific, not already documented)
2. Set up -- skills/skill-name/SKILL.md + references/ directory if content exceeds <=150 line budget