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) |

skill-creator

Skill Creator

SKILL.md Template

More from wellapp-ai/well

bpmn-workflow

qa-planning

webapp-testing

decision-capture

code-review

problem-framing