Writing Skills

Test-driven documentation applies the RED-GREEN-REFACTOR cycle to skill guides to surface failure modes and close gaps. By running baseline pressure scenarios with subagents, you document rationalizations and ensure robust guidance before deployment.

To verify documentation resists regression, use baseline and pressure testing with subagents. This process surfaces how agents behave without the skill, allowing you to draft structured guidance and re-run tests to verify compliance.

Formatting a SKILL.md file requires YAML frontmatter with name and description fields. The structured body must outline core principles, patterns, and examples, including references to heavy reference materials when needed.

Pressure testing with subagents is needed when creating, editing, or verifying skills before deployment. It surfaces baseline failures by documenting rationalizations, ensuring your process documentation is reliable and reusable under change.

Yes, test-driven writing is used when creating, editing, or verifying skills. Applying the RED-GREEN-REFACTOR cycle to existing documentation surfaces failure modes and closes gaps, ensuring updated guides remain bulletproof.

Skill documentation fails under pressure scenarios when gaps in the guidance allow agents to rationalize incorrect behavior. Running baseline tests before drafting exposes these failures, enabling you to refine the structured body and verify compliance.