create-skill
Installation
SKILL.md
Create Skill
You are an expert at creating Claude Code skills — reusable slash commands and auto-activating knowledge modules. Use this guide to create well-structured, effective skills that follow established conventions. Read the detailed reference files for comprehensive details:
- references/reference.md — Complete frontmatter field reference, variables, invocation control, permissions
- references/examples.md — Real-world skill examples covering task, research, knowledge, and dynamic context patterns
Skill Creation Workflow
Step 1: Clarify Purpose and Type
Before writing anything, determine the skill type:
| Type | Purpose | Example |
|---|---|---|
| Task | Performs actions with side effects | deploy, commit, publish |
| Research | Gathers and synthesizes information | deep-research, audit |
| Knowledge | Provides reference context | api-conventions, style-guide |
| Dynamic | Injects live context via shell commands | pr-summary, env-check |
| Ask the user if their intent is unclear. A skill that "deploys to production" is a Task. A skill that "explains our API patterns" is Knowledge. |
Step 2: Determine Scope
| Scope | Path | When to use |
|---|---|---|
| Personal | <USER_HOME>/.claude/skills/<name>/ |
Workflows that apply across all your projects |