free-ai-lab free-ai-lab

Skill 安装教程

教程

Claude Code / Claude Desktop / Cursor 三种装法 + 常见问题排查。

一句话: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(图形界面)

  1. 打开 Claude Desktop → 设置(Settings)
  2. 进入 开发者(Developer) 区域
  3. 找到 Skills 目录配置,将本机 Skills 目录指向你存放 Skill 文件夹的位置(如 ~/skills
  4. 把 Skill 文件夹复制进该目录 → 重启 Claude Desktop

不同版本界面略有差异,以客户端内「Skills」相关设置项为准。

方法 ③:Cursor / VS Code 系编辑器

  1. 在你项目的 根目录 使用对应 AI 插件的 skills 目录约定(如 Cursor 的 .cursor/rules/ 或工具官方 Skills 路径)
  2. 把 Skill 文件夹放进约定目录
  3. 重载窗口(Ctrl+Shift+P → Reload Window)生效

各 IDE 的 Skill 目录约定随版本更新较快,装不上时优先看对应插件官方文档。

常见问题排查

问题 原因 解决
装完 AI 不认没重启客户端/新会话重启,重启前检查目录拼写
不触发 Skilldescription 触发条件太窄把常见说法都写进 description(参考写法详解
报找不到插件市场/plugin 命令只在对应版本支持更新客户端,或用「手动放目录」方式
想卸载 Skill删除对应文件夹或执行 /plugin uninstall

装完怎么验证?

  1. 在 AI 对话里直接说一次触发场景,如「帮我写个周报」
  2. 观察输出是否按 Skill 的格式走了(比如周报按「成果/问题/计划」三区)
  3. 没触发就检查目录路径与 description(最常卡在两处)

相关阅读