把任意 Skill 安装到你的 Agent
先选一种一键安装方式;如果命令失败,再按下面的目录表手动放入 SKILL.md。所有步骤都围绕可复制、可回退、可验证。
1. 准备运行环境
如果你完全不懂命令行,按顺序做:安装 Node.js LTS → 重新打开终端 → 输入 node -v 和 npm -v 验证 → 回到 Skill 详情页复制一键安装命令。
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/rules/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Cline | .clinerules | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Codex | AGENTS.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Windsurf | .windsurf/rules/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Gemini | ~/.gemini/GEMINI.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| OpenCode | AGENTS.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Roo Code | .roo/rules/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Aide | ~/.aide/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Augment | .augment/instructions.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| GitHub Copilot | .github/copilot-instructions.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| OpenClaw | ~/.openclaw/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Kiro | .kiro/steering/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Junie | .junie/guidelines.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Warp | AGENTS.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Goose | ~/.config/goose/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Trae | AGENTS.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Kilo Code | .kilocode/rules/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| OpenHands | AGENTS.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Amp | AGENTS.md | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Zencoder | ~/.zencoder/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Continue | .continue/rules/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Aider | .aider.conf.yml | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| CodeBuddy | ~/.codebuddy/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| CodeGeeX | ~/.codegeex/skills/ | 创建 skill 文件夹,放入完整 SKILL.md,保存后刷新 Agent。 |
| Replit Agent | .replit | 创建 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、仓库或截图。详情页档案会标出可能需要的服务。