How to Install a Claude Skill (Step by Step, 2026)

Updated

Open the Claude desktop app, go to Customize → Skills, click +, and upload the skill's ZIP. Claude reads the SKILL.md inside and switches it on. Uploading needs a paid plan - Anthropic lists Skills on Pro, Max, Team and Enterprise - and code execution switched on, which is the reason the menu is greyed out for most people who already pay. On the free plan, or in ChatGPT or Gemini, paste the file's text into custom instructions instead and you get the same behaviour without the automatic triggering.

Before you start: the one setting that decides everything

Two things gate the Skills menu, and most "I can't install skills" posts confuse them.

  • Your plan. Anthropic makes Skills available on Pro, Max, Team and Enterprise. There is no Skills menu on the free plan - jump to Method 2, which works on any plan and in any AI chat.
  • Code execution. Even on a paid plan the menu stays greyed out until this is on. Open Settings → Capabilities and turn on Code execution and file creation. On Team and Enterprise an owner controls it for the whole organisation, so if yours is off the toggle is not yours to flip and you need to ask them.

Sort those two out first and steps 1 to 6 below take about two minutes.

Method 1: upload the skill to Claude

This is the native route, where Claude picks the skill up on its own whenever your request matches what it is for.

  1. Open the Claude desktop app and look at the left sidebar.
  2. Click Customize, then Skills. This is where your installed skills live.
  3. Click the + button. Add an official skill, or choose Create skill to upload your own.
  4. Upload the ZIP. Claude reads the SKILL.md at the root and shows you a summary of what the skill does. Read that summary: it is Claude telling you what it understood, and if it sounds vague, the skill's description is vague and it will trigger unpredictably.
  5. Toggle it on. It appears in the list with a switch. Uploaded is not the same as enabled.
  6. Use it. Ask for the task the skill was built for. You do not name the skill; Claude matches your request against its description.

Where the file actually lives, by surface

This is the part that catches people out, because "installed" means something different depending on where you are working.

Surface Where the skill has to be
Claude app Uploaded through Customize → Skills. It lives on your account, so it follows you to any device you sign in on.
Claude Code, personal ~/.claude/skills/<name>/ - applies to every project on that machine.
Claude Code, project .claude/skills/<name>/ inside the repository - travels with the repo, so the whole team gets it.
Cowork and cloud sessions They do not read the folder on your machine. They load the skills enabled on your account, synced when the session starts.
The trap worth knowing about. A skill that exists only in a local .claude/skills/ folder comes back as "not found" in Cowork or a cloud session, because those run somewhere else entirely and sync from your account instead. If a skill works in your terminal and not in the cloud, this is almost always why: upload it through Customize → Skills as well, rather than hunting for a bug.
They do not sync between surfaces either. Anthropic documents the Claude app, Claude Code and the API as separate installs: a skill uploaded in the app is not available through the API, and a Claude Code skill is separate from both. If you want the same file in more than one place, install it in each.

Claude Code, in one line

Skip the interface. unzip code-reviewer.zip -d ~/.claude/skills/ puts it in the personal folder. Check that a valid SKILL.md sits at the folder root, restart, and run /skills to confirm it loaded.

Worked example
Lena - Content Marketing Manager AI Skill
Lena - Content Marketing Manager AI Skill
$29once, keep the file vs $0/mono subscription

Exactly the kind of ZIP you upload at step 4: unzip it, add it through Customize → Skills, toggle it on, and ask for a content calendar or a brief.

View Lena →

Method 2: paste it instead

Use this on the free plan, in ChatGPT or Gemini, or anywhere you cannot turn code execution on.

  1. Open the SKILL.md. It is plain Markdown; any text editor will do. Prompt packs are often .txt.
  2. Copy all of it.
  3. Find the standing-instructions field in your assistant: system prompt, custom instructions, or a project's instructions.
  4. Paste and save.
  5. Start working. The assistant behaves like the specialist from the first message.

What you give up is automatic triggering: the instructions apply to everything in that chat or project rather than switching on when relevant. For a single-purpose project that is often what you wanted anyway.

Every file in the KissMySkills library works this way, and the free browser tools let you see the style of the writing before you buy anything.

Where to get skills

  • Official Anthropic skills - a small built-in set for document work: Word, Excel, PowerPoint, PDF.
  • Your own - a folder with a SKILL.md, a sharp description and clear steps. The right call for a workflow only your team has.
  • Ready-made - over 1,700 skills, 50+ prompt packs and 55 agents in this catalogue. Browse all skills, the Claude Code collection of 137 files, or the prompt packs.
Ready-made library
Everything Bundle - all 55 AI agents
Everything Bundle - All 55 AI Agents
$447.99this bundle vs $1,760all 55 bought separately

Agents are $32 each, so fifty-five of them come to $1,760. One purchase and one download instead of installing them one at a time.

View Everything Bundle →

When it does not work

  • Skills menu missing or greyed out. Either you are on the free plan, which has no Skills menu at all, or code execution is off: Settings → Capabilities on Pro and Max; ask an owner on Team and Enterprise.
  • Uploaded but never appears. The SKILL.md is not at the root of the ZIP. Zipping a folder that contains the folder that contains the file is the usual cause. Open the archive and check that SKILL.md is the first thing you see.
  • Installed but never triggers. The description is doing the triggering, not the title. "Helps with marketing" matches nothing in particular; "use when writing or reviewing cold outbound email sequences" matches precisely. Edit the description line and re-upload. In Claude Code, run /skills to confirm it loaded and restart after adding files.
  • Triggers on everything. The opposite problem, same cause. Narrow the description, or toggle the skill off when you are not doing that job.
  • Works in the terminal, not in the cloud. Cowork and cloud sessions sync from your account, not from your disk. Upload the same file through Customize → Skills.
  • Two skills fighting over the same request. If their descriptions overlap, Claude will pick one and it may not be the one you meant. Toggle the other one off, or make the descriptions name different situations rather than different job titles.

Is it safe?

A skill is text instructions, sometimes with scripts alongside. Anthropic's own guidance is to use skills only from sources you trust, and to audit anything from an unknown source before enabling it, because a skill can direct Claude to run code and use tools in ways its description does not mention. Open the SKILL.md and read it before you use it, the way you would skim a contract. Treat a skill that bundles executable scripts, or that fetches data from external URLs, with the same caution you would give any download, and prefer sources that let you see the contents before you buy.

Ready to install your first one?

Pick a skill, upload or paste it, and watch the assistant specialise. Browse the full library, try the free browser tools first, or read what Claude Skills are if the concept is new.

Related Guides

Two minutes · works with Claude & ChatGPT

Something to install once you have the menu open

Over 1,700 skill files, each written for one role and readable before you buy. Instant download, no subscription, 30-day money-back guarantee.

Browse all skills →

KissMySkills is a marketplace of over 1,700 AI skills, prompt packs, agents & free tools for Claude, ChatGPT & any AI chat.

Frequently asked questions

Can I install Claude Skills on the free plan?+

No. Anthropic makes Skills available on the Pro, Max, Team and Enterprise plans, so the Skills menu is not there on Free. You can still use a skill on Free: open the SKILL.md, copy its contents, and paste them into the conversation or into project instructions. You lose automatic triggering and load it by hand each time, but the method itself is identical.

Why is my Skills menu greyed out?+

Two possible reasons. Either you are on a plan without Skills, or you are on a paid plan and code execution is switched off. Turn on 'Code execution and file creation' under Settings then Capabilities. On Team and Enterprise an organisation owner controls that switch, so if it is off you have to ask them rather than flip it yourself.

What exactly is inside the ZIP?+

A folder with a SKILL.md at its root. That file carries YAML frontmatter with a name and a description, then the instructions themselves. A skill can also bundle extra markdown files, reference material and scripts, which Claude opens only when the task needs them.

My upload failed. What is the usual cause?+

The SKILL.md has to sit at the root of the archive, not inside a nested folder. Zipping the parent folder instead of its contents is the single most common cause of a rejected upload. Unzip your file and check the first level.

Can I use the same skill in ChatGPT or Gemini?+

Yes, by pasting rather than uploading. Open the SKILL.md, copy everything, and paste it into custom instructions or a project. The instructions behave the same way. What does not carry over is the Claude Skills runtime, which triggers a skill automatically and loads bundled files only when needed.

How many skills can I have installed at once?+

Several. Each sits in the list with its own toggle, so you can switch them on and off independently. Only a skill whose description matches your request gets loaded into the conversation, so keeping a few installed costs you almost nothing.

Does Claude Code handle skills differently?+

Yes. Claude Code reads skills from the filesystem, so there is no upload step. Unzip into ~/.claude/skills// for a personal skill or .claude/skills// inside a project, then run /skills to confirm it loaded.

Do skills sync between the Claude app, Claude Code and the API?+

No. Anthropic documents them as separate surfaces. A skill uploaded in the Claude app is not available through the API, and a Claude Code skill is separate from both. If you want the same skill in more than one place, install it in each.

Is it safe to install a skill I downloaded?+

Treat it like installing software. Anthropic advises using skills only from sources you trust, and auditing anything from an unknown source before enabling it, because a skill can direct Claude to run code and use tools. Open the SKILL.md and any bundled scripts and read them first.

~/get-started

Skills that work. No fluff.

Browse every skill, prompt pack, and agent in the store.

Browse all skills →Or try the free tools