Install any skill into your agent
Pick one runner first; if the command fails, use the directory table below and place SKILL.md manually. Every step is copyable, reversible, and verifiable.
1. Prepare your runtime
If you are new to the terminal, follow this order: install Node.js LTS → reopen Terminal → run node -v and npm -v → return to the skill page and copy the install command.
npx skills add <owner/repo> --skill <slug> -g -a <agent> -y Best default for beginners. Install Node.js LTS, reopen Terminal, then npm / npx will be available.
Open Node.js download → pnpm dlxpnpm dlx skills add <owner/repo> --skill <slug> -g -a <agent> -y Good if your projects already use pnpm. Beginners can start with npx first.
View pnpm install → bunxbunx skills add <owner/repo> --skill <slug> -g -a <agent> -y Fast for Bun users. If you are not sure Bun is installed, use npx first.
Open Bun install docs →2. One-click flow
- First decide which agent you are installing into: Claude Code, Cursor, Codex, Cline, and others use different folders.
- Open a skill detail page and choose npx / pnpm dlx / bunx in the install panel. Beginners should choose npx.
- Click Copy, paste the command into Terminal, and run it. The current terminal directory usually does not matter.
- After the command finishes, restart or reload the agent so it rescans the skills folder.
- Name the skill in chat, provide files, constraints, and expected output; validate with a small task before using it on a large one.
3. Manual install paths
| Agent | Install path | Action |
|---|---|---|
| Claude Code | ~/.claude/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Cursor | ~/.cursor/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Cline | ~/.agents/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Codex | ~/.codex/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Windsurf | ~/.codeium/windsurf/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Gemini | ~/.gemini/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| OpenCode | ~/.config/opencode/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Roo Code | ~/.roo/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Aide | Manual install (path not verified) | Check the agent’s current official documentation first. |
| Augment | ~/.augment/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| GitHub Copilot | ~/.copilot/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| OpenClaw | ~/.openclaw/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Kiro | ~/.kiro/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Junie | ~/.junie/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Warp | ~/.agents/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Goose | ~/.config/goose/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Trae | ~/.trae/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Kilo Code | ~/.kilocode/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| OpenHands | ~/.openhands/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Amp | ~/.config/agents/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Zencoder | ~/.zencoder/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Continue | ~/.continue/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| Aider | Manual install (path not verified) | Check the agent’s current official documentation first. |
| CodeBuddy | ~/.codebuddy/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
| CodeGeeX | Manual install (path not verified) | Check the agent’s current official documentation first. |
| Replit Agent | ~/.config/agents/skills/ | Create the skill folder, place the full SKILL.md, save, then reload the agent. |
4. Verify the installation
You should see skill-name/SKILL.md. If you only see a zip file or nested folders, the extraction level is wrong.
After reopening the agent, ask: “Can you recognize this skill? Do not run it yet; explain its trigger.”
Use a low-risk sample to test the output shape. For file writes, network calls, or shell commands, ask for a plan first.
5. Common fixes
Command not found
Install Node.js LTS and reopen Terminal. Install pnpm or Bun first if you choose those runners.
Agent does not see the skill
Check the folder shape is skill-name/SKILL.md; then restart the agent or open a new project window.
API key required
Put keys in local environment variables only; never commit them. Detail profiles list likely vendors.