--- title: 'Claude Code Skill(Skills)' concept: Claude Code Skill aliases: [Claude Code Skill, Skills, Skill] type: 概念页 sources: - 01-学习笔记/ai/tina-huang/2025-08-13-30 分钟上手 NotebookLM 从研究到 AI 编程落地的全流程.md - 01-学习笔记/ai/chase-ai/2026-04-01-用LightRAG给Claude Code接上Graph RAG知识库.md - 01-学习笔记/ai/jack-roberts/2026-06-04-用 Claude Code 加 MongoDB 搭可交付的客户网站 CMS.md - 01-学习笔记/ai/chase-ai/2026-06-24-四步循环工程任何事物（+提示工程为何未死）.md - 01-学习笔记/ai/nate-herk/2026-06-25-我让Claude Code帮我尽可能多赚钱.md - 01-学习笔记/ai/sabrina-ramonov/2026-07-03-11分钟掌握AI循环工程.md - 01-学习笔记/ai/all-about-ai/2026-07-04-用Mistral Vibe构建Reddit AI研究助手.md - 01-学习笔记/ai/chase-ai/2026-07-08-5个开源仓库解决Claude%Code%95%的痛点.md topics: [Claude Code 定制扩展, RAG 与知识系统, Agent 工程] promoted: 2026-07-08 --- ## 定义 **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](https://youtu.be/PEe0yLB_w1w?t=589) | 利益中性(机制)但 Chase 课程 affiliate;LightRAG/graph RAG 主张属业界共识 | | Jack·CC + MongoDB CMS | 组合用法:Blueprint Extractor + Firecrawl + Kie.ai 三个 skill 协同完成"灵感采集→结构化→一次性出站→补图"——证明 skill 组合是 vibe coding 出可商用质量的关键 | [06:36](https://youtu.be/Q_K3k_ge8NA?t=396) / [07:35](https://youtu.be/Q_K3k_ge8NA?t=455) | 利益中性(机制)但 affiliate 强绑,Jack 主动给"短 prompt 已足够开始"——反向证据 | | Chase·四步循环工程 | 工程视角:循环的"执行"阶段通常建议封成 Claude Code Skill——skill 擅长让 agent 用固定方式产出固定形态的结果 | [02:08](https://youtu.be/16-iA8IEMS0?t=128) | 利益中性,工程定位 | | Nate·CC 帮我赚钱 | 反谄媚 Skill:构建名为 roast 的 skill,五角色(contrarian / expansionist / first principles thinker / deep researcher / buyer)对抗议事会 + judge 汇总三档裁决;另自建 /session handoff skill 在清空上下文前先输出摘要实现"零上下文续接" | [01:01](https://youtu.be/iTY8Q449YNQ?t=61) / [17:15](https://youtu.be/iTY8Q449YNQ?t=1035) / [18:27](https://youtu.be/iTY8Q449YNQ?t=1107) | 利益中性(技能机制),Nate 反复引导加社群获客但方法本身独立 | | Sabrina·AI 循环工程 | 标准化类比:各家工具 skill 的实现方式相同——一个 skill.md 普通文件,类比给新员工的操作手册,而不是每天早上从零讲一遍整个工作内容 | [02:34](https://youtu.be/zwJmemPe_pQ?t=154) | 利益中性,实践背书 | | 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 形式落地。