安装指南

把任意 Skill 安装到你的 Agent

先选一种一键安装方式;如果命令失败,再按下面的目录表手动放入 SKILL.md。所有步骤都围绕可复制、可回退、可验证。

1. 准备运行环境

如果你完全不懂命令行,按顺序做:安装 Node.js LTS → 重新打开终端 → 输入 node -v 和 npm -v 验证 → 回到 Skill 详情页复制一键安装命令。

2. 一键安装流程

  1. 先确认你要装到哪个 Agent:Claude Code、Cursor、Codex、Cline 等目录不同。
  2. 打开目标 Skill 详情页,在右侧“一键安装”里选择 npx / pnpm dlx / bunx。新手优先用 npx。
  3. 点击复制,把命令粘贴到终端执行。执行目录不重要,命令会把 Skill 放到对应目录。
  4. 执行结束后重启或刷新 Agent,让它重新扫描 skills 目录。
  5. 在对话里点名这个 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

重新打开 Agent 后问:“你能识别某某 Skill 吗?请先不要执行,只说明触发条件。”

跑小任务

用一个无风险样例测试输出格式。涉及写文件、联网或命令时,先让 Agent 列计划再执行。

5. 常见问题处理

命令不存在

先安装 Node.js LTS,并重新打开终端。pnpm 和 Bun 用户分别按官网安装后再执行。

Agent 没有识别 Skill

检查目录层级必须是 skill-name/SKILL.md;保存后重启 Agent 或新开一个项目窗口。

需要 API Key

只在本机环境变量里配置,不要写进 SKILL.md、仓库或截图。详情页档案会标出可能需要的服务。