creating-skillslisted

# Creating Claude Code Skills A meta-skill for creating well-structured, discoverable, and effective Claude Code skills. ## Overview Claude Skills are markdown files that teach Claude specialized knowledge. They're **automatically discovered** based on their description, so writing effective descriptions is critical. ## Quick Start 1. **Choose location** based on scope: - Personal: `~/.claude/skills/your-skill/` - Project: `.claude/skills/your-skill/` 2. **Create directory and SKILL.md**: ```bash mkdir -p .claude/skills/your-skill ``` 3. **Write SKILL.md** with required frontmatter: ```yaml --- name: your-skill-name description: [Trigger-rich description] --- ``` 4. **Validate** using [CHECKLIST.md](CHECKLIST.md) ## The Golden Rule: Description Is Everything Claude uses the `description` field to decide when to apply your skill. A poor description means your skill never triggers. ### Description Formula ``` [What it does] + [Specific capabilities] + [Trigger phrases] ``` ### Bad vs Good Descriptions | Bad | Good | |-----|------| | "Helps with testing" | "Write and run unit tests for TypeScript. Use when creating tests, mocking dependencies, or improving test coverage." | | "Database helper" | "Generate SQL migrations and queries for PostgreSQL. Use when creating tables, writing queries, or migrating schemas." | | "Code review" | "Review code for bugs, security issues, and style violations. Use when reviewing PRs, auditing code, o