介绍 Anthropic 推出的 Skills 功能，这是一种面向 AI 代理的可加载工作流与说明书。Skills 以文件夹形式存在，包含 SKILL.md 指令文件及脚本资源，用于教会 AI 完成特定任务。文章详细解析了 Skills 的仓库结构、核心概念、在 Claude Code 和 API 中的使用方法，以及创建自定义 Skill 的流程。通过渐进式披露机制，Skills 能有效利用上下文窗口并支持代码执行，适合开发者为 Agent 扩展能力或企业沉淀标准化 AI 工作流。
相关文档： Claude Code 构建 Agent Skills 官方文档 GitHub: anthropics/skills
参考自：equipping-agents-for-the-real-world-with-agent-skills
为智能体构建一个 skill 就像为新员工准备入职指南。与其为每个用例构建零散的、定制的智能体，不如通过捕捉和分享程序化知识，让任何人都能用可组合的能力来专门化他们的智能体。
技能是包含一个 SKILL.md 文件的目录，里面有组织的指令、脚本和资源，赋予智能体额外能力。
让我们通过一个真实例子来了解 Skills：这是支持 Claude 最近推出的文档编辑能力的技能之一。Claude 已经对理解 PDF 有很深的认识，但在直接操作 PDF（例如填写表单）方面能力有限。这个 PDF 技能让我们赋予 Claude 这些新能力。
最简单的技能是一个包含 SKILL.md 文件的目录。该文件必须以 YAML Frontmatter 开头，包含一些必需的元数据：name 和 description。启动时，智能体会将所有已安装技能的 name 和 description 预加载到系统提示中。
这些元数据是渐进式披露的第一层：它提供足够的信息让 Claude 知道何时应该使用每个技能，而无需全部加载到上下文中。
该文件的正文是第二层细节。如果 Claude 认为该技能与当前任务相关，它将通过读取完整的 SKILL.md 文件来加载该技能。
随着技能的复杂度增加，可能会包含过多上下文，无法全部放入单个 SKILL.md，或者包含仅在特定场景下相关的上下文。这时，技能可以在目录中捆绑额外的文件，并在 SKILL.md 中通过名称引用它们。这些额外的链接文件是第三层（及更深层次）的细节，Claude 可以根据需要选择性地导航和发现。
在下面的 PDF 技能示例中，SKILL.md 引用了两个额外文件（reference.md 和 forms.md），技能作者选择将它们与核心的 SKILL.md 一起打包。通过将表单填写说明移到单独的文件 forms.md 中，技能作者可以保持核心技能文件的精简，并相信 Claude 只在填写表单时才会读取 forms.md。
你可以通过额外文件为技能加入更多上下文，然后由 Claude 根据系统提示触发这些内容。
渐进式披露是 Agent Skills 灵活且可扩展的核心设计原则。就像一本结构良好的手册，从目录开始，然后是具体章节，最后是详细附录，技能让 Claude 只在需要时加载信息。
具备文件系统和代码执行工具的智能体，无需在处理特定任务时将整个技能加载到上下文窗口中。这意味着技能中可打包的上下文量实际上是无限的。
下图展示了当技能被用户消息触发时，上下文窗口的变化。
技能通过系统提示在上下文窗口中被触发。
操作序列如下：
pdf/SKILL.md 内容，触发 PDF 技能；forms.md 文件；技能还可以包含 Claude 可按需执行的代码工具。
大型语言模型在很多任务上表现优异，但某些操作更适合传统代码执行。例如，通过生成 token 来排序列表比直接运行排序算法代价高得多。除了效率问题，许多应用需要代码才能提供的确定性可靠性。
在我们的示例中，PDF 技能包含一个预写的 Python 脚本，用于读取 PDF 并提取所有表单字段。Claude 可以在不将脚本或 PDF 加载到上下文中的情况下运行该脚本。由于代码是确定性的，该工作流既一致又可重复。
技能可以根据任务性质，包含 Claude 可执行的代码工具。
以下是一些有助于开始编写和测试技能的指导原则：
SKILL.md 文件变得庞大时，将内容拆分到多个文件中并进行引用。如果某些上下文是互斥的或很少一起使用，分开路径可以减少令牌使用量。代码既可以作为可执行工具，也可以作为文档，应明确 Claude 是直接运行脚本还是将其作为参考读入上下文。name 和 description，Claude 会用它们来决定是否针对当前任务触发技能。技能通过指令和代码为 Claude 提供新能力。虽然这增强了技能的力量，但也意味着恶意技能可能引入使用环境中的漏洞，或指示 Claude 泄露数据和执行非预期操作。
我们建议仅从可信来源安装技能。安装来自不太可信来源的技能时，务必先彻底审计。首先阅读技能中所有文件的内容，了解其功能，特别关注代码依赖和捆绑的资源（如图片或脚本）。同样，注意技能中是否有指示 Claude 连接到潜在不可信外部网络的指令或代码。
来看一下 https://github.com/anthropics/skills 仓的结构
根据 README.md，这个仓库的顶层结构大致如下（简化说明）：
./skills：大量示例技能目录，涵盖：
./spec：Agent Skills 规范，说明 Skill 的文件结构和 SKILL.md 的格式。./template：一个模板 Skill，用来作为创建新 Skill 的起点。.claude-plugin/：与 Claude Code 插件系统集成相关的元数据。README.md：你目前看到的总说明文件。原文还特别强调：
Many skills in this repo are open source (Apache 2.0)。 文档创建与编辑技能（
docx、pptx、xlsx）是 source-available 而非开源，但作为复杂生产级技能的参考被开放出来。
这意味着：
在 spec/agent-skills-spec.md 中，对 Skill 的正式定义是：
A skill is a folder of instructions, scripts, and resources that agents can discover and load dynamically to perform better at specific tasks.
翻译并拆解：
README.md 中把仓库中的技能粗略分为几类，并使用了'Skill Sets'的说法：
./skills：各种领域的技能：
./spec：Agent Skills 规范；./template：技能模板。结合前面的 list_files，我们可以列出几个代表性 Skill 目录（部分）：
| 目录名 | 主要领域 | 典型用途简述 |
|---|---|---|
pdf | 文档处理 | PDF 拆分、文本/表格/图片提取、表单处理等 |
docx | 文档处理 | Word 创建、编辑、修订、批注、结构化读取 |
pptx | 文档 & 演示处理 | PPT 创建/编辑、模板套用、文本批量替换等 |
xlsx | 数据 & 表格处理 | Excel 读取、写入、公式校验、格式规范等 |
canvas-design | 视觉设计 | 画海报、插画、静态视觉稿（输出 PNG/PDF） |
algorithmic-art | 算法艺术 | 使用 p5.js 等生成算法图形 |
frontend-design | 前端页面设计 | 生成页面布局、组件结构和 CSS 风格 |
web-artifacts-builder | 复杂 Web 产物 | 使用 React/Tailwind/shadcn 搭建复杂 Web 组件 |
doc-coauthoring | 文档协作写作 | 引导式写技术文档/提案/说明书 |
theme-factory | 主题与品牌 | 统一主题配色与字体，生成主题示例（有 PDF 展示） |
图片提示： 仓库中
theme-factory/theme-showcase.pdf是一个 PDF 示例，用来展示不同主题样式的效果，可视作'图片资源集'的 PDF 版展示。
README.md 的后半部分详细说明了在不同产品中如何使用这些技能。可以概括为三个场景：Claude Code、Claude.ai、Claude API。
官方建议可以把这个仓库当作一个'插件市场源'来注册：
/plugin marketplace add anthropics/skills
代码解读：
/plugin marketplace add：Claude Code 中的命令，用于添加一个插件市场源；anthropics/skills：GitHub 仓库标识，即当前这个 Skills 仓库。注意事项：
之后有两种安装方式：
anthropic-agent-skills；document-skills 或 example-skills；Install now。/plugin install：安装插件；document-skills@anthropic-agent-skills：
anthropic-agent-skills：插件集合名称；document-skills：该集合中的一个具体插件（下挂多个与文档相关的 Skill）。通过命令直接安装：
/plugin install document-skills@anthropic-agent-skills /plugin install example-skills@anthropic-agent-skills
代码解读：注意事项： README 给了一个典型用例：
'Use the PDF skill to extract the form fields from
path/to/some-file.pdf'
翻译为普通话对话就是：
path/to/some-file.pdf 里抽取所有表单字段。'document-skills；pdf 这个 Skill；skills/pdf/SKILL.md 中的流程，使用合适的 Python 工具（如 pdfplumber）完成任务。README 指出：
These example skills are all already available to paid plans in Claude.ai.
即：对于 Claude.ai 的付费用户，这些示例 Skills 已经可用，无需你手动配置仓库。
你只需按照官方文档：
在实际对话中，使用方式类似：
README 还提到可以通过 API 使用预置 Skill 或自定义 Skill：
You can use Anthropic's pre-built skills, and upload custom skills, via the Claude API. See the Skills API Quickstart.
对应官方文档链接是：
在 API 级别，本质是：
my-skill/ 目录（含 SKILL.md）上传到 Anthropic 的 Skill 系统；除了 Anthropic 官方支持的渠道，许多第三方工具，尤其是深度集成的 IDE 插件，也提供了使用 Skills 的方式。这些工具大致可以分为两类：
这类工具通常内置了对 Skills 理念的支持，提供了类似 Claude Code 的无缝体验。以 CodeBuddy 为例，其对 Skills 的支持非常完整：
pptx），它能够自动加载对应的 SKILL.md 文件，并将其中的工作流、脚本路径、工具列表等信息注入到当前的对话上下文中。pptx skill 中用于操作 OOXML 的 Python 脚本），CodeBuddy 提供了让 AI 安全执行这些脚本的能力。AI 会生成一个执行指令，经用户确认后，在 CodeBuddy 的环境中运行，并将结果返回给 AI。SKILL.md 规划任务' -> '调用工具/脚本' -> '返回结果'，整个过程是闭环的，用户体验非常流畅。在这种环境下，使用 Skill 的方式与在 Claude Code 中几乎没有差别，核心在于工具本身是否实现了 Skill 的发现、加载和执行机制。
对于更多通用的、允许用户'自带 API Key'的 AI 编码助手（如 Trae, Cursor, Qoder 等），它们可能没有专门为 Skills 设计的集成功能。但在这些工具中，你仍然可以手动模拟 Skill 的使用过程：
skills/SKILL_NAME/SKILL.md 的全部内容，以及任何相关的脚本文件（如 scripts/main.py），手动添加到对话的上下文中。你可以直接复制粘贴 SKILL.md 的内容，或者使用插件的'附加文件'功能。这一步相当于手动'教会'AI 这个 Skill 的工作流程。SKILL.md 后，就可以遵循其中的指导和示例来回答你的问题。SKILL.md 中的规范生成代码，你需要手动复制并应用到你的项目中。pptx）：这是最复杂的情况。AI 在读取 SKILL.md 后，会知道需要调用某个脚本。但由于这些通用工具通常不具备让 AI 直接执行本地代码的能力，AI 会'请求'你来执行。它会生成需要运行的命令（例如 python skills/pptx/scripts/run.py --action "create_slide" ...），你需要自己复制这个命令到终端里执行，然后将终端的输出结果再复制回对话框，告诉 AI 执行结果。总结：在 Trae、Cursor 这类工具中，使用 Skills 更像是一种**'人机协作'的模式**。SKILL.md 成为你和 AI 共同遵循的'操作手册'，AI 负责规划和生成指令，而你负责执行其中需要外部环境支持的步骤。虽然不如深度集成环境来得自动化，但这极大地扩展了 Skills 在各种开发环境中的适用性。
README.md 对'如何创建一个基础 Skill'给了一个核心样例（前面已经展示了代码），这里我们将整个过程总结为步骤，并做一点对比说明。
# My Skill Name：整体标题；## Examples：写 2–3 个对话中的使用示例；## Guidelines：写清楚该 Skill 的使用原则（如'避免一次修改过多文件'、'遇到错误优先回滚'等）。scripts/。templates/。/plugin 命令或 UI。（见上文）编辑 SKILL.md 的 YAML 部分
--- name: my-skill-name description: A clear description of what this skill does and when to use it ---
新建 Skill 目录
my-skill/- SKILL.md
为了更清晰地理解 Skill 与传统组件（如插件、工具、普通 prompt）的区别，可以用表格对比：
| 概念 | 粒度与形式 | 谁来执行？ | 典型内容 |
|---|---|---|---|
| Prompt | 单段文本提示 | 纯大模型（LLM） | 指令、问题、上下文描述 |
| Tool | 一个具体 API / 命令行 / 函数 | 外部系统或代码 | HTTP 请求、DB 查询、脚本调用 |
| Plugin | 一组工具与集成逻辑 | 应用/平台 + LLM | 多个 API、配置与 UI 绑定 |
| Skill | 一整个'任务工作流 + 说明书 + 资源'的目录 | LLM 主导 + 工具辅助 | SKILL.md + scripts + 模板 + 规则 |
从表中可以看出：
spec/agent-skills-spec.md 是对 Skills 的正式规范文件，前面我们已经引用核心内容，这里补充它的结构与版本信息。
template-skill。1.0 (2025-10-16) Public Launch —— 即 2025-10-16 公开发布 1.0 版规范。Skill Folder Layout（技能目录结构）：
my-skill/- SKILL.md
说明：即使 Skill 非常复杂，入口仍然是 SKILL.md。
Agent Skills Spec 开头段落name 与目录名需要一致
name 字段的要求Markdown Body has no restrictionsVersion History 标记为 Public Launch综合 README.md 与 agent-skills-spec.md 的全部信息，我们可以对这个仓库做一个较为客观的总结：
SKILL.md、脚本与资源；
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online