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
  1. Installing a skill in the Claude app
  2. Installing a skill in Claude Code
  3. Skills from a plugin
  4. Account skills in the terminal and in Cowork
  5. How to turn off or remove a skill

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.

  1. Open Settings, then Capabilities, and turn on Code execution and file creation. In the updated settings layout it is called Create and edit files.
  2. Zip the skill folder so that the archive holds the folder itself, not loose files.
  3. Go to Customize, then Skills, click the plus button, then Create skill, and choose Upload a skill.
  4. 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.md

On 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.

WherePathWho 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.

bash
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-skills

A 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.

When is the best time to call?
Controller: Oleksandr Bondarenko (BondSoft)Privacy PolicyTerms of Service
Legal details

The data controller is Oleksandr Bondarenko, trading as Oleksandr Bondarenko Software Solutions (BondSoft), ul. Jana Heweliusza 11, 80-890 Gdańsk, Poland, NIP 5833576264, e-mail: office@bondsoft.pl.

We process your data solely to contact you about your enquiry and to present an offer — on the basis of your consent (Art. 6(1)(a) GDPR and Art. 398 of the Polish Electronic Communications Law) and our legitimate interest in handling the enquiry (Art. 6(1)(f) GDPR).

Providing the data is voluntary but necessary for us to reply. You may withdraw your consent at any time by writing to office@bondsoft.pl — this does not affect the lawfulness of processing before the withdrawal.

You have the right to access your data, rectify it, erase it, restrict its processing, transfer it, and lodge a complaint with the President of the Polish Personal Data Protection Office.

Full information: Privacy Policy.

Send us an email

The service this text is about

Automation and AI / OCR

Automation of document re-typing, OCR and checking rules, and your data stays with you.