Writing Skills

This is a meta-skill for building skills themselves using test-driven development principles. You write pressure scenarios with subagents, watch them fail without the skill (establishing baseline behavior), write the documentation, then verify they follow the rules. The core insight is that if you haven't observed an agent failing without your skill, you don't know if you're teaching the right thing. It maps TDD concepts directly to documentation: test cases become stress scenarios, production code becomes SKILL.md, and refactoring means plugging loopholes in agent rationalization. Includes detailed guidance on frontmatter structure, Claude Search Optimization (never summarize workflow in descriptions), token efficiency tactics, and when to use flowcharts versus tables. The iron rule matches TDD: no skill without a failing test first, no exceptions.