skill-creator

Agent skills require a SKILL.md file with mandatory frontmatter for name and description. Use the Skill Initializer script to scaffold the directory structure, ensuring frontmatter validation and standardized packaging into a deployable .skill file.

The standard packaging structure for agent skills includes a SKILL.md file and optional resource directories: scripts/ for reusable tooling, references/ for documentation, and assets/ for templates. This organization enables reproducible deployment as a .skill file.

Frontmatter validation is enforced during skill creation, checking the SKILL.md file to ensure mandatory name and description fields are present and correctly structured. This validation occurs before packaging the resources into a final .skill file.

To initialize an agent skill scaffold, execute the command `uv run scripts/init_skill.py <skill-name> --path <output-directory>`. This generates the foundational directory structure and required SKILL.md file for immediate skill development.

Yes, you can include external scripts and references when packaging agent skills. The structure supports optional bundles such as scripts/ for reusable tooling, references/ for documentation, and assets/ for templates within the final .skill package.

When updating existing agent skills, you must maintain strict frontmatter validation and adhere to structured description guidelines. Changes to scripts, references, or assets must preserve the standardized directory organization to ensure reproducible deployment.