What problem does it solve?
Creates or updates skills with proper YAML frontmatter, progressive disclosure, and best practices per the open Agent Skills specification. Supports simple, tool-restricted, multi-file, and script-based skills. Use when creating new skills, authoring skills, extending agent capabilities, or when --create-skill or --new-skill flag is mentioned.
Core Features & Use Cases
- Templates supported: from
templates/:
simple-skill.md - Single SKILL.md file
tool-restricted-skill.md - Limited tool access
multi-file-skill.md - With supporting files
script-based-skill.md - Includes executable scripts
- Name pattern: kebab-case and must match directory
- Frontmatter validation: name, description, and optional fields
- Supporting files: Add
references/, scripts/, or assets/ when needed
- Progressive disclosure: keep SKILL.md lean; move details to supporting files
- Validation aids: ensures compatibility with Agent Skills specification
Quick Start
- Pick a template from
templates/ (e.g., simple-skill.md).
- Generate the skill directory name (lowercase, hyphens only) and ensure it matches
name in frontmatter.
- Write
SKILL.md with frontmatter and instructions.
- Optionally add
references/, scripts/, or assets/ to extend capabilities.