writing-skills

Standardize skill documentation by enforcing a YAML frontmatter with required name and description fields, followed by a structured body template including Overview, When to Use, and Quick Start sections. This ensures every skill maintains a consistent format across your library.

The RED-GREEN-REFACTOR workflow is a test-driven development cycle used to validate and maintain skill documentation quality. It prevents regression when skills are updated by enforcing structured testing phases throughout the creation and editing process.

Create a new skill directory, add a SKILL.md file with required YAML frontmatter, fill in the prescribed body sections, and validate the skill by running the RED-GREEN-REFACTOR cycle to ensure test-driven quality and reusability.

Valid skill documentation requires YAML frontmatter at the top of the SKILL.md file containing at minimum the name and description fields. These mandatory fields ensure proper skill identification and standardized documentation structure.

Yes, the skill creation framework applies to both individuals and teams building a library of reusable skills. It standardizes documentation structure and enforces test-driven quality across projects regardless of team size.

Use a standardized framework when building a library of reusable skills across multiple projects to ensure consistent structure. It prevents documentation fragmentation and maintains quality through test-driven validation during updates.