Claude Code Skill 怎么安装使用：3 种方法

Claude Code 的 Skill（技能）是一套可以反复调用的工作方法：把一段固定流程写成 SKILL.md，Claude 需要时自动加载，或者你输入 /skill名 直接调用。你反复往对话里粘贴的同一套说明、检查清单、多步流程，都值得做成一个 Skill。本站Skills 专题收录了不少现成的 Skill 合集，但装之前得先会装：下面 3 种方法全部按Claude Code 官方 Skills 文档核过，照着做就行。

先搞清：Skill 是什么、放在哪

一个 Skill 就是一个文件夹，里面必须有一个 SKILL.md：文件开头是 --- 包起来的 YAML frontmatter（写这个 Skill 是干什么的、什么时候用），后面是 Markdown 写的操作步骤。Claude 平时只读每个 Skill 的名字和描述，判断你的请求和哪个相关，才把完整内容加载进来；你也可以直接输入 /skill名 调用。

放哪决定了它在哪些会话里生效：

• 个人：~/.claude/skills/<skill名>/SKILL.md——这台电脑所有项目都能用，但 Cowork 和云端会话读不到；
• 项目：.claude/skills/<skill名>/SKILL.md——只在当前仓库生效，提交进 Git，团队自动拿到；
• 插件：<plugin>/skills/<skill名>/SKILL.md——随插件分发，调用要带前缀，写成 /插件名:skill名；
• claude.ai 同步——账号里启用的 Skill 会同步到终端会话，存在 ~/.claude/skills/synced/ 里。

同名 Skill 出现在多个位置时，优先级是企业级 > 个人 > 项目。注意：别把自己的 Skill 文件夹起名为 synced，那是同步 Skill 专用的目录。Claude Code 还自带一批开箱即用的 Skill，比如 /doctor（安装体检）、/code-review、/batch、/debug、/loop、/claude-api。

方法 1：复制一个现成的 Skill 文件夹

最快的方法：找到别人开源的 Skill，只复制装着 SKILL.md 的那个文件夹，不要整个仓库搬过来。官方文档明确提醒：克隆一个装满 Skill 的仓库本身不等于安装，Claude Code 只认放在上面那几个指定位置里的 Skill。

1. 把 Skill 文件夹拷到个人位置（所有项目都能用）：

   cp -r /tmp/<仓库>/<路径>/<skill名> ~/.claude/skills/

   只想给当前项目用，就拷到项目根目录的 .claude/skills/ 里，顺手 git commit 提交，团队成员同步仓库后自动获得。

2. 验证：打开 Claude Code，输入 /skills，看列表里有没有这个 Skill；或者直接输入 /，看自动补全里出不出现 /<skill名>。
3. 调用一次：输入 /<skill名>，看 Claude 是不是按 Skill 里的流程开始干活。是，就是装好了。

现成的例子：本站介绍过47 个免费 Claude Code SEO 技能，作者的安装脚本本质上就是把 47 个 Skill 文件夹拷进 ~/.claude/skills；去 AI 味 Skill 的实测则讲了一个 Skill 怎么做检测再改写，装好后可以对照着试。

方法 2：自己写一个 SKILL.md

没有现成的，就自己写一个。按官方文档，一个能用的 Skill 最少只需要两部分：

1. 新建文件夹并写文件：

   mkdir -p ~/.claude/skills/summarize-changes

   然后在里面新建 SKILL.md（官方文档“创建你的第一个 Skill”的例子结构）：

   ---
   name: summarize-changes
   description: 汇总当前 Git 仓库未提交的改动，并标出有风险的地方
   ---
   # 汇总改动
   1. 先运行 git status 和 git diff 看当前改动
   2. 按文件分组汇总，每组一句话说明改了什么
   3. 标出可能有风险的改动，比如删了导出、改了鉴权逻辑

2. frontmatter 的写法：字段名用小写加连字符（when_to_use 除外），只有 description 是官方推荐必填的——它决定 Claude 什么时候自动加载这个 Skill，写清楚触发场景比写长正文更重要。name 不写也行，默认用文件夹名当命令名；想让 Claude 只在你手动调用时才用，就加一行 disable-model-invocation: true。
3. 验证：保存后不用重启，Claude Code 会监听 skills 目录的改动，当前会话内自动生效，直接输入 /summarize-changes 测试一次。如果是新建的顶层 skills 目录（之前 ~/.claude/skills/ 根本不存在），运行一次 /reload-skills 让 Claude Code 开始监听这个目录。

方法 3：从插件市场安装

很多 Skill 跟着插件一起分发，装插件就等于装了它里面的 Skill。按官方插件安装文档，流程分两步：

1. 先加市场：官方市场（claude-plugins-official）一般在你第一次打开交互式终端会话时自动加上；Anthropic 的官方 Skill 市场要手动加一次：

   /plugin marketplace add anthropics/skills

   只加一次，以后不用重复。

2. 再装插件：在会话里输入 /plugin install <插件名>@<市场名>，比如官方市场的 skill-creator 插件就是 /plugin install skill-creator@claude-plugins-official。不想进会话，在终端直接跑 shell 版也行：claude plugin install <插件名>@<市场名>。新机器上如果提示官方市场不存在，先跑 claude plugin marketplace add anthropics/claude-plugins-official 再装。
3. 验证：输入 /，在插件名下面找 /<插件名>:<skill名> 形式的命令；或者进 /plugin 的 Installed 选项卡，确认插件在列表里且处于启用状态。插件里的 Skill 调用时要带前缀。

补充：Anthropic 官方 skills 仓库（github.com/anthropics/skills）里的 Skill 还能用命令行一键装，官方平台文档给的例子是 npx skills add https://github.com/anthropics/skills --skill claude-api。

装完确认生效：3 个检查

1. /skills 看列表：输入 /skills，装好的 Skill 会出现在列表里；从 claude.ai 同步来的会单独列在 claude.ai sync 分组下。
2. / 看补全：输入 /，自动补全里出现 /<skill名>，说明命令名注册成功。
3. 直接调用一次：输入 /<skill名>，或者提一个和 Skill 描述相关的需求，看 Claude 会不会自动加载它。没触发时先检查 description 写得够不够具体——描述模糊是 Skill 不触发最常见的原因。

还有两个提醒：第一，个人位置的 Skill 在云端会话和 Cowork 会话里不可用，要在那些会话里用，得在 claude.ai 账号里启用这个 Skill（终端会话同步需要 Claude Code v2.1.273 或更高版本）；第二，装陌生人的 Skill 之前先读一遍 SKILL.md，重点看 frontmatter 里的 allowed-tools——它会预先批准 Skill 在调用那一轮里用的工具，团队共享仓库里的 Skill 尤其要先检查这一项再跑。

常见问题

装了但 / 补全里找不到？先看放的位置对不对：文件夹里必须有 SKILL.md，且要直接放在 ~/.claude/skills/ 或 .claude/skills/ 下，不要多套一层目录；再看名字有没有特殊字符（比如零宽空格、<），官方文档说带这类字符的文件夹名不会被加载；最后运行 /reload-skills 刷新一次。

项目和个人位置有同名 Skill，跑哪个？个人位置优先于项目（企业级 > 个人 > 项目）。插件里的 Skill 和本地 Skill 同名时两个都能用，插件的那个带前缀调用。

装太多 Skill 会不会变慢？会占一点上下文：每个 Skill 的名字和描述在每轮对话里都会加载，官方文档说这部分预算大约是模型上下文窗口的 1%。只留常用的，不用的直接删文件夹就行，当前会话里立即生效。

一句话总结：会装 Skill 只是第一步，真正省时间的是把你每周重复做 3 次以上的流程写成自己的 Skill——先从复制一个现成的开始，跑通一次，再写自己的。