目录
"每次都要把同样的步骤再向 Claude 解释一遍,实在太麻烦了"——如果你也有同感,那么 Claude Skills(Agent Skills)正是为解决这个痛点而生的机制。Anthropic 于 2025 年 10 月 16 日发布,短短几个月,它就成了在 Claude Code 和 API 中赋予 Claude 专业能力的标准做法。
本文面向初学者,梳理 Skills 是什么、为何重要、又该如何动手制作,并一路讲到它与常被混淆的 MCP、子代理之间的区别。
技能 = 你交给 Claude 的"操作手册文件夹"
— 只在需要时才自动加载
以文件夹分发
指令、脚本与参考资料集中在一个文件夹里。核心是 SKILL.md。
只在需要时读取
平时只看说明文字。任务匹配上时,才展开正文内容。
每次都是同样质量
无需重新粘贴提示词,就能用同样的步骤稳定复现。
1. 什么是 Claude Skills(Agent Skills)?
Claude Skills 是一种把"某项工作的具体做法"打包进一个文件夹、再交给 Claude 的机制。文件夹内有一份名为 SKILL.md 的操作手册,记录着完整步骤,并可选择性地附带执行脚本和参考资料。
不妨把它想象成你交给新员工的一份入职手册。"如何生成发票 PDF""我们团队的提交信息规范""会议纪要的格式"——一旦把这些固定流程写成手册,Claude 每次都能照着参考,产出同样的质量。这就像是给一个 AI 智能体事后加装专门技能的感觉。
💡 一句话概括:技能就是"让 Claude 记住的操作手册文件夹"。做好一次,就能一遍又一遍地用同样的方式请它完成同样的任务。
2. 为何重要:告别反复粘贴提示词
在此之前,想让 Claude 做专业工作,通常意味着每次都要粘贴一长串指令提示词。但这种做法有明显的短板。
- 可复现性差:提示词稍微改一改,结果就会跑偏
- 挤占上下文:冗长的指令会长期占用上下文窗口
- 难以共享:在团队内很难做到同样的质量
每次都得粘贴提示词
- 每次都要复制粘贴冗长的指令
- 细微差异就会让结果跑偏
- 持续挤占上下文
- 团队内质量参差不齐
写一次,永久复用
- 流程写进 SKILL.md,只需写一次
- 稳定可靠,每次步骤一致
- 只在需要时展开=轻量
- 整个文件夹直接共享
Skills 用一本只在需要时才翻开的折页手册取代了这一切。大多数时候,Claude 看到的只是每个技能的简短说明(一两行)。真正的流程只有在你请它做那项任务的那一刻才会展开。因此,哪怕装了几十个技能,你日常的上下文也几乎不受影响。
发布之初,开发者 Simon Willison 就称它"也许比 MCP 更重要"——正是因为这份轻量与可复用。你的提示词工程经验,从此变成可以不断积累的资产,而不是用完即弃的东西。
3. 工作原理:SKILL.md 与渐进式披露
技能的核心是一份名为 SKILL.md 的文件。文件顶部写上 name 和 description,下面则用纯 Markdown 写出操作流程。
---
name: pdf-filler
description: 根据数据填写 PDF 表单。当用户想要填充 PDF 申请表或模板时使用。
---
# 填写 PDF 表单
1. 用 `pdftk form.pdf dump_data_fields` 获取字段名
2. 将用户的数据映射到这些字段名
3. 用 `pdftk form.pdf fill_form data.fdf output filled.pdf flatten` 写入
FDF 格式的详细说明请参见 reference/fdf-format.md。
关键在于 description。会话开始时,Claude 只读取每个技能的 description。然后它自行判断你刚提出的任务是否与该说明相符,只有相符时,才会加载正文、脚本和参考文件。这种"按需、分阶段地打开所需内容"的机制,就叫做渐进式披露(progressive disclosure)。
只读取各个说明
启动时,Claude 只读入每个技能的 name 和 description(一两行)。正文保持关闭。
判断是否匹配
Claude 自行判断你的请求是否契合某个说明,无需手动选择。
展开正文
只有匹配上的技能才会加载其正文、脚本和参考资料,然后照着写好的步骤执行。
⚠️ description 决定一切:如果写得含糊,Claude 就分不清"什么时候该用它",技能也就永远不会触发。诀窍是把"它能做什么"和"何时该用"都讲清楚。
4. 如何动手做一个(附最小示例)
有两种方法:(1) 让 Anthropic 官方的 "skill-creator" 技能替你生成,或者 (2) 自己搭好文件夹。一个最小结构长这样。
.claude/skills/
└── pdf-filler/
├── SKILL.md ← 必需:name、description、步骤
├── reference/
│ └── fdf-format.md ← 额外细节,只在需要时读取
└── scripts/
└── fill.py ← Claude 可运行的代码
在 Claude Code 中,只要把文件夹放进项目的 .claude/skills/(仅限该项目)或 ~/.claude/skills/(所有项目共享),它就会被自动识别。2026 年 1 月的一次更新让新增或修改的文件夹无需重启即可立即生效,大大方便了实验。官方示例集发布在 github.com/anthropics/skills。
作为第一步,最好的做法是挑一个你反复向 Claude 解释的"标准流程",把它写成一份 SKILL.md。从小处着手——团队的 Slack 发帖格式、发布说明的写法——很快你就能上手。
5. Skills、MCP 与子代理如何取舍
扩展 Claude 的方式不止 Skills 一种。我们按角色来理清它与常被混淆的 MCP 和子代理有何不同。这三者并非互相竞争,而是处在不同的层级。
| 工具 | 角色(一句话) | 何时该用 |
|---|---|---|
| Skill | 教它怎么做 =改变行为 |
你希望每次都用同样的步骤、同样的格式 |
| MCP | 连接外部 =增加连通性 |
你需要数据库、Google Drive 等的实时状态 |
| 子代理 | 隔离上下文 =独立的会话 |
你想并行处理,或把调研与主线隔离开 |
一个简单的经验法则:如果请求涉及"抓取、查询、当前状态",就用 MCP;如果是"按我们惯常的方式来做",就用 Skill;如果是"交给一个独立单元去并行执行",就用子代理。而在实践中,三者往往组合使用(例如,子代理通过 MCP 抓取数据,再用某个 Skill 的流程把它整理成报告)。
6. 在哪里能用:一套开放标准
Skills 并不是锁定在某一款产品里的功能——它是作为开放标准公开发布的。只要遵循共同的 SKILL.md 格式,同一个技能就能在多种工具上运行。
在 Anthropic 自家产品中可用之处
Claude 应用(Pro / Max / Team / Enterprise)、Claude Code、API(Claude Developer Platform),以及 Claude Agent SDK
采纳了该标准的其他工具
OpenAI Codex CLI、Cursor、Gemini CLI、GitHub Copilot 等主流编程代理都支持同一格式
换句话说,你写一次的技能,可以复用到 Claude 以外的代理上。当年让 MCP 成为工具连接通用标准的那股潮流,如今也在"工作流程"的世界里上演。你同时使用多款编程工具越多,回报就越大。
7. 能用来做什么?真实案例
抽象地讲很难想象,所以这里列举一些常见用法。
- 文档生成:按你自己的模板产出 Word、PowerPoint、PDF 和 Excel 文件(官方示例中也已包含)
- 落实内部规范:每次都套用提交信息规范、代码评审清单和命名规则
- 例行报告:用统一格式生成每周销售汇总、会议纪要和发布说明
- 专业化工作流:数据校验、特定 API 的调用方式、绘制图表或示意图的步骤
第三方一侧的支持也在增长:Box、Canva 和 Notion 都以技能的形式提供了各自的操作。在业务提效的语境下,"把你常做的工作变成技能、当作可复用资产"的理念,正逐渐成为常态。
总结
Claude Skills(Agent Skills)是一种把"某项工作的具体做法"打包进文件夹、再交给 Claude 的机制。我们把它浓缩成三点。
- 它是什么:一个以 SKILL.md(name、description、步骤)为核心的文件夹。很像给新员工的入职手册
- 聪明在哪:平时只读说明,任务匹配时才展开正文——这种"渐进式披露"为你节省上下文
- 能走多远:作为开放标准,它可复用到 Claude 之外的代理上,并能与 MCP 和子代理组合
先从你反复向 Claude 解释的某一个流程入手,把它写成一份 SKILL.md。一旦做好,那项任务就变成了一份"资产",再也无需多加解释。如果想更深入地了解其中机制,也欢迎阅读我们关于 MCP 和框架工程(harness engineering)的文章。与技能并列的另一种 Claude Code 新输出方式是Claude Code Artifacts,它能把一次编码会话变成可共享的实时页面。
FAQ
Q. 该用 Skills 还是 MCP?
A. 两者扮演不同角色,并非二选一。如果你想让 Claude"按我们惯常的方式工作",就用 Skill;如果你想"抓取或操作外部数据和当前状态",就用 MCP。实践中,两者结合使用是常态。
Q. 不会编程也能做一个吗?
A. 可以。哪怕只是用大白话(Markdown)把步骤写出来,一份 SKILL.md 也能照常工作。捆绑脚本是可选项——单单"用文字写出流程"就足以让它运转起来。
Q. 技能一多会不会拖慢速度?
A. 平时加载的只是每个技能的简短说明,所以多加几个几乎不影响日常表现。这正是渐进式披露带来的好处。
Q. 免费套餐能用吗?
A. Claude 应用中的 Skills 功能在 Pro、Max、Team 和 Enterprise 上可用。它也能通过 Claude Code 和 API 使用。最新的可用情况请以官方说明为准。