writing-skills

Apply TDD to SKILL.md documentation by using a Red-Green-Refactor workflow to draft, test, and verify skill content before deployment. This enforces YAML frontmatter requirements and progressive-disclosure structure for safe, discoverable skills.

Progressive-disclosure structure is a documentation pattern that keeps SKILL.md concise upfront while allowing Claude to load detailed body sections on demand. You need it when authoring skills that require both discoverability and deep contextual guidance.

Set up quality assurance checks for skill authoring by defining governance gates that evaluate YAML frontmatter compliance, structural clarity, and test verification. These checks prevent untested, ambiguous, or poorly-organized skills from reaching deployment.

Yes, the skill authoring workflow supports testing patterns with subagents as part of its Red-Green-Refactor cycle. Subagents are used to verify skill behavior and enforce evaluation guidelines before a skill is considered deploy-ready.

The best way to structure YAML frontmatter for a reusable SKILL.md file is to enforce strict metadata requirements that ensure discoverability and safe deployment. This frontmatter drives the automated verification and governance checks across the skill lifecycle.

Skill documentation fails deployment readiness checks when it lacks required YAML frontmatter, violates progressive-disclosure structure, or misses evaluation guidelines. The governance process blocks untested, ambiguous, or poorly-organized skills from deployment.