How to Install an AI Agent Skill
A plain-language guide for everyone. Most people are done in under a minute.
First: what is a skill?
A skill is a folder of written instructions (and sometimes small scripts) that teaches your AI assistant how to do one job well — for example "write release notes" or "fill in a PDF form".
The main file is always called SKILL.md. Put the folder where your assistant looks for skills and it picks it up by itself. You don't have to call it — just ask for the task.
Three ways to install — pick one
Let your assistant do it (easiest)
Works in Claude Code, Cursor, Codex and Gemini CLI.
- Open any skill page on SkillHub.
- In the install box, open the Ask your AI agent tab.
- Choose your assistant and click Copy Prompt.
- Paste it into your assistant's chat. It downloads and sets up the skill for you.
Run one command (if you use a terminal)
Copy the command from the skill page. It downloads the skill into your assistant's skills folder. It looks like this:
Download a ZIP (no terminal needed)
Download the ZIP from the skill page and unzip it into your assistant's skills folder (listed below). Using Claude.ai in the browser? Follow the Claude.ai guide instead.
Where skills go, by assistant
Click your assistant for full step-by-step setup.
Claude.ai
Check their docsClaude.ai Projects → Project Instructions
Claude.ai setup guide →Claude Code
Tested~/.claude/skills/<skill-name>/SKILL.md
Claude Code setup guide →Codex CLI
Tested~/.codex/AGENTS.md
Codex CLI setup guide →Cursor
TestedCursor Settings → Rules (global rules UI)
Cursor setup guide →Gemini CLI
Tested~/.gemini/skills/<skill-name>/SKILL.md
Gemini CLI setup guide →Hermes Agent
Tested~/.hermes/skills/<skill-name>/SKILL.md
Hermes Agent setup guide →Skills, plugins and MCP servers — what's the difference?
You'll see these three words a lot. New? Start with skills.
One folder with a SKILL.md file. Teaches your assistant one task. Works in most assistants.
A Claude Code bundle: several skills plus slash commands, helper agents and automatic actions. Installs with one command.
A connector that lets your assistant use another app or service — like a database, GitHub or your calendar.
How to install a Claude Code plugin
Browse plugins →Type these in Claude Code. Each plugin page shows the exact names to use.
Tell Claude Code where the plugin lives (a GitHub repo):
/plugin marketplace add <owner/repo>
Install it by name:
/plugin install <plugin-name>@<marketplace-name>
Turn the new plugin on without restarting:
/reload-plugins