Writing Skills

Overview

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

You write test cases (pressure scenarios with subagents), watch them fail (baseline behavior), write the skill (documentation), watch tests pass (agents comply), and refactor (close loopholes).

Core principle: If you didn't watch an agent fail without the skill, you don't know if the skill teaches the right thing.

This skill is meta. Use it when:

• Creating a new skill
• Editing an existing skill that's not working as expected
• Noticing a repeated/abstractable workflow in your project that should be a skill — this is the "extract patterns into reusable skills" use case

When to Use