writing-skills

Apply test-driven development principles to process documentation by observing baseline failures, writing a minimal skill, and refactoring to close loopholes. This RED-GREEN-REFACTOR cycle turns tacit patterns into repeatable guides that resist rationalizations.

A RED-GREEN-REFACTOR cycle for skill writing involves observing baseline failures, writing a minimal skill to address them, then refactoring the skill documentation to close loopholes and ensure performance under pressure.

Structure skill metadata using YAML frontmatter with name and description fields, a concise SKILL.md body, and optional directories for scripts, references, and assets to enable on-demand loading of tooling and references.

Yes, test-driven development applies to documentation by stressing baseline compliance and performance under pressure. It codifies reusable skill patterns across discipline-enforcing, technique, pattern, and reference skills for Claude agents.

Process documentation fails under pressure when it lacks explicit counters for common rationalizations. Applying TDD principles captures baseline failures and closes loopholes by refactoring skills to enforce discipline during stressful tasks.

Yes, the TDD-powered skill writing approach applies to discipline-enforcing, technique, pattern, and reference skills across Claude agents, ensuring all documentation types resist baseline failures and rationalizations.