writing-skills

Test-driven skill documentation applies baseline tests and validation refactors to skill creation, ensuring consistent guidance before deployment across agent environments. It standardizes the process of documenting and codifying proven skills.

To create a new skill, add a SKILL.md file with a proper YAML frontmatter containing the name and description, followed by a concise Markdown guide that follows the template. This structure standardizes skill creation and editing.

YAML frontmatter improves skill discovery by providing clear, standardized metadata for name and description. This structured format enables consistent content organization and easier discovery across projects and teams.

Yes, this skill documentation approach is designed for validation across agent environments. It provides guidance on validating skills with baseline tests and refactors to ensure consistent behavior across projects and teams.

Standardized process documentation requires strict adherence to a YAML frontmatter and Markdown guide template. This basic implementation depth focuses on structure and validation, meaning complex reasoning or advanced internal design is not automatically generated.

Baseline tests for writing skills are needed to verify that the documented skill patterns provide consistent guidance before deployment. They ensure the quality assurance and validation of skills across different agent environments and refactors.