What a Claude Code skill is
A skill is a folder with a SKILL.md file that contains instructions. Claude Code loads it automatically when the task you're doing matches the skill's description. You don't have to paste the prompt every time.
Where they live
- Per project:
.claude/skills/<name>/SKILL.md(only that repo uses it). - Global:
~/.claude/skills/<name>/SKILL.md(all your projects use it).
Installing a skill: 3 ways
- Manual: create the folder and paste the
SKILL.md. Fast for your own skills. - From a marketplace/plugin: with a command like
/plugin install <name>@<marketplace>. - Cloning a repo of skills into your
skills/folder.
How it activates
Every SKILL.md has a description. When your request matches it, Claude Code activates the skill without you doing anything. That's why a good description is key.
Best practices
- One skill per task, with a clear description.
- Global for the ones you always use; per project for the specific ones.
- Review a skill's code before installing it if it comes from a third party.