writing-skills

To structure SKILL.md documentation for reliable discovery, include required frontmatter fields like name and description, then follow the enforced SKILL.md structure to maintain consistency across the skill library.

Test-driven development for writing Claude skills is a structured framework applying RED-GREEN-REFACTOR iterations to skill creation, tracking risks and rationalizations to ensure robust deployment and prevent errors.

To validate a skill before deployment, apply the provided testing guidance to check frontmatter completeness, enforce SKILL.md structure, and review red flags to ensure quality assurance across the writing-skills family.

Yes, this skill writing workflow supports editing existing skills by applying test-driven validation steps to refine SKILL.md files, ensuring updated documentation maintains structural consistency and passes quality checks.

The best way to ensure quality assurance when creating new skills is using evidence-based templates and patterns, iterating with RED-GREEN-REFACTOR cycles, and validating structure before deployment.