Guides / Install guides

How to install Agent Skills in Claude, Codex, Gemini CLI, Cursor and Copilot

Where each tool looks for SKILL.md skills, the one command that works across tools, and a step-by-step page for each. Checked against each tool's own docs on 4 October 2026.

An Agent Skill is a folder with a SKILL.md file in it. Installing one means putting that folder where your tool looks for skills. Each tool has its own paths, so we checked the official docs for each one and link them below. Where the docs did not say, we say so and point you to them.

We use our free repo, proskillpacks/skills, as the worked example throughout.

The route that works in most tools

Run this in your project folder:

npx skills add proskillpacks/skills

It uses the open-source skills command line tool (README), asks which skills and which tools you want, and copies them into the right folders. Add --list to see what is in the repo first, --skill <name> to take one skill, -a <tool> to pick a tool and -g to install for your whole machine instead of one project. It needs Node.js.

If you do not want to run it, copy the skill's folder by hand into your tool's skills folder, using the table below.

Where each tool looks

ToolProject folderYour own (all projects)Page
Claude Code.claude/skills/~/.claude/skills/Claude Code
claude.ainot a folder: upload a ZIPCustomize, Skillsclaude.ai
Codex.agents/skills/~/.agents/skills/Codex
Gemini CLI.gemini/skills/ or .agents/skills/~/.gemini/skills/ or ~/.agents/skills/Gemini CLI
Cursor.cursor/skills/ or .agents/skills/~/.cursor/skills/ or ~/.agents/skills/Cursor
GitHub Copilot.github/skills/, .claude/skills/ or .agents/skills/~/.copilot/skills/ or ~/.agents/skills/GitHub Copilot
ChatGPT or any chatbotno installpaste prompt.mdPaste-in prompt

Notice what the docs say about .agents/skills/: Codex, Gemini CLI, Cursor and Copilot all document it. Claude Code's skills page lists .claude/skills/ and does not mention .agents/skills/, so for Claude Code use the .claude folder or the npx skills command.

Worked example: one skill by hand

  1. Download the repo: git clone https://github.com/proskillpacks/skills.
  2. Pick a skill folder, for example skills/ecommerce/shopify-policy-checker.
  3. Copy that folder into your tool's skills folder from the table, keeping the folder name: for example .agents/skills/shopify-policy-checker/.
  4. Start a new session in your tool, so it picks the skill up.
  5. Ask for the job in plain words, for example: "Check the refund and shipping policies on https://example-store.com".

If it does not show up

  • Check the folder holds a file named exactly SKILL.md, one level down: skills/<name>/SKILL.md, not skills/<name>/<name>/SKILL.md.
  • Restart the session. Several tools read the skills folder only when a session starts.
  • Look at your tool's own skill list, if it has one. Gemini CLI has /skills list, for example.
  • Some skills run a small script and need Python 3. The skill's README says so.

Limits

  • Tools change their paths and commands. This was checked on 4 October 2026. If a path here fails, the linked official doc is the authority.
  • We did not run every command on every tool. Each tool page says what we read and what we did not test.

Browse all skills in the catalog

Pick your assistant: which assistants our skills work with.