Guide for creating new Claude Code skills. Use when you need to create a new skill to package expertise or workflow into a reusable capability that Claude can automatically invoke.
Use this skill when creating new Claude Code skills that package expertise, workflows, or domain knowledge into reusable capabilities.
Skills are autonomous capabilities that Claude Code can invoke automatically based on the user's request. Each skill consists of a SKILL.md file with YAML frontmatter and markdown instructions, plus optional supporting files.
.claude/skills/
└── your-skill-name/
├── SKILL.md # Required: Main skill definition
├── reference.md # Optional: Additional documentation
├── examples.md # Optional: Example usage
├── templates/ # Optional: Template files
│ └── template.txt
└── scripts/ # Optional: Helper scripts
└── helper.py
Every SKILL.md file must have:
---