$ skilldirectory
— zsh — registry.skilldirectory.dev
skill libraryblogguidesabout

home / blog / claude skills

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 ClaudeWhere skills goHow you trigger one
Claude Code~/.claude/skills/ for you, .claude/skills/ for a projectDescribe the task, or type the skill's name as a command
Claude.aiUpload a zip in the Skills settingsDescribe the task
Claude APIUpload through the Skills APIReference the skill in your request
Agent SDKThe filesystemLoad 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.

  1. Download or clone the skill folder.
  2. Place it in ~/.claude/skills/ to use it everywhere, or .claude/skills/ inside a project to share it with that project.
  3. Start a new session.
  4. 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.

  1. Zip the skill folder so SKILL.md is inside it.
  2. Open Claude's settings and find the Skills section.
  3. Upload the zip and turn the skill on.
  4. 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

ProblemLikely causeFix
It never triggersThe description does not match your wordingRewrite the description, or use its trigger words
It triggers too oftenThe description is too broadMake it narrower
Claude cannot find itWrong folder or no restartCheck the path and start a new session
It fails to upload in Claude.aiSKILL.md is not at the top of the zip, or a setting is invalidRe-zip with the folder at the top and check the settings
It works in one place onlySkills do not syncInstall it in each place
Claude seems slowToo many large skillsRemove 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.

  1. Download Systematic Debugging.
  2. Put the folder in ~/.claude/skills/, or upload it as a zip in Claude.ai.
  3. Open a new session with a small failing script.
  4. 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.

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.