create-skill

To scaffold a new skill directory with multi-YAML files, provide a folder name, title, and description to automatically generate SKILL.md, skill.yaml, sharp-edges.yaml, validations.yaml, and collaboration.yaml.

The multi-YAML pattern structures skill capabilities across separate YAML files for metadata, validations, and collaboration rules. It is needed when adding new capabilities to ensure proper configuration and best practices from the outset.

Generating skill files enforces specific naming conventions for directories and ensures critical hooks like the Stop hook are correctly configured to maintain structural integrity across the generated YAML files.

No dependencies are required to automate skill directory creation. You only need to provide a folder name, title, and description to initialize the complete skill structure with canonical files.

Manual skill setup leads to structural errors by missing essential hook configurations or breaking naming conventions. Scaffolding prevents this by enforcing best practices and automatically generating the complete set of canonical files.

The create-skill scaffolder initializes new skill directories by generating foundational files. It requires a user-provided folder name, title, and description to set up the structure from scratch rather than updating existing projects.