How to Use Claude Skills in Claude Code, Claude.ai and the API (2026)
Quick answer: Install the skill where you use Claude, then ask for the task in plain words and Claude loads the skill automatically.
In Claude Code, drop the folder into
~/.claude/skills/. In Claude.ai, upload it as a zip in the Skills settings.
Using a Claude skill takes three steps: get one, install it where you use Claude, and ask for the task. You do not call the skill by name in most cases, because Claude matches your request to the skill's description.
This guide covers each place you can use skills, and what to do when one does not work. If you are new to the idea, read what Claude skills are first.
How to use Claude skills at a glance
| Where you use Claude | Where skills go | How you trigger one |
|---|---|---|
| Claude Code | ~/.claude/skills/ for you, .claude/skills/ for a project | Describe the task, or type the skill's name as a command |
| Claude.ai | Upload a zip in the Skills settings | Describe the task |
| Claude API | Upload through the Skills API | Reference the skill in your request |
| Agent SDK | The filesystem | Load skills from your project |
Custom skills do not sync between these places. Install a skill in each one you use.
Use a skill in Claude Code
Claude Code reads skills from folders on your computer. It scans their descriptions automatically and loads a skill when your request matches.
- Download or clone the skill folder.
- Place it in
~/.claude/skills/to use it everywhere, or.claude/skills/inside a project to share it with that project. - Start a new session.
- Ask for the task, for example "help me debug this failing test".
You can also type the skill's name as a command. The folder name becomes the command, and it should match the name in the skill file.
To confirm Claude can see your skills, ask which skills are available.
Use a skill in Claude.ai
On Claude.ai you upload a skill instead of placing a folder.
- Zip the skill folder so
SKILL.mdis inside it. - Open Claude's settings and find the Skills section.
- Upload the zip and turn the skill on.
- Start a chat and ask for the task.
Skills in Claude.ai need a paid plan with code execution enabled. Check Anthropic's help pages for what your plan includes.
Claude.ai also includes built-in skills for working with PowerPoint, Excel, Word and PDF files, so you do not need to install those.
Use a skill through the API
Developers add skills to API requests. You upload the skill through the Skills endpoint and reference it when you call Claude.
The API route needs the code execution tool and Anthropic's beta settings, which change over time. Follow Anthropic's current API documentation for the exact request format.
Trigger a skill reliably
Claude decides whether to use a skill from its description. A few habits make this work well.
- Use the words in the description: if the skill says "SEO audit", ask for an SEO audit.
- Name the task, not the skill: "audit this page" works better than "run my skill".
- Be specific: "write a Word document with tracked changes" matches more than "help with a file".
- Start a new session after installing: Claude reads skills when a session starts.
Check that it worked
A skill that loads should change the result. Look for the format, steps or rules the skill defines.
- Ask Claude which skills it used.
- Compare the output with and without the skill.
- Check that it followed each rule, such as the output format.
If a skill does not work
| Problem | Likely cause | Fix |
|---|---|---|
| It never triggers | The description does not match your wording | Rewrite the description, or use its trigger words |
| It triggers too often | The description is too broad | Make it narrower |
| Claude cannot find it | Wrong folder or no restart | Check the path and start a new session |
| It fails to upload in Claude.ai | SKILL.md is not at the top of the zip, or a setting is invalid | Re-zip with the folder at the top and check the settings |
| It works in one place only | Skills do not sync | Install it in each place |
| Claude seems slow | Too many large skills | Remove skills you do not use |
Keep your skills manageable
More skills are not always better. Each installed skill adds a small amount of text that Claude reads at startup.
- Start with three to five that fix real problems.
- Give each a distinct description, so they do not compete.
- Remove skills you never use.
- Keep skills you rely on up to date.
Use skills from other people safely
A skill is instructions, and sometimes code, so read it before you install it. Check the licence, look at any scripts, and test it in a throwaway project first.
Our safety checklist lists what to check. For help choosing, see how to choose an agent skill.
Try it: a 10-minute walkthrough
Here is a quick way to see a skill work.
- Download Systematic Debugging.
- Put the folder in
~/.claude/skills/, or upload it as a zip in Claude.ai. - Open a new session with a small failing script.
- Ask Claude to debug it, and watch for a root-cause step before any fix.
For more starting points, see the best Claude skills and the best Claude Code skills. Want to write your own? Follow how to create Claude skills.
Frequently asked questions
How do I use Claude skills?
Install the skill where you use Claude, then ask for the task in plain words. Claude loads the skill automatically when your request matches its description.
Do I have to call a skill by name?
Usually not. Claude matches your request to the skill's description. In Claude Code you can also type the skill's name as a command.
How do I add a skill to Claude.ai?
Zip the skill folder and upload it in the Skills section of Claude's settings. You need a paid plan with code execution enabled.
Can I use the same skill in Claude Code and Claude.ai?
Yes, but you install it in each place. Custom skills do not sync between Claude.ai, Claude Code and the API.
Why is Claude not using my skill?
The description probably does not match how you phrase your request. Use the skill's trigger words, and start a new session after installing.
Related guides
- 10 Claude workflows you can set up today: Ready-to-copy workflows for coding, research, documents and marketing.
- 25 Claude skills examples you can copy: Real skill descriptions and six patterns to reuse.
Methodology and disclosure
This guide draws on Anthropic's published documentation on Agent Skills and independent write-ups, checked in November 2026. Plans and settings change often, so confirm details in Anthropic's help pages.
We have no affiliation with Anthropic, and this article contains no affiliate links.