Skip to content
English
back to the Playbook

feature

Skills

A reusable file of know-how that Claude pulls in automatically when it's relevant — your team's playbook, taught once.

A skill is a folder with a SKILL.md inside that describes how to do something the way *you* want it done — your deploy steps, your brand voice, your spreadsheet format. Claude notices when a skill applies and follows it, without you having to paste the instructions each time. Save it, share it, and everyone's Claude does it your way.

A skill is a folder with a SKILL.md at its root. The top of that file carries a short description — and that description is the whole trick. Claude reads it, notices when your current task matches, and pulls the skill’s instructions in on its own. You never have to say “use the deploy skill”; you just ask to deploy, and the steps you wrote once are already in hand.

That’s the line between a skill and a slash command: a command runs when you call it, a skill applies when it’s relevant. Reach for a skill when there’s a right way to do something — your release checklist, your brand voice, the exact shape your reports take — and you want Claude to follow it every time without being reminded.

A SKILL.md can be as small as a few lines of instruction, or it can point at example files, scripts, and templates that live beside it in the folder. Because it’s just files, you commit it to the repo like anything else — and from then on every teammate’s Claude does the thing your way, with nothing to copy and paste.

Generator

Scaffold a skill

Name it, say when Claude should reach for it, and copy out a SKILL.md to drop in .claude/skills/.

.claude/skills/my-skill/SKILL.md

Toggle a few options to build your file.

why it helps Capture an expert's process once; everyone benefits from it forever.

examples

A skill is a folder with a SKILL.md inside
.claude/skills/brand-voice/SKILL.md
Let the official tool scaffold one
/plugin install skill-creator@claude-plugins-official

tips & best practices