build-skill

To create and maintain skills with consistent directory structures, you can use a template-driven scaffolding approach that auto-generates agent and reference skeletons from a standard Skill template. This enforces a SKILL.md frontmatter and organizes associated assets within the .claude/skills ecosystem.

A SKILL.md frontmatter is a required configuration file containing a name and description, essential for defining a valid Skill Unit. You need it when building or updating skills to ensure standardization and proper alignment with defined templates across the repository.

Skill scaffolding does not require optional references and scripts folders. While a valid SKILL.md with name and description is required, the references, scripts, and assets folders are optional, allowing flexibility in organizing associated agents and references.

Yes, you can use YAML templates to standardize agent and reference files. The scaffolding process applies template-driven generation to auto-create agent and reference skeletons, ensuring consistency and enabling team members to track changes collaboratively.

The best way to organize skills within the .claude/skills ecosystem is to enforce a standard directory structure using a SKILL.md file. This blueprint structures frontmatter, templates, and optional references, ensuring consistent skill unit creation and maintenance.