Features · Extend it · since version 2.0.20
Skills
Save a set of instructions once; Claude loads it when relevant, or you run it as a slash command.
What it is
A skill is a folder containing a SKILL.md file: a short description of when to use it, followed by the instructions to follow. Claude sees the description and loads the full instructions only when the skill is used, so long procedures cost almost nothing until they are needed. You can also start a skill yourself by typing a slash and its name.
Why it matters
- Stop pasting the same instructionsA checklist or multi-step procedure you keep repeating becomes a skill you write once.
- Light on contextOnly the description is loaded up front; the body loads when the skill is invoked.
- Easy to sharePut a skill in your home folder for all your projects, or commit it to a repository so the whole team gets it.
- You decide who can start itFrontmatter settings can stop Claude from starting a skill on its own, or hide it from the slash menu.
How it works
- Create a folder for the skill, for example ~/.claude/skills/my-skill/ or .claude/skills/my-skill/ in a project.
- Add a SKILL.md file with YAML frontmatter between --- markers; the description tells Claude when to use the skill.
- Write the instructions below the frontmatter.
- Claude loads the skill when your request matches the description, or you type /my-skill to run it directly.
- Older files in .claude/commands/ keep working: custom commands were merged into skills.
Hands-on example coming
This feature has no reviewed example yet. The official documentation below has the details.
Update history
Version 2.0.20 · Oct 16, 2025
Introduced Support for skills was added.