把任意 Skill 安装到你的 Agent
先选一种一键安装方式;如果命令失败,再按下面的目录表手动放入 SKILL.md。所有步骤都围绕可复制、可回退、可验证。
1. 准备运行环境
如果你完全不懂命令行,按顺序做:安装 Node.js LTS → 重新打开终端 → 输入 node -v 和 npm -v 验证 → 回到 Skill 详情页复制一键安装命令。
npx
npx skills add <owner/repo> --skill <slug> -g -a <agent> -y 推荐新手优先选这个。先安装 Node.js LTS,重新打开终端后即可使用 npm / npx。
打开 Node.js 下载页 → pnpm dlxpnpm dlx skills add <owner/repo> --skill <slug> -g -a <agent> -y 适合已经在项目里使用 pnpm 的开发者。新手可以先用 npx,等熟悉后再切换。
查看 pnpm 安装方式 → bunxbunx skills add <owner/repo> --skill <slug> -g -a <agent> -y 适合已经安装 Bun 的环境,速度快;如果不确定自己有没有 Bun,先不要选它。
打开 Bun 安装文档 →2. 一键安装流程
- 先确认你要装到哪个 Agent:Claude Code、Cursor、Codex、Cline 等目录不同。
- 打开目标 Skill 详情页,在右侧“一键安装”里选择 npx / pnpm dlx / bunx。新手优先用 npx。
- 点击复制,把命令粘贴到终端执行。执行目录不重要,命令会把 Skill 放到对应目录。
- 执行结束后重启或刷新 Agent,让它重新扫描 skills 目录。
- 在对话里点名这个 Skill,给出目标文件、限制和期望输出;先用小任务验证,再交给它大任务。
3. 手动安装目录
| Agent | 放置位置 | 操作方式 |
|---|---|---|
| Claude Code | ~/.claude/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Cursor | ~/.cursor/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Cline | ~/.agents/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Codex | ~/.codex/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Windsurf | ~/.codeium/windsurf/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Gemini | ~/.gemini/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| OpenCode | ~/.config/opencode/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Roo Code | ~/.roo/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Aide | 手动安装(路径未验证) | 先查阅该 Agent 的最新官方文档。 |
| Augment | ~/.augment/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| GitHub Copilot | ~/.copilot/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| OpenClaw | ~/.openclaw/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Kiro | ~/.kiro/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Junie | ~/.junie/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Warp | ~/.agents/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Goose | ~/.config/goose/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Trae | ~/.trae/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Kilo Code | ~/.kilocode/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| OpenHands | ~/.openhands/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Amp | ~/.config/agents/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Zencoder | ~/.zencoder/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Continue | ~/.continue/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Aider | 手动安装(路径未验证) | 先查阅该 Agent 的最新官方文档。 |
| CodeBuddy | ~/.codebuddy/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| CodeGeeX | 手动安装(路径未验证) | 先查阅该 Agent 的最新官方文档。 |
| Replit Agent | ~/.config/agents/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
4. 验证是否安装成功
目录里应该能看到 skill-name/SKILL.md。如果只有一个压缩包或多套嵌套目录,解压层级通常错了。
重新打开 Agent 后问:“你能识别某某 Skill 吗?请先不要执行,只说明触发条件。”
用一个无风险样例测试输出格式。涉及写文件、联网或命令时,先让 Agent 列计划再执行。
5. 常见问题处理
命令不存在
先安装 Node.js LTS,并重新打开终端。pnpm 和 Bun 用户分别按官网安装后再执行。
Agent 没有识别 Skill
检查目录层级必须是 skill-name/SKILL.md;保存后重启 Agent 或新开一个项目窗口。
需要 API Key
只在本机环境变量里配置,不要写进 SKILL.md、仓库或截图。详情页档案会标出可能需要的服务。