定义
Claude Code Skill 是把外部 API/工具端点封装为 Claude Code 可直接调用的”技能单元”——通常以一个 SKILL.md 文件 + YAML front matter + 可选脚本的形式,放在项目目录的 skills 文件夹下,Claude Code 启动时加载;按 description 触发器自动调用,产出固定形态的结果。Anthropic 官方也把它叫做 “Claude Skills”,本质同义。
跨来源共识是:Skill = 一次写下规则、反复复用的 playbook——把”如何调这个工具 / 如何做这件事”的指令固化,避免每次让 agent 从零讲;不绑死 Claude Code——Mistral Vibe 等其他 CLI agent 也有”技能”概念,这是 CLI agent 的共性模式;skill 的质量上限取决于 description 的精确度(差 description 同时造成误触发与漏触发)。
术语判别:Claude Code Skill 是技术概念,中文圈几乎都直接保留英文;主用名保留英文,常见变体 Skills / Skill 进 aliases。Anthropic 官方说法是 “Claude Skills”,本概念与之同义但 vault 内独立登记。
各信源立场对照
| 信源 | 立场/侧重 | 锚点 | 采信 |
|---|---|---|---|
| Tina·30分钟上手 NotebookLM | 横向对比:Google 托管的 NotebookLM 与自托管的 LightRAG / Graph RAG / Claude Code Skill 是”省事 vs 可控”两端的代表 | — | 利益中性(对比)但 Augment Code 赞助;贬低 Pro 升级是反向证据 |
| Chase·LightRAG + CC | 核心示范(首见):LightRAG 的 query / upload / explore / status 四个 API 端点封成 Claude Code Skill,在任意会话里”用 LightRAG query skill 问……”即可,且 Claude Code 顺手把响应总结+附来源 | 09:49 | 利益中性(机制)但 Chase 课程 affiliate;LightRAG/graph RAG 主张属业界共识 |
| Jack·CC + MongoDB CMS | 组合用法:Blueprint Extractor + Firecrawl + Kie.ai 三个 skill 协同完成”灵感采集→结构化→一次性出站→补图”——证明 skill 组合是 vibe coding 出可商用质量的关键 | 06:36 / 07:35 | 利益中性(机制)但 affiliate 强绑,Jack 主动给”短 prompt 已足够开始”——反向证据 |
| Chase·四步循环工程 | 工程视角:循环的”执行”阶段通常建议封成 Claude Code Skill——skill 擅长让 agent 用固定方式产出固定形态的结果 | 02:08 | 利益中性,工程定位 |
| Nate·CC 帮我赚钱 | 反谄媚 Skill:构建名为 roast 的 skill,五角色(contrarian / expansionist / first principles thinker / deep researcher / buyer)对抗议事会 + judge 汇总三档裁决;另自建 /session handoff skill 在清空上下文前先输出摘要实现”零上下文续接” | 01:01 / 17:15 / 18:27 | 利益中性(技能机制),Nate 反复引导加社群获客但方法本身独立 |
| Sabrina·AI 循环工程 | 标准化类比:各家工具 skill 的实现方式相同——一个 skill.md 普通文件,类比给新员工的操作手册,而不是每天早上从零讲一遍整个工作内容 | 02:34 | 利益中性,实践背书 |
| All About AI·Mistral Vibe | 跨厂商印证:把外部工具封装为可复用技能单元的思路,在 Mistral Vibe 的 skill 功能(非 Claude 专属机制)里再次出现——说明”一次性 workflow 固化为可复用技能”是 CLI agent 的共性模式 | — | 利益中性(机制)但 Mistral 赞助 + 博主自推 Surfagent,笔记已剥离推销 |
| Chase·5 个开源仓库 | 5 个具体开源 skill 模板:claude-video(视频)/ notebooklm-py(研究)/ graphify(记忆)/ obsidian-skills(Obsidian)/ impeccable(前端)/ ponytail(token)——逐一补 Claude Code 弱项 + 完整安装路径 | — | 利益中性(机制)但 Chase 课程 affiliate;Chase 主动贬低工具效果——反向证据 |
分歧与共识
- 共识(跨 8 源):
- Claude Code Skill = 把外部 API/工具/工作流封装为可复用技能单元,以 SKILL.md + YAML front matter 形式存在。
- 不绑死 Claude Code:Mistral Vibe 等其他 CLI agent 也有”技能”概念,这是 CLI agent 的共性模式。
- 一次写下、反复复用——把”如何做这件事”的指令固化,避免每次让 agent 从零讲。
- Skill 质量上限取决于 description 的精确度(差 description 同时造成误触发与漏触发)。
- 分歧 / 侧重:
- 使用场景分歧:Chase·LightRAG 主张”封 API 端点为 skill 解决”每天去 UI 提问太麻烦”;Nate·帮我赚钱 把 skill 推到”多角色对抗议事会”等复杂工作流(roast / /session handoff);Jack·CC CMS 强调 skill 组合是”vibe coding 出可商用质量”的关键;Chase·5 个仓库把 skill 视为”补 Claude Code 弱项的工具集”——判定变量:你要”封 API / 复杂工作流 / skill 组合 / 弱项补丁”哪个看哪篇。
- 官方 vs 社区实操:Anthropic 官方说法是 “Claude Skills”(SKILL.md + 触发条件 + slash 命令);社区实操(Chase 5 个仓库、Nate 自建)经常超出官方定义——比如 roast 实际是多 agent 议事会、Blueprint Extractor 是”灵感采集→结构化”工作流,本质上是”以 skill 形式包装的 mini-agent”。
- Skill 与 MCP 的关系:Skill 是项目内指令集(放项目目录、Claude 读它),MCP 是跨厂商标准协议(把外部工具/数据接到 Claude);两者并列而非替代——Skill 改”怎么做事”,MCP 改”能调什么”。
怎么用
- “封端点 / 封工作流”两类用法:
- 封 API 端点:把 LightRAG 那种 query / upload / explore / status 多个 API 端点各封一个 skill,Claude Code 启动时按 description 自动加载,触发后调对应端点并把响应总结+附来源(省去每次开 UI 提问)。
- 封工作流:把”五角色对抗议事会”/“灵感采集→结构化→出站”等复杂工作流封成单一 skill,Claude Code 触发后跑完整套 mini-agent 流。Nate·roast 是这类代表。
- 按 Claude Code 弱项选 skill 模板:Chase·5 个开源仓库的实操清单可作起点——claude-video(视频)/ notebooklm-py(研究)/ graphify(记忆)/ obsidian-skills(Obsidian)/ impeccable(前端)/ ponytail(token);按自己最痛的弱项装对应 skill,装上即可”在原有能力上做加法”,不需重写工作流。
- 避免低质量 skill 三个检查:① 触发器 description 精确(避免误触发与漏触发);② 自检 / 跑一遍(实际跑,看输出是否稳定);③ 文档说明 + 安装路径(团队可复用)。
适用边界
- Skill 不等于万能:skill 改”怎么做事”,不能改”能调什么”——若需要接入新外部工具,优先用 MCP 走标准协议;Skill 改”做事方式”用 skill,二者并列。
- Skill 质量取决于 description 精确度:差 description 同时造成误触发与漏触发,写 skill 的第一关是 description 写得准。
- Anthropic 官方定义有限:社区实操(roast / Blueprint Extractor 等)经常超出官方定义,本质是”以 skill 形式包装的 mini-agent”——按”用 skill 形式做严肃工作”理解,不要被”skill = 简单指令集”的字面意思限制。
- 5 个开源 skill 的”省 20% token”等效果主张:Chase 主动贬低”benchmarks 不等于真实项目,最坏情况跑两次不喜欢就删”——这些是 trade-off 写法,采信时按”先小范围试”原则,不全栈照抄。
关联
- MCP — 互补:Skill 改”怎么做事”(项目内指令集),MCP 改”能调什么”(跨厂商标准协议);两者并列而非替代。
- MCP server — 进阶:MCP 协议的服务端实现可被 Claude Code 通过 MCP 接入,而 skill 形式的工具/工作流可被 skill 加载;两者是 Claude Code 接入”外部世界”的两种通道。
- Claude Skills — 互补:Anthropic 官方说法,本质与本概念同义,只是官方与社区用词差异;vault 内作为独立概念登记(2026-06-26 笔记)。
- Skill Creator — 进阶:Anthropic 官方元技能,用于创建 skill 及对已有 skill 跑 evals / benchmark 评估质量——是 Skill 系统的自举工具,本概念页涉及”怎么写一个 skill”时常用。
- Trigger Accuracy — 互补:skill.md 顶部 description 决定该 skill 被自动触发的精度,差描述同时造成误触发与漏触发——是 Skill 质量的第一道闸门。
- Loop engineering — 进阶:把”反复手动 prompt agent”换成”写一段循环让 agent 自己跑”,代表实践是 Claude Code 的 /loop /goal /routines;循环的”执行”阶段通常封成 Skill 形式落地。