Personal:  ~/.claude/skills/skill-name/SKILL.md
Project:   .claude/skills/skill-name/SKILL.md
Plugin:    Bundled with the package

mkdir -p .claude/skills/my-skill-name

---
name: skill-identifier          # Required: Only lowercase letters, numbers, hyphens, max 64 characters
description: What it does + when to use it  # Required: Max 1024 characters, include trigger keywords
allowed-tools: Read, Grep, Edit  # Optional: Tool restrictions
---

# ✅ GOOD
description: Assists with creating, debugging, and fixing failed E2E tests. Used when Playwright tests fail or when creating new tests.

# ❌ BAD
description: Helps with tests

# Skill Title

Overview (1-2 sentences)

## When to Use This Skill

- Scenario 1
- Scenario 2

## Instructions

1. **Step 1**: First thing to do
2. **Step 2**: Next thing to do
3. **Step 3**: Final thing to do

## Examples

### Example 1: [Scenario]
[Code example]

## Troubleshooting

**Issue**: Problem
**Solution**: Resolution

## AI Assistant Instructions

When this skill is activated:
1. First, check ○○
2. Next, execute ○○

Always:
- Always ○○

Never:
- Never ○○

allowed-tools: Read, Grep, Glob  # Read-only

my-skill-name/
├── SKILL.md              # Main file (required, max 500 lines)
├── reference.md          # Detailed reference (loaded when needed)
└── templates/            # Templates

For details, refer to [reference.md](reference.md).

# ✅ DO
- api-docs-writer: API documentation generation
- test-strategy: Test implementation

# ❌ DON'T
- developer-helper: Everything (vague)

# ✅ GOOD
description: Generate OpenAPI/Swagger documentation from Express/FastAPI. Used when creating API documentation.

# ❌ BAD
description: Helps with API documentation

## AI Assistant Instructions

When this skill is activated:
1. First, analyze the codebase
2. Ask questions if needed
3. Generate an initial version

Always:
- Use TypeScript for type safety
- Include error handling

Never:
- Don't skip validation

my-skill-name/
├── SKILL.md          # Core ( < 500 lines)
├── reference.md      # Details (loaded only when needed)
└── examples.md       # Extended examples (loaded only when needed)

---
name: component-generator
description: Generate React/Vue/Angular components. Used when creating new components.
---

# Component Generator

## Instructions

1. Confirm the component type (React/Vue/Angular)
2. Get the name and props
3. Generate: Component + Tests + Storybook
4. Follow project conventions

# Project skills
git add .claude/skills/skill-name/
git commit -m "feat: add [skill-name] skill"
git push
# Team members can get it with git pull