create-skill

To create a Claude skill using test-driven development, you follow the RED-GREEN-REFACTOR cycle: write minimal tests first, implement the skill logic to pass those tests, then refactor while maintaining required frontmatter and documentation gates.

Required frontmatter for a SKILL.md file includes mandatory name and description fields at the top. This structure ensures Claude Search Optimization by enabling proper auto-discovery and triggering of the skill.

To ensure documentation stays synced during skill creation, you must update all six mandatory gate files before completion. This documentation-sync enforcement guarantees consistent quality and activatability across the workflow.

The best way to structure a new skill directory is to create a dedicated folder, add a SKILL.md file with required frontmatter, implement a minimal test, and follow the RED-GREEN-REFACTOR cycle to complete the skill skeleton.

Yes, Claude skill creation requires writing tests before implementation. The test-first workflow guidance mandates establishing RED-GREEN-REFACTOR steps and associated tests to ensure consistent quality before the skill logic is built.

A Claude skill may fail to trigger automatically if the SKILL.md description lacks Claude Search Optimization. Crafting the description with proper frontmatter and keywords ensures the skill is discoverable and activatable.