一句话:Skill 的安装本质上就一件事——把 Skill 文件夹放进你的 AI 工具认得到的地方。不同客户端路径不同,本文给你三种最常见装法。
安装前先理解:Skill 只是「文件 + 目录」,装它不需要运行什么程序,复制文件(或一条命令)即可。
方法 ①:Claude Code(命令行,最常用)
如果你是开发者,Claude Code 是最常用的 Skill 宿主。两种装法:
A. 装别人的合集(一条命令)
/plugin marketplace add obra/superpowers ← 添加一个 Skill 市场
/plugin install superpowers@workspace ← 安装到当前项目(共享给团队用)
/plugin install superpowers@user ← 安装到个人(所有项目可用)
在 Claude Code 对话框里直接输入(斜杠开头)即可,装完自动生效。
B. 自己放一个 Skill 目录
# 在项目里创建 .claude/skills/ 目录,把 Skill 文件夹放进去
my-project/
├── .claude/
│ └── skills/
│ └── my-skill/
│ ├── SKILL.md
│ └── scripts/
放好后重启 Claude Code(或新开会话),Skill 即被识别。
方法 ②:Claude Desktop(图形界面)
- 打开 Claude Desktop → 设置(Settings)
- 进入 开发者(Developer) 区域
- 找到 Skills 目录配置,将本机 Skills 目录指向你存放 Skill 文件夹的位置(如
~/skills) - 把 Skill 文件夹复制进该目录 → 重启 Claude Desktop
不同版本界面略有差异,以客户端内「Skills」相关设置项为准。
方法 ③:Cursor / VS Code 系编辑器
- 在你项目的 根目录 使用对应 AI 插件的 skills 目录约定(如 Cursor 的
.cursor/rules/或工具官方 Skills 路径) - 把 Skill 文件夹放进约定目录
- 重载窗口(
Ctrl+Shift+P → Reload Window)生效
各 IDE 的 Skill 目录约定随版本更新较快,装不上时优先看对应插件官方文档。
常见问题排查
| 问题 | 原因 | 解决 |
|---|---|---|
| 装完 AI 不认 | 没重启客户端/新会话 | 重启,重启前检查目录拼写 |
| 不触发 Skill | description 触发条件太窄 | 把常见说法都写进 description(参考写法详解) |
| 报找不到插件市场 | /plugin 命令只在对应版本支持 | 更新客户端,或用「手动放目录」方式 |
| 想卸载 Skill | — | 删除对应文件夹或执行 /plugin uninstall |
装完怎么验证?
- 在 AI 对话里直接说一次触发场景,如「帮我写个周报」
- 观察输出是否按 Skill 的格式走了(比如周报按「成果/问题/计划」三区)
- 没触发就检查目录路径与 description(最常卡在两处)
相关阅读
- 装哪些:10 个最值得装的 Skill
- 写一个自己的:创建教程 / 写法详解
- Skill 与 MCP 联合使用:对比文