How to install a Claude skill. Upload a ZIP in the app, drop a folder in Claude Code
Installing a skill depends on where you work. In the Claude app you upload a ZIP file, in Claude Code you copy a folder or install a plugin. We walk through all three.
Part of the guideClaude Code, the complete guide. From installation to your own skills and plugins
In this article
In short
You install a skill one way in the Claude app and another way in Claude Code. In the app you upload the folder as a ZIP under Customize, and in Claude Code you copy the folder into one of two directories or install a plugin with skills. Skills enabled on your Claude account download into Claude Code on their own from version 2.1.273.
Someone sends you a link to a skill on GitHub. You download the folder, it has a SKILL.md and a few other files, and now you wonder where it goes. The answer depends on where you use Claude. Installing a Claude skill in the app means uploading a ZIP, and in Claude Code it means copying a folder to the right place.
We checked the steps in the Claude Help Center and the Claude Code docs, as of 10 November 2026. What a skill is in the first place is explained in what is a Claude skill. The whole series is collected in our Claude Code guide.
Installing a skill in the Claude app
The Help Center says skills are available on the Free, Pro, Max, Ultra, Team and Enterprise plans and need code execution turned on. The developer docs list uploading custom skills only for paid plans, so on Free check it in your own account. On a personal account the steps are these.
- Open Settings, then Capabilities, and turn on Code execution and file creation. In the updated settings layout it is called Create and edit files.
- Zip the skill folder so that the archive holds the folder itself, not loose files.
- Go to Customize, then Skills, click the plus button, then Create skill, and choose Upload a skill.
- Pick the ZIP file. The skill appears in the list with a toggle to turn it on and off.
The archive should look like this. The folder name has to match the skill name, or the upload fails.
client-quote.zip
client-quote/
SKILL.md
contact.mdOn Team and Enterprise plans an organization owner first enables skills in Organization settings, under Plugins & skills, on the Policy tab. On Team they are on by default. The owner can also provision skills for everyone, and then they appear in every member's list. A skill you upload stays private until you share it.
One trap when uploading. The Help Center gives a limit of 200 characters for a skill description in the app and 64 characters for the name. If the skill was written for Claude Code and has a long description, shorten it before zipping.
Installing a skill in Claude Code
Nothing gets uploaded in Claude Code. A skill is a folder with a SKILL.md file, and Claude Code finds it on its own when it sits in one of these places.
| Where | Path | Who gets it |
|---|---|---|
| Personal | ~/.claude/skills/name/ | You, in every project on this computer |
| Project | .claude/skills/name/ | Everyone who works in this repository |
Copying a downloaded folder into your personal skills looks like this.
mkdir -p ~/.claude/skills
cp -r ~/Downloads/client-quote ~/.claude/skills/Claude Code watches these directories, so a new or edited skill works right away without a restart. The exception is when the skills folder did not exist at all when the session started. Then type /reload-skills. The /skills command lists all skills, and you run one by hand with a slash and its name, for example /client-quote.
When the same skill sits in both places, the personal one wins. A project skill is worth committing to the repository, so the whole team gets it with the code.
Skills from a plugin
Some skills are shipped as plugins, packages that Claude Code installs with one command. Anthropic shares its own skills this way in the anthropics/skills repository. In a Claude Code session you type two commands.
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skillsA plugin skill is called with the plugin name in front, in the form /plugin:skill. How plugins and marketplaces work is covered in Claude Code plugins. The Anthropic skills worth knowing are listed in official Claude skills.
Account skills in the terminal and in Cowork
Skills enabled on your Claude account reach Claude Code in the terminal on their own if you sign in with the same account. This needs version 2.1.273 or later. They download into ~/.claude/skills/synced/, and /skills labels them claude.ai sync. The sync goes one way. Claude Code only downloads, so an edit to a downloaded file never reaches your account and may disappear at the next sync. It also does not work when you sign in with an API key.
Cowork works the opposite way from what many people expect. It does not read ~/.claude/skills/ on your computer, only the skills enabled on your Claude account. If a skill should work in Cowork, upload it in the app. More about Cowork is in Claude Cowork setup.
How to turn off or remove a skill
In the app, the toggle next to the skill is enough. To delete it for good, open the skill, click the three dots next to the toggle and choose Delete. In Claude Code you delete the skill's folder. A plugin skill goes away when you disable or uninstall the plugin through /plugin.
Before you install someone else's skill, read all of its files. Anthropic reminds you that a skill can include scripts Claude will run, so install only skills from a source you know.
To start, one skill in one place is enough, wherever you work most. If you want to check which repeatable tasks in your company are worth turning into skills, our free AI audit looks at where AI can take work off your team.
What would you like to change in your business?
Leave your number. We will talk about your process and see whether we can help. The first call is free.
The service this text is about
Automation and AI / OCRAutomation of document re-typing, OCR and checking rules, and your data stays with you.