What a skill is.
A skill is a packaged capability Claude uses when it is relevant. In practice, it is a folder containing a SKILL.md file: at the top, a name and a description saying what the skill does and when to use it; then the instructions to follow; and if needed, reference files and scripts.
Anthropic's documentation sums up the benefit in three points: specialize Claude for your tasks, stop repeating the same instructions, and combine several skills for multi-step tasks.
The right reflex, as the Claude Code documentation puts it: create a skill when you catch yourself pasting the same instructions, checklist or procedure into the conversation again.
How Claude loads a skill.
The key principle is called progressive disclosure: Claude loads only what it needs, when it needs it.
| Level | What is loaded | When |
|---|---|---|
| 1. Metadata | The skill's name and description | Always, at startup |
| 2. Instructions | The body of SKILL.md | When a request matches the description |
| 3. Resources and code | Reference files, templates, scripts | Only when the instructions point to them |
Two practical consequences. First, the description is decisive: it is what Claude matches your request against to decide whether to use the skill, so it must say both what it does and when to use it. Second, you can install many skills without weighing down every conversation, since only their descriptions are always loaded.
Scripts have a distinct advantage: Claude runs them without loading their code into the conversation. That is what makes a skill reliable for operations that must always produce the same result.
The skills Anthropic provides.
Anthropic provides ready-made skills for everyday documents: PowerPoint, Excel, Word and PDF. They are available on claude.ai and through the API.
Claude Code also ships its own skills, such as /code-review or /debug, which you call by typing / followed by their name.
For everything else, especially your internal procedures, you create your own skills. They work everywhere: created in Claude Code, uploaded through the API or added in claude.ai settings.
Create your first skill in Claude Code.
A skill takes two minutes to create. Create a folder in your personal skills directory:
mkdir -p ~/.claude/skills/meeting-summary
Then a SKILL.md file in that folder:
---
name: meeting-summary
description: Turns raw meeting notes into a structured summary. Use when the user pastes meeting notes or asks for meeting minutes.
---
# Meeting summary
1. List the decisions made, one per line.
2. List the actions with their owner and due date.
3. End with the points still open.
Plain tone, short sentences, never invent information.
That is it. Claude will use it when you paste meeting notes, or you can call it directly with /meeting-summary.
Where you put the folder decides who benefits:
| Location | Path | Available to |
|---|---|---|
| Personal | ~/.claude/skills/<name>/SKILL.md |
All your projects, on your machine |
| Project | .claude/skills/<name>/SKILL.md |
The whole team, shared with the project |
| Enterprise | Managed settings directory | Every machine where the organization deploys it |
Claude Code skills follow the open Agent Skills standard (agentskills.io), designed to work across several AI tools.
What businesses do with them.
The most useful skills capture a procedure your team repeats and that must be done right every time:
- Write by your rules: editorial guidelines, brand voice, banned words, the standard structure of a quote or a proposal.
- Prepare prospecting: at AUTOMATE ALL, a skill reads a prospect's profile and recent activity, then drafts a tailored first message, reviewed before sending. We use it every day.
- Produce recurring documents: minutes, monthly reports, standard replies, from your templates.
- Check before sending: a quality checklist applied every time, with scripts for checks that tolerate no error.
To go further: Claude Code, the guide for the tool that runs these skills on your files, and Claude Pricing 2026 for the right plan.
Claude Skills: what people ask us.
What is a Claude skill?
A folder containing a SKILL.md file: a description (what the skill does and when to use it), instructions, and optionally reference files and scripts. Claude uses it automatically when your request matches the description, or when you call it by name.
What is the difference between a skill and a prompt?
A prompt applies to one conversation. A skill is reusable: written once, it is available in all your sessions and only loads when it is needed. It can also bundle scripts, which Claude runs without reading them in full.
Where can I use skills?
In claude.ai (settings), in Claude Code (personal or project folder) and through the Claude API. Skills are included in every Claude plan, the free one included, according to Anthropic's pricing page.
Which skills does Anthropic provide?
Ready-made skills for everyday documents: PowerPoint, Excel, Word and PDF. For everything else, you create your own.
How do I create a skill in Claude Code?
Create a folder in ~/.claude/skills/ (for all your projects) or .claude/skills/ (for a project shared with your team), with a SKILL.md file containing a description and instructions. Claude uses it when a request matches, or you call it with /skill-name.
Do skills work with tools other than Claude?
Claude Code skills follow the open Agent Skills standard (agentskills.io), designed to work across several AI tools. Claude Code adds its own features on top.