---
name: skill-creator
description: Template and guide for creating new skills
---

# Skill Creator

Use this skill to create new skills.

## SKILL.md Template

```yaml
---
name: your-skill-name
description: When to use this skill
---

# Skill Name

Brief description of what this skill does.

## When to Use
- Situation 1
- Situation 2

## Instructions
Step-by-step guide Claude follows.

## Examples
Concrete usage examples.

## Guidelines
- Best practice 1
- Best practice 2
```

## Skill vs Mode Decision

| Create a... | When... |
|-------------|---------|
| **Mode** | Triggered by user intent (workflow) |
| **Skill** | Invoked explicitly for capability |

**Examples:**
- "init feature" → Mode (workflow triggered by intent)
- "use webapp-testing" → Skill (capability invoked explicitly)

## File Location

- Modes: `.cursor/rules/modes/<name>.mdc`
- Skills: `.cursor/rules/skills/<name>/SKILL.md`

## Naming Conventions

- Use lowercase with hyphens: `my-skill-name`
- Be descriptive: `webapp-testing` not `test`
- Match the folder name to the skill name

## Required Sections

1. **YAML Frontmatter** - name and description
2. **Title** - Clear skill name
3. **When to Use** - Trigger conditions
4. **Instructions** - What Claude should do
5. **Examples** - Concrete usage

## Optional Sections

- Guidelines / Best Practices
- Common Issues / Troubleshooting
- Related Skills / Modes

## After Creating

1. Test the skill with explicit invocation: "use [skill-name] skill"
2. Document in team wiki if shared
3. Consider adding to Mode Detection if workflow-based

## Existing Skills

| Skill | Purpose |
|-------|---------|
| `mcp-server` | Create MCP integrations |
| `webapp-testing` | Browser/Storybook testing |
| `skill-creator` | Create new skills (this one) |