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 |
- Download the skill and find the folder that directly contains
SKILL.md. - Create the skills folder if it does not exist:
mkdir -p ~/.claude/skills - Copy the skill folder into it:
cp -R skill-name ~/.claude/skills/ - In Claude Code, run
/skills. The skill should be in the list. - 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.
- 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/ - Check the archive:
unzip -l skill-name.zip. Every line should begin withskill-name/. IfSKILL.mdappears without that prefix, you zipped the contents and not the folder. - In Claude, open Customize > Skills.
- Select the "+" button, then "Create skill", then "Upload a skill", and choose the ZIP file.
- 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.mdsits directly insideskills/skill-name/.- The folder name matches the
nameinSKILL.md. - You have read the instructions and every script.
/skillslists 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.
Sources and further reading (8)
- Claude Code documentation: Extend Claude with skills
- Claude Code documentation: Install and manage plugins
- Claude Help Center: Use skills in Claude
- Claude documentation: Skills overview
- OpenAI documentation for ChatGPT and Codex: Build skills
- Google Antigravity documentation: Agent skills
- Agent Skills specification
- Knacco Prompt Writing Guide: requirements and contents


