name	description
create-skill	Create and validate skills. USE WHEN user asks to create a new skill, validate skill structure, or canonicalize an existing skill. See skill-system.md for full spec.

Create Skill

Create and validate skills following the canonical skill structure.

Skill Structure

skills/
└── skill-name/           # kebab-case
    ├── SKILL.md          # Required - main skill definition
    ├── Workflows/        # Optional - only if skill has sub-workflows
    │   └── workflow.md
    └── tools/            # Optional - scripts invoked by the skill
        └── tool.ts       # TypeScript (run with bun), Python, etc.

SKILL.md Format

---
name: skill-name
description: What it does. USE WHEN [trigger phrases]. Key capabilities.
allowed-tools:            # Optional - restrict tool access
  - Read(path/**)
  - Bash
---

# Skill Title

Brief description of what this skill does.

## Workflow Routing       # ONLY if Workflows/ directory exists

| Trigger | Workflow |
|---------|----------|
| "do X"  | [[Workflows/x.md]] |

## Examples

**Example 1: Description**
User: "example prompt"
→ Expected action/output

## Notes

Additional context, prerequisites, tips.

Key Rules

1. name: kebab-case, matches folder name
2. description: Single line with USE WHEN clause - this is what Claude uses for skill routing
3. Workflow Routing: Only include if Workflows/*.md files exist
4. Examples: 2-3 concrete examples showing trigger → action

Validation Checklist

• Folder name is kebab-case
• SKILL.md has valid YAML frontmatter
• description includes USE WHEN clause
• Examples section with 2-3 patterns
• Workflow Routing only present if Workflows/ exists
• No orphan workflow files (all must be routed)

Examples

Example 1: Create a new skill

User: "create a skill for managing git worktrees" → Create skills/git-worktree/SKILL.md with proper structure

Example 2: Validate existing skill

User: "check if my summarize skill is structured correctly" → Read skill, validate against checklist, report issues

Example 3: Canonicalize a skill

User: "my skill works but might not follow best practices" → Review structure, suggest/apply fixes to match canonical format