Skip to article
KnaccoGuides
Start here

How to install Claude skills in Claude Code, the Claude apps, Codex and Antigravity CLI

How to install Claude skills: the folder for Claude Code, the upload steps for the Claude apps, the skill folders for Codex and Antigravity CLI, and fixes.

Blue Knacco character beside a red picture frame, a camera, a pencil and two layout sheets.
0:00
10:35

To install a Claude skill in Claude Code, copy the skill's folder, the one that contains its SKILL.md file, into ~/.claude/skills/ for every project or into .claude/skills/ inside one project. In the Claude apps you upload the same folder as a ZIP file under Customize > Skills, Codex reads it from ~/.agents/skills/ and Antigravity CLI from ~/.gemini/config/skills/.

The steps below were checked on 18 November 2026 against the documentation that Anthropic and OpenAI publish, and the commands were run on Claude Code 2.1.326. The Antigravity CLI paths were checked against Google's documentation on 20 November 2026. Antigravity CLI is Google's replacement for Gemini CLI. Menus and paths change, so the sources are listed at the end of this guide.

What you are installing

A skill is a folder. The open Agent Skills specification requires one file in it, SKILL.md, and allows scripts, reference documents and assets beside it:

skill-name/
├── SKILL.md
├── scripts/
├── references/
└── assets/

SKILL.md opens with a short block of settings between two --- lines, which holds the skill's name and description, followed by the instructions the AI tool reads. Under the specification the name uses lowercase letters, numbers and hyphens, and matches the name of the folder.

Installing a skill means putting this folder where your AI tool looks for it. Nothing is compiled. If you are not sure a skill is the right format for your task, read prompt vs skill vs workflow first.

Read SKILL.md and every script before you install a skill that someone else wrote. Its instructions and scripts run with your files and your accounts within reach. How to choose an AI prompt pack before you buy lists the checks worth making.

Install a skill in Claude Code

Claude Code loads skills from two places that you control.

Kind Path Where the skill works
Personal ~/.claude/skills/skill-name/SKILL.md Every project on this computer
Project .claude/skills/skill-name/SKILL.md One repository, and everyone who works in it once the folder is committed
  1. Download the skill and find the folder that directly contains SKILL.md.
  2. Create the skills folder if it does not exist: mkdir -p ~/.claude/skills
  3. Copy the skill folder into it: cp -R skill-name ~/.claude/skills/
  4. In Claude Code, run /skills. The skill should be in the list.
  5. Use it. Type /skill-name, or describe a task that matches the skill's description and let Claude load it.

Claude Code watches its skills folders, so a skill added to a folder that already existed appears without a restart. If you created ~/.claude/skills/ or .claude/skills/ during the session, run /reload-skills once.

Install a set of skills as a Claude Code plugin

Many skill collections are published as plugins, where one install adds several skills. Anthropic's own example skills install this way. In Claude Code, run:

/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills

The first line registers the repository as a marketplace, which is a catalog of plugins. The second opens the plugin's details, where you read what it adds and choose whether it applies to all your projects or to one repository. Skills that come from a plugin carry the plugin's name, in the form /plugin-name:skill-name.

To browse first, run /plugin and open the Discover tab. It lists the plugins in Anthropic's official marketplace, which Claude Code adds the first time you start an interactive session. A plugin can also add hooks and MCP servers, and those run on your computer, so read the details before you install.

Install a skill in the Claude apps

In claude.ai and the Claude desktop app, a skill is uploaded as a ZIP file. "Code execution and file creation" must be switched on under Settings > Capabilities. On Team and Enterprise plans an owner controls that setting. Anthropic's help center lists skills for the Free, Pro, Max, Ultra, Team and Enterprise plans, while one of its documentation pages lists the paid plans only. If you are on the Free plan and see no Skills page, that is the likely reason.

  1. Zip the skill from the folder above it, so that the skill folder is the top level of the archive: zip -r skill-name.zip skill-name/
  2. Check the archive: unzip -l skill-name.zip. Every line should begin with skill-name/. If SKILL.md appears without that prefix, you zipped the contents and not the folder.
  3. In Claude, open Customize > Skills.
  4. Select the "+" button, then "Create skill", then "Upload a skill", and choose the ZIP file.
  5. Find the skill in your list and switch it on.

The same page holds a directory of ready-made skills: select "+", then "Browse skills", then "Add" beside the one you want.

Skills switched on in your Claude account also load in Claude Code when you sign in with the same account, on version 2.1.273 or later. /skills lists them under "claude.ai sync". The sync runs one way: a folder you copy into ~/.claude/skills/ is not uploaded to your account.

Use the same folder in Codex and Antigravity CLI

Codex and Antigravity CLI both load skills from folders that hold SKILL.md, so the folder needs no conversion. A skill that depends on features only Claude Code offers may do less in another tool.

Tool Every project One project Check that it loaded
Claude Code ~/.claude/skills/ .claude/skills/ /skills
Codex ~/.agents/skills/ .agents/skills/ /skills, or type $ to choose a skill
Antigravity CLI ~/.gemini/config/skills/ .agents/skills/ /skills

Codex and Antigravity CLI both read .agents/skills/ inside a project. Claude Code's documentation lists only the .claude locations, but it follows symbolic links, as Codex does. You can therefore keep one copy in ~/.agents/skills/ and point Claude Code at it:

mkdir -p ~/.agents/skills ~/.claude/skills
cp -R skill-name ~/.agents/skills/
ln -s ~/.agents/skills/skill-name ~/.claude/skills/skill-name

A skill linked this way loaded and ran in Claude Code when this guide was checked.

In Antigravity CLI, /skills lists the loaded skills and /skills reload reads them again from disk. A project's old .gemini/skills/ folder is not read, so move it to .agents/skills/. Codex finds new skills by itself, and its documentation says to restart Codex if one does not appear.

A worked example with a Knacco skill

Knacco's products are skill folders that come with an installer, so the copy step is one command. This is a real run of the free Prompt Writing Guide, made on 18 November 2026 from the product folder of the download. The first command previews the install and writes nothing:

python3 install.py --host claude --ids kit-prompt-writing-system --dry-run

It answered as follows, with the home folder shortened here to ~:

{
  "action": "preview",
  "host": "claude",
  "destination": "~/.claude/skills",
  "products": [
    "kit-prompt-writing-system"
  ]
}

Run without --dry-run, the installer copied one folder named kit-prompt-writing-system into the destination. The folder held SKILL.md, GUIDE.md, references and tools. With --host codex the preview named ~/.agents/skills as the destination, and with --host gemini it named ~/.gemini/skills, a folder Antigravity CLI still loads. The installer needs Python 3.9 or later.

Knacco has 123+ products, and each has setup files for Claude Code, Codex and Antigravity CLI. Start with the free skills, prompt packs and workflows, or see the whole skills category. The Knacco plugin then lets a connected AI tool list the products you own and fetch their files.

What to check when a skill does not load

Work down this list in order. The first three causes account for most failures.

What you see Likely cause What to do
The skill is missing from /skills The folder is one level too deep, such as skills/skill-name/skill-name/SKILL.md, which often happens after unzipping Move the folder so that SKILL.md sits directly inside skills/skill-name/
The skill is missing from /skills The skills folder was created during this session Run /reload-skills in Claude Code, or restart the tool
The skill is missing from /skills The file is not named SKILL.md, or the folder is named synced or anthropic-skills, which Claude Code reserves Rename the file or the folder
/skill-name works, but Claude never chooses the skill itself The settings block does not parse, so the description is lost Run claude plugin validate ~/.claude/skills and correct the error it reports
The same, and the settings are valid The description lacks the words you use, or the skill sets disable-model-invocation: true Name the skill in your request, or edit the description
A skill worked and then stopped being chosen Many skills are installed, and some descriptions were cut to fit Run /doctor in Claude Code and remove skills you do not use
The skill is missing in Cowork or a cloud session Those sessions do not read ~/.claude/skills/ Upload the skill to your Claude account
Claude apps: no Skills page, or skills are greyed out Code execution is switched off Switch it on under Settings > Capabilities, or ask your organization's owner
Claude apps: the upload fails The ZIP is too large, the folder name differs from the skill's name, SKILL.md is missing, or the name has invalid characters Correct the folder and zip it again from the folder above
Codex does not list the skill Codex has not rescanned, or the skill is disabled in ~/.codex/config.toml Restart Codex and check the configuration file
Antigravity CLI does not list the skill The list is stale, or the skill sits in a project's old .gemini/skills/ folder Run /skills reload, then /skills. Move an old .gemini/skills/ folder to .agents/skills/

claude plugin validate needs Claude Code 2.1.233 or later. On a folder with one sound skill it printed "Validation passed". When a second skill with a broken settings block was added, it named that skill's SKILL.md and reported "YAML frontmatter failed to parse".

When the same skill name exists in two places, the tool picks one. In Claude Code a personal skill wins over a project skill of the same name.

Before you close the terminal

  • SKILL.md sits directly inside skills/skill-name/.
  • The folder name matches the name in SKILL.md.
  • You have read the instructions and every script.
  • /skills lists the skill.
  • One real request made the tool use the skill.

Common questions

Where are Claude skills stored?

Claude Code reads personal skills from the folder ~/.claude/skills/ and project skills from .claude/skills/ inside the repository. Each skill sits in its own folder with a SKILL.md file. Skills you upload in the Claude apps are kept in your Claude account and appear under Customize > Skills.

Do Claude skills work in Codex and Antigravity CLI?

Yes. Claude Code, Codex and Antigravity CLI all load skills from folders that hold SKILL.md, so the same folder loads in each of them. Codex reads ~/.agents/skills/, and Antigravity CLI reads ~/.gemini/config/skills/ and, inside a project, .agents/skills/. A skill that depends on features only Claude Code has may do less in another tool.

How do I install a Claude skill from GitHub?

Download or clone the repository, find the folder that holds SKILL.md and copy that folder into ~/.claude/skills/. If the repository is a plugin marketplace, run /plugin marketplace add followed by the owner and repository name in Claude Code, then install the plugin you want. Antigravity CLI loads skills from folders, so copy the folder into .agents/skills/ inside a project or into ~/.gemini/config/skills/ for every project.

Do I need to restart Claude Code after I install a skill?

Usually not. Claude Code watches its skills folders and picks up a new or changed skill during the session. The exception is a skills folder that did not exist when the session started. In that case run /reload-skills once, and the skill appears when you run /skills.

Do I need a paid Claude plan to use skills?

Skills in Claude Code are folders on your computer, and its documentation sets no plan requirement for them. For the Claude apps, Anthropic's Help Center lists skills on the Free, Pro, Max, Ultra, Team and Enterprise plans, with code execution switched on, while one of its documentation pages names the paid plans only.

First published .

Sources and further reading (8)
Back to all guides
Keep exploring

A good next read.