What it is
A skill is a folder that contains a SKILL.md file and, optionally, scripts, templates or reference files. The file starts with a short name and description. Claude sees only that description at first, and loads the full instructions when a task matches. This keeps the assistant fast while giving it deep, reusable know-how: your brand guidelines, how to fill a form, how to build a report.
How a skill is structured
Text
my-report-skill/
├── SKILL.md ← required: front matter + instructions
├── template.docx ← optional resources
└── scripts/
└── make_chart.py ← optional code Claude can runA minimal SKILL.md:
Markdown
---
name: weekly-report
description: Writes our weekly sales report. Use when the user asks for the weekly report or sales summary.
---
# Weekly report
1. Ask for the week's sales CSV if it was not provided.
2. Summarise totals by region in a table.
3. Write 3 bullet points of insights, in plain English.
4. Use the tone and headings from template.docx.Where skills work
| Where | How you add a skill |
|---|---|
| Claude apps (web/desktop) | Settings → Capabilities → Skills: upload a zipped skill folder |
| Claude Code | Put the folder in ~/.claude/skills/ (personal) or .claude/skills/ (project) |
| Claude API | Upload through the Skills API and enable it on requests |
Tips
- The description is the trigger. Say what the skill does and when to use it.
- Keep
SKILL.mdfocused; move long reference material into separate files it can read when needed. - Version your skills in git and share them with your team.
Warning
Skills can include code that runs. Only install skills from sources you trust, and read them first.
Build one step by step: Create your first Claude Skill.
Comments 0
Share tips, prompts that worked for you, or questions.
No comments yet. Be the first to share a tip.
Log in or create a free account to comment.