Skill Creator

---
name: skill-creator
description: |
  Meta-skill for creating new SKILL.md files. Trigger when the user wants to
  create, write, or scaffold a new skill. Phrases: "create a skill", "new skill",
  "write a SKILL.md", "scaffold skill", "build a skill".
allowed-tools:
  - Read
  - Write
  - Edit
  - Glob
  - Grep
---

# Skill Creator

Guided workflow for building well-structured SKILL.md files that work with
Claude Code, Cursor, Codex, and other AI harnesses.

## Skill file anatomy

```markdown
---
name: my-skill
description: |
  When to trigger this skill. Be specific about phrases and contexts.
  This is what the harness reads to decide when to activate.
allowed-tools:
  - Bash(specific commands *)
  - Read
  - Write
  - Edit
---

# Skill Title

One paragraph explaining what this skill does.

## Steps

1. Step-by-step instructions the AI should follow
2. Each step should be actionable and specific
3. Include example commands where relevant

## Rules

- Constraints and guardrails
- Quality bars and conventions to follow
```

## Workflow

1. **Ask** what the skill should do and when it should trigger
2. **Draft** the frontmatter with precise trigger phrases
3. **Write** clear, step-by-step instructions
4. **Scope** the allowed-tools to minimum necessary
5. **Test** by invoking the trigger phrases

## Best practices

- Keep descriptions under 3 lines - they are matched against user input
- Be specific about trigger phrases (not "when coding" but "when writing tests")
- Limit allowed-tools to what the skill actually needs
- Include example commands and expected outputs
- Add a "Rules" section for guardrails

## Example usage

- "Create a skill for writing database migrations"
- "Build a SKILL.md that handles PR descriptions"
- "Scaffold a code review skill"