write-a-skill

Automating agent skill scaffolding generates a complete directory skeleton with SKILL.md, REFERENCE.md, and scripts, while enforcing YAML frontmatter validation for name and description fields. This ensures well-formed, consistent skill units ready for review.

Creating consistent skill templates requires a reusable blueprint system that auto-generates standardized directory structures and sectioned descriptions. This reduces setup time and onboarding friction by promoting standard structures for skill development.

YAML frontmatter validation checks for the mandatory presence of name and description fields in the SKILL.md file. It enforces concise content standards and runs toxicity analysis to ensure safe, well-formed skill units.

Including optional references and scripts is supported through progressive disclosure. You can add resources, assets, and scripts on demand to the auto-generated skill skeleton, allowing flexible skill generation.

Skill scaffolding works without external dependencies. It directly automates the creation of structured skill units from SKILL.md definitions, applying component detection and frontmatter validation internally.

Using a scaffolding blueprint ensures consistent conventions, automatic component detection, and toxicity analysis across all new skills. Manual creation lacks enforced YAML validation and standard directory structures, increasing onboarding friction.