create-skill
Installation
SKILL.md
Create Skill
This skill guides the creation of effective skills. Authoring guidance is split across the reference files below. Read the ones the current step needs rather than all of them.
| Reference | Covers |
|---|---|
| references/principles.md | Conciseness, instructions-not-documentation, degrees of freedom |
| references/structure.md | Frontmatter, naming, descriptions, progressive disclosure, file layout |
| references/writing.md | Prose rules: terminology, phrasing, conditions, thresholds |
| references/workflows.md | Step/phase structure, feedback loops, exit signals, output patterns |
| references/composition.md | Depending on, invoking, and fanning out to other skills |
| references/tools.md | spawn_agent, request_user_input, and MCP tool invocation |
| references/evaluation.md | Evaluations and iterating on a skill from observed behavior |
| references/scripts.md | Skills that bundle executable code |
| references/harness.md | Harness tool names, sandbox and approval modes, sub-agent limits, and discovery paths |
Step 1: Understanding the Skill with Concrete Examples
Skip this step only when the skill's usage patterns are already clearly understood. It remains valuable even when working with an existing skill.