create-skill

Scaffolding a new agent skill requires generating a SKILL.md file with YAML frontmatter containing the required name and description, alongside a structured body. This establishes a consistent directory layout with optional references/, scripts/, and assets/ folders.

The required frontmatter for a SKILL.md file must include the skill name and description properties. This metadata satisfies the Skill Unit definition and is automatically generated when creating a new skill scaffold.

Formalizing an existing workflow into a structured skill involves applying a standard scaffold template to your process. This generates a review-ready SKILL.md document with frontmatter and optional resource directories to ensure project consistency.

Organizing resources when building agent skills uses a standard folder layout separating references, scripts, and assets into distinct directories. This structure guides progressive disclosure, keeping the main SKILL.md clean while supporting necessary files.

You do not need to manually create the workspace setup for a new skill. The scaffolding process automatically proposes the standard folder layout and generates the required SKILL.md frontmatter, eliminating manual setup errors.

You can include optional scripts and assets in your skill scaffold by utilizing the generated resource directories. The template supports adding these folders as needed, ensuring flexible progressive disclosure without cluttering the core SKILL.md.