Claude Skills Explained: What They Are and How to Make Your First One
Claude Skills explained: what a skill is, how to turn skills on, how to write a SKILL.md and how to use the same skill in Claude Code, with a full example.

The short answer
Claude Skills are folders of instructions (a SKILL.md file, plus optional files and scripts) that teach Claude a specific workflow. Claude reads each skill’s short description and loads the full instructions only when a task matches. In the Claude app you turn skills on under Customize > Skills and can upload your own as a ZIP; in Claude Code you put them in ~/.claude/skills/<name>/SKILL.md.
Every time you explain the same process to Claude ("use this report format", "write in this tone", "check these five things"), you are doing work a skill can do for you. A skill is a small folder that teaches Claude a workflow once, so it applies it whenever the task comes up.
I use skills daily in Claude Code, for example one that tells Claude how to write and check blog posts for this site. This guide explains skills in plain English and walks you through making your first one.
What a Claude skill is
A skill is a folder with a file called SKILL.md. That file has:
- A short header with a name and a description: what the skill does and when to use it.
- Instructions in plain Markdown: the steps, rules and examples.
A skill can also hold extra files, such as templates, reference notes or scripts.
The clever part: Claude always sees the description, but loads the full instructions only when your request matches it. So you can have many skills without slowing every chat down.
Anthropic's own built-in skills include creating Excel spreadsheets, Word documents, PowerPoint presentations and PDFs.
Turn on Skills in the Claude app
According to Anthropic's help page, Skills are available on Free, Pro, Max, Team and Enterprise plans:
- Free, Pro or Max: go to Settings > Capabilities and make sure code execution and file creation is on.
- Go to Customize > Skills and switch individual skills on or off.
- Team or Enterprise: an admin enables Skills in organisation settings first.
Write your first skill
Example: a skill that turns rough notes into a client update in your format.
Create a folder called client-update, and inside it a file SKILL.md:
---
name: client-update
description: Turns rough notes into a weekly client update email in my format. Use when I ask for a client update, a weekly report email, or paste notes about a client's campaign.
---
# Weekly client update
## Format
1. Subject line: "[Client] weekly update, [date]"
2. Three-line summary: what happened, what it means, what is next.
3. "Numbers" section: only numbers that appear in my notes. Never invent or estimate.
4. "Next week" section: three bullet points at most.
5. Sign off with my name.
## Rules
- Plain English, short sentences, no jargon.
- If a number in my notes looks wrong or is missing, ask me instead of guessing.
- Do not promise results.
Write the description carefully. It decides when the skill is used. Say what it does and the words a request would contain.
Upload it to Claude
- ZIP the
client-updatefolder. - In Claude, go to Customize > Skills.
- Click +, then + Create skill, then Upload a skill.
- Choose the ZIP file. The skill appears in your list, switched on.
Now paste some notes and say "make the weekly update for this client". Claude picks up the skill on its own.
If the upload fails, check that the folder name matches the skill name, that SKILL.md exists and that the name and description have no unusual characters.
Use the same skill in Claude Code
In Claude Code a skill is the same folder, saved in one of two places (Claude Code docs):
| Scope | Path |
|---|---|
| Personal, all your projects | ~/.claude/skills/<skill-name>/SKILL.md |
| One project, shared with your team | .claude/skills/<skill-name>/SKILL.md |
Claude Code uses it automatically when a request matches, or you run it yourself by typing / and the skill name, such as /client-update.
Good first skills to make
- Brand voice: your tone, words you use and words you never use.
- Report format: the structure of your weekly or monthly report.
- Content checklist: checks before publishing, such as "every number has a source".
- Meeting notes: notes into summary, tasks and open questions.
- Ad copy rules: hooks, length and claims to avoid. Pairs well with Meta ads using Claude.
Tips from using skills daily
- One skill, one job. Small, focused skills trigger more reliably than one giant skill.
- Show examples of good output inside the skill.
- Write rules as do and don't, not long paragraphs.
- Install only skills you trust, and read them first. Skills can include scripts.
- Improve it every time it gets something wrong. Add the fix as a rule.
New to Claude? Start with how to use Claude AI, then come back here.
Questions people ask
- Which Claude plans have Skills?
- Skills are available on Free, Pro, Max, Team and Enterprise plans. They need code execution and file creation turned on.
- Where do I turn Skills on?
- On Free, Pro and Max, make sure code execution and file creation is on in Settings > Capabilities, then switch individual skills on or off in Customize > Skills. Team and Enterprise admins control this in organisation settings.
- What goes inside SKILL.md?
- A short YAML header with a name and a description, followed by plain Markdown instructions. The description should say clearly what the skill does and when to use it.
- How does Claude know when to use a skill?
- Claude always sees each skill’s description. When your request matches it, Claude loads the full instructions. A specific description makes the skill trigger at the right time.
- Can I use the same skill in Claude Code?
- Yes. In Claude Code, personal skills live in ~/.claude/skills/<skill-name>/SKILL.md and project skills in .claude/skills/<skill-name>/SKILL.md. You can also run a skill directly by typing / and its name.
- Why did my skill upload fail?
- Common reasons: the ZIP is too large, the folder name does not match the skill name, the SKILL.md file is missing, or the name or description has invalid characters.
- Are skills the same as Projects?
- No. A Project holds context for one area of work (files and instructions for those chats). A skill is a reusable how-to that Claude can apply in any chat when the task matches.
- Are skills from the internet safe to install?
- Only install skills from sources you trust, and read them first. A skill can include scripts that run when it is used.
Keep reading
Read next
AI Tools ·
Claude Code for Beginners: Install It on Windows and Build Your First Project
Claude Code for beginners: what it is, which account you need, how to install it on Windows, Mac or Linux, and how to build your first project safely.
AI Tools ·
Claude Prompts for Work: 10 Copy-Paste Prompts That Save Hours Every Week
Ten copy-paste Claude prompts for work: emails, meeting notes, reports, spreadsheets, PDFs and planning, plus a simple formula that makes AI sound human.
AI Tools ·
How to Use Claude AI: A Beginner’s Guide for Work, Study and Business (2026)
How to use Claude AI as a beginner: sign up, write good prompts, upload files, use Projects, the everyday tasks it does well and the checks to always do.


