一、SKILL 到底是个啥?
简单来说,SKILL 是 Claude Code 的“技能包”或“经验模块”。它的物理载体极其轻量,本质上就是一个包含特定提示词和工作流程的 Markdown 文件(SKILL.md)。
你可以把它理解为把专家的结构化经验打包成可复用的模块:
比如,你配置了一个“公众号排版技能”,当你写完文章后,它能自动将 Markdown 转换为完美的 HTML 格式;再比如,再比如,你配置了一个“代码审查(CR)技能”,它就能严格按照团队的标准,自动从安全性、可维护性等维度帮你审查代码。

它有三个关键特点:
1.高复用性:一次编写,在后续的所有对话和项目中都能反复调用。
2.强分享性:别人写好的技能夹,你直接复制过来就能瞬间“满血复copy”。
3.渐进式披露(Progressive Disclosure):这是它比 MCP 高明的地方。启动时它只向 Claude 加载 30~50 字节的 YAML 元数据;只有当你的需求触发了它,它才会动态加载完整的提示词和脚本,极大地节省了 Token 消耗。

二、Skill 与 Plugin 的本质区别
很多新手在翻阅目录时,容易被 skills 和 plugins 两个词搞晕。从文件架构上看,两者的边界非常清晰:
- SKILL(能力模块):它是一个专注于解决某类具体任务的独立目录。核心是
SKILL.md(包含规则和流程),旁边可以挂载一些辅助的参考资料或脚本。 - PLUGIN(能力容器):它更像是一个完整的组件安装包。一个 Plugin 目录下通常包含一个
plugin.json配置文件(声明),Plugin的内部可以同时打包多个 SKILL,甚至连同 hooks(钩子)、agents(子代理)以及 MCP servers 一起封装。

一句话总结:SKILL 是原子化的“能力模块”,而 Plugin 是打包了多个能力模块与底层配置的“集装箱”。
三、手把手教你:如何安装别人的 SKILL
在使用或创建 SKILL 之前,我们需要明确 Claude Code 的目录层级。目前系统支持三层目录规范:
| 级别 | 存放路径 | 生效范围与特点 |
|---|---|---|
| 全局/用户级 | ~/.claude/skills/Windows 路径参考_: C:\Users\你的用户名\.claude\skills\Mac / Linux 路径参考_: /Users/你的用户名/.claude/skills/ 或 ~/.claude/skills/ | 对当前用户的所有项目生效(适合写文档、通用工具等) |
| 项目级 | 当前项目根目录/.claude/skills/ | 仅在当前代码仓库生效(适合项目规范、专属部署脚本) |
| 嵌套目录级 | 子包目录(如 apps/web/.claude/skills/) | 2026最新支持,适合 Monorepo 大仓,自动带路径前缀调用 |
覆盖优先级:嵌套级配置 >>> 项目级别配置 >>> 全局个人配置 >>> Claude 内置默认技能。
搞清楚路径后,我们可以通过以下三种方式安装现成的技能:
方式一:手动复制(最直接)
如果你在 GitHub 上看到别人分享了一个写好的 Skill,它通常是一个普通的文件夹(比如名叫 git-helper),里面躺着一个 SKILL.md,有时可能还会带有一些辅助的 Python 脚本或说明文档。你只需要把整个文件夹下载下来,直接粘贴到上述的路径中即可:
~/.claude/skills/
└── git-helper/ <-- 这是你刚刚拷过来的文件夹
├── SKILL.md <-- 核心文件,必须是全大写
└── read_me.txt <-- 可选的其他辅助文件
重新唤醒 Claude Code,它就会自动扫描并识别。
方式二:利用第三方工具一键安装
如果你在逛 skills.sh、skillsmp 这种专门的 Skill 分享网站,你会发现很多大佬根本不提供打包下载,而是直接在网页上甩给你一行命令。这行命令通常长这样:
npx skills add [https://github.com/username/repo](https://github.com/username/repo) --skill skill-name
这个命令本质上就是帮你自动下载Skill文件,然后放到正确的目录里,省得你自己去clone仓库、手动复制。
注:使用 bunx 或 pnpm dlx 也是完全一样的,它们都是前端开发中用来“临时下载并执行某个工具”的命令。你完全不用纠结用哪个,根据你电脑里装了什么包管理器,直接在终端里复制执行就行:
- 如果你平时用 Node.js,那就用
npx skills add... - 如果你平时用 Bun,那就用
bunx skills add... - 如果你平时用 pnpm,那就用
pnpm dlx skills add...
方式三:安装 Plugin
如果你要装的不是单个Skill,而是一个完整的插件,那就在Claude Code的对话框里用斜杠命令来安装。
根据这个插件来源的不同,有两种安装口令:
1.从 Anthropic 官方生态市场
直接执行 /plugin install 插件名@claude-plugins-official
# 安装官方市场的插件
/plugin install superpowers@claude-plugins-official

执行命令后,Claude Code 会弹出对话框让你选择安装范围:全局(user)、项目共享(project) 还是 仅本项目(local)。
2.从社区第三方扩展市场
需要先添加这个市场:/plugin marketplace add 市场地址,然后再安装:/plugin install 插件名@市场名
# 安装第三方市场的插件
/plugin marketplace add https://market.example.com # 绑定第三方市场
/plugin install plugin-name@market-name # 执行安装命令
小白避坑指南:不管用哪种方式,它们的最终殊途同归——那就是把技能文件规规矩矩地码放到了你电脑的指定位置。只要安装成功,插件里自带的各种 Skill 就会全部自动激活,你不需要再去改任何系统配置,直接开始享受它带来的便利即可!
四、如何创建属于自己的 SKILL
一个高标准的 SKILL 文件夹里,通常由一个核心 SKILL.md 和若干可选的配套脚本(Python/Bash)组成。其中,SKILL.md 的结构极其讲究,分为元信息和正文指南两部分。
我们以编写一个专门的代码审查技能(code-reviewer)为例:
步骤 1:创建技能文件夹
在你的全局技能目录 ~/.claude/skills/ 下新建一个文件夹,起名为 code-reviewer。
注意:在 Mac 或 Windows 下,以
.开头的文件夹(如.claude)默认是隐藏的。Mac 用户可按Cmd + Shift + .显示隐藏文件夹;Windows 用户请在文件资源管理器上方勾选“显示隐藏文件”。
步骤 2:新建核心文件
在文件夹内右键新建一个文本文档,命名为 SKILL.md(**必须全大写,且确保后缀是 .md)。
步骤 3:编写文件内容
打开文件,完美写入以下模板结构:
---
name: code-reviewer
description: 对代码变更进行系统性审查,发现潜在Bug、安全漏洞和设计问题。当用户输入关键词如"帮我review代码"、"审查这个PR"、"检查这段代码有没有问题"时自动触发。
---
# 代码审查技能
你现在是一名经验丰富的软件工程师,正在进行一场严格的代码审查。请针对用户提供的代码变更或文件,从正确性、安全性、可维护性和性能四个维度进行全面分析。
## 审查流程
1. **理解意图**:先明确这段代码要解决什么问题,不要只抠细节而忽视整体逻辑。
2. **逐项排查**:
- **正确性**:逻辑是否存在边界条件未处理?有无空指针/未捕获异常?
- **安全性**:是否存在SQL注入、XSS、敏感信息泄露风险?
- **可维护性**:命名是否清晰?函数是否过长?有无重复代码?
- **性能**:是否有不必要的循环、内存泄漏或慢查询?
3. **给出结论**:总结核心问题,并标注优先级(阻塞 / 建议优化 / 可忽略)。
## 输出格式
- 按文件/函数分组,每条问题单独列出。
- 每条问题包含:**问题描述** → **影响** → **修改建议**。
- 结尾给出整体评价(通过/有条件通过/不通过)。
## 禁忌
- 禁止只说"代码写得不错"而不给出具体分析。
- 禁止只挑格式问题(如缩进、空格)而忽略逻辑缺陷。
- 如果用户提供了PR链接,先尝试获取变更内容,再开始审查。
1.元信息
用三道杠 --- 包裹的“元信息”:这部分是写给 Claude Code 系统的“路标”。
name:技能的唯一 ID。以后你在终端里敲斜杠命令时,输入/code-reviewer调用的就是它。description:这是整个技能的灵魂! 它是写给 Claude 的触发小锦囊。里面一定要包含高频词(如"帮我review代码"、“审查这个PR”)。当你在聊天中提到了这些词,Claude 就会通过这段描述完成语义匹配,自动在后台把这个技能包解压并套用。
2.正文部分
这部分是写给 Claude “大脑”的。格式就是最普通的 Markdown。你在里面怎么写提示词,Claude 就会怎么严格执行。分步骤、列要求(1. 2. 3.)、划定规矩(审查流程、输出格式、禁忌),写得越清晰,AI 输出的质量就越高。
如果你觉得自己手写太麻烦,还有两个更轻松的方式:
-
让 Claude 帮你写:你可以在对话框直接对它说:“帮我写一个专门用来重构前端老旧组件的 Skill。” Claude 会自动写好并直接写入到
.claude/skills/对应位置。 -
使用内置技能:在终端输入
/skill-creator,这是一个官方内置的脚手架工具,它会以问答的形式引导你完成创建、测试与调优。
五、怎么触发使用
技能塞进去了,在日常开发中怎么把它唤醒呢?主要有以下几种方式:
1.自动触发
大多数时候,你根本不需要去想“我今天装了哪些技能”。多亏了我们刚才在 description 里精心编写的描述。
- 操作:你和平常一样,在终端里随口对 Claude 说了一句:“帮我把刚才修 bug 的代码进行仔细审查。”
- 幕后:Claude 听到“代码审查”四个字,瞬间匹配到了
code-reviewer这个技能,它就会在后台悄悄把你的SKILL.md规则加载进大脑。你不需要指定调用谁,它已经按照你定制的规范把内容输出给你了。
所以,description 写得好不好,直接决定了自动触发准不准,这也是为什么我前面说这个字段非常重要。
2.手动强启模式(精准打击)
如果你明确知道某次对话就必须百分之百用这个技能,不需要等语义匹配,直接用斜杠命令。
- 操作:在对话框输入
/,后面跟上你的技能名字。比如:
/code-reviewer,回车的一瞬间,该技能会以最高优先级直接被强行唤醒执行。
3.控制触发行为
有些特殊SKILL具有“副作用”(如自动部署 deploy、或删除文件)。万一 AI 误解了语义自动触发了,后果不堪设想。为此,你可以在在 SKILL.md 开头的元信息中加入两行高级开关来控制它:
---
name: deploy-prod
description: 线上生产环境部署技能。
disable-model-invocation: true # 【风控开关】设为 true 后,Claude 绝不会自动触发它,必须由用户输入 /deploy-prod 手动执行
user-invocable: true # 【菜单开关】是否允许出现在项目的斜杠菜单列表中
---
disable-model-invocation: true: 禁止模型自动调用。哪怕你在聊天中聊到了“我想把代码部署一下”,Claude 也会假装听不懂,绝对不会自作主张去运行它。这个技能只有在你在终端手动输入 /deploy-prod 时,它才会乖乖执行。
user-invocable: false: 不允许用户在 / 菜单中手动调用。如果设为 false,则该技能既不会被自动触发,也不会出现在手动菜单里,只能被其他技能作为子程序调用。
为了方便大家记忆,我们将这两个开关的组合整理如下:
- 标准模式 (
false/true):既可以被关键词自动匹配,也能在菜单手动选。 - 高危风控模式 (
true/true):彻底锁死自动触发,只能由用户手动输入斜杠命令执行。 - 幕后专家模式 (
false/false):隐形调用。不会出现在菜单,也不会被用户关键词触发,只能在 Claude 的复杂任务编排中,被其他主技能作为“子程序”在后台默默调用。
4.SKILLS的查看与管理
当你的技能越装越多,该如何管理它们呢?
如何查看所有技能?
- 方法 A:在输入框直接敲一个单独的
/,Claude 会在终端弹出一个悬浮菜单,列出当前所有可用的命令和技能。你可以继续打字进行模糊筛选。 - 方法 B:在输入框敲命令
/skills。它会单独弹出一个干净清爽的管理面板,把项目内、项目外的技能分门别类展示得一清二楚。
如何彻底停用或删除?
- 自己手写的本地技能:想临时停用?去把元信息改成
disable-model-invocation: true并把user-invocable改成false即可。想彻底不要了?直接去文件夹里把这个技能文件夹整包Delete删掉。没有任何注册表残留,对系统毫无污染。 - 通过插件捆绑进来的技能:不需要翻文件夹,在对话框输入
/plugin命令。它会打开一个可视化管理界面,当前装了哪些插件一目了然,鼠标点一下或者用键盘选中就能一键 Disable(禁用)或者 Uninstall(卸载)。
六、去哪里获取更多顶级 SKILL?
现在的 Agent Skills 生态已经呈现爆发式增长。如果你想寻找灵感或直接扩充武器库,推荐以下三个方向:
1.官方插件市场 (/plugin):在交互界面直接输入 /plugin 即可浏览。Anthropic 官方和社区顶级大牛认证的插件都在这里,质量与安全性最高。
2.聚合社区与开放标准平台:目前 agentskills.io、skills.sh、skillsmp 以及 LobeHub Skills 等平台已经高度成熟。不仅可以按分类、下载量筛选,更重要的是,Anthropic 已经将 Agent Skills 规范作为一项开放标准(Open Standard)推向行业。这意味着你今天在这里学会编写的 SKILL.md,未来在 Cursor、Gemini CLI 等其他支持该标准的 AI 代理工具里同样通用。
3.GitHub 开源生态:直接在 GitHub 检索关键字 "claude code skill" 或 "claude code plugin"。你会发现大量前沿的工程实践(比如结合了本地 Python/Bash 脚本的复杂黑科技技能)都是在这里首发。
总结
搞懂并用好 SKILL,是把 Claude Code 从一个“好用的 AI 聊天框”升华为“企业级生产力外挂”的必经之路。
它用最轻量的 Markdown 语法、最省 Token 的渐进式加载机制,完美锁定了我们的开发工作流。建议大家立刻动手,在你的 ~/.claude/skills/ 下建立第一个属于你自己的定制技能吧!
你打算为自己的日常工作量身定制一个什么样的 SKILL 呢?欢迎在评论区留下你的脑洞和配置代码,我们一起交流!
3331

被折叠的 条评论
为什么被折叠?



