Agent Skills

Folders of instructions, scripts and resources that teach Claude how to do a specific task, loaded only when needed.

by Anthropic (open format) No ratings yet

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 run

A 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

WhereHow you add a skill
Claude apps (web/desktop)Settings → Capabilities → Skills: upload a zipped skill folder
Claude CodePut the folder in ~/.claude/skills/ (personal) or .claude/skills/ (project)
Claude APIUpload 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.md focused; 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.

Guides for Agent Skills

Intermediate 20 min

Create your first Claude Skill

Package a task you repeat often into a reusable skill that Claude loads automatically whenever you need it.

Uses: Agent Skills, Claude, Claude Code

Comments 0

Share tips, prompts that worked for you, or questions.

No comments yet. Be the first to share a tip.