Skills:智能体技能(1)：给智能体装一套可复用的技能包

在上一系列《Auto Ontology》于 2026-11-09 完结三篇后，今天开启全新系列的第 (1) 篇。在 2026-11-10 的 GitHub Trending 当日榜上，排名第 1 的项目是 Anthropic 官方公开的 Agent Skills 示例仓库 anthropics/skills。

这个创建于 2025 年 9 月 22 日、默认分支为 main 的仓库，目前已经积累了约 19 万 Star（当日榜显示 191,128），Fork 数达到约 2.2 万，仅当日新增 Star 就约有 1000。如此高的社区关注度背后，指向的是当前大模型与智能体落地过程中一个非常朴素却棘手的工程痛点：当我们在日常工作里摸索出一套行之有效的提示词、脚本和参考规范后，怎样才能让智能体在特定任务上稳定地复用这套做法，而不是每次都从零开始交代背景与上下文？

anthropics/skills 给出的答案非常直接——把这些分散的经验打包成一个个标准的文件夹，变成智能体按需动态加载的「技能（Skill）」。作为新系列的开篇，本文将带你全面拆解 anthropics/skills 的核心理念、目录架构、开箱即用的官方技能清单，以及如何从零开始在自己的工作流中接入或编写一套专属技能。

一、项目概览：Skill 是什么，它要解决什么痛点？

在日常使用 Claude Code、Claude 网页端或调用 Claude API 做开发、写文档、做设计、管企业沟通时，许多开发者和团队都会遇到相似的效率瓶颈：

1. 重复交代背景与规范：每次让智能体写一份内部沟通材料或制作一份演示文稿，都要重新输入一遍公司的品牌色、字体要求、行文语气和排版要求。
2. 指令与工具割裂：有些复杂任务光靠文字指令远远不够，还需要配合特定的脚本或模板资源。如果把所有内容一股脑塞进长提示词里，不仅白白挤占上下文窗口，还会干扰智能体在其他常规任务上的表现。
3. 团队经验难以沉淀与共享：某位团队成员摸索出了「用智能体自动化测试 Web 应用」或「按组织流程分析数据」的最佳实践，却很难用一种标准化的文件格式直接分享给其他同事即插即用。

在官方定义中，Skill 是「指令、脚本与资源组成的文件夹」。它的核心运行机制并非把所有规则永久硬编码到系统提示词里，而是由 Claude 按需动态加载。只有当用户发起的特定任务命中了某个技能的适用场景时，智能体才会调取该文件夹下的指令、脚本与资源，从而在特定任务上稳定地复用既定做法。

这种按需加载机制可以覆盖非常广泛的真实办公与研发场景，例如：

按公司品牌规范做文档：确保每次生成的对外材料在视觉风格与措辞标准上高度统一；

按组织流程分析数据：严格遵循团队内部的分析口径与处理步骤，减少模型自由发挥带来的偏差；

自动化个人任务：把日常高频的琐碎操作封装成固定套路，通过简单对话即可触发执行。

简而言之，每个 Skill 文件夹就是一份配齐操作指南与辅助脚本的「标准作业程序手册」，智能体平时轻装上阵，遇到具体业务再翻阅对应的手册。

二、仓库全景：四大核心板块与技能分类体系

打开 anthropics/skills 的 main 分支，整个仓库的目录结构非常清晰，主要由四个核心部分组成：

skills（技能示例）：存放官方提供的各类现成技能文件夹，涵盖设计、开发、办公沟通与文档处理等多个领域，仓库中许多技能以 Apache 2.0 许可证开源。

spec（Agent Skills 规范）：定义了智能体技能的标准结构与约定，让开发者和第三方合作伙伴在构建自定义技能时有章可循。

template（技能模板）：提供了一套标准的起手骨架，方便用户直接复制修改，快速创建自己的新技能。

.claude-plugin（插件配置）：用于支持插件市场机制的配置文件，让用户可以在命令行工具里一键注册并安装仓库中的技能集合。

除了官方自行维护的示例外，仓库中还专门设立了 Partner Skills（合作技能）一节，目前已经收录了 Notion 的技能，展现出这套技能规范向外部协作生态延伸的潜力。

而在最受开发者关注的 skills 目录下，官方将现有的示例技能划分为了四大类别：创意与设计、开发与技术、企业与沟通，以及文档技能。除去包含 docx、pdf、pptx、xlsx 的四个文档技能外，仓库中还提供了 15 个极具代表性的具体示例技能。我们可以结合实际应用场景，来看看这些技能分别在解决什么问题：

1. 创意与设计类

这类技能主要帮助开发者和创作者跨越从创意灵感到视觉落地的门槛，把抽象的审美要求转化为可执行的代码或画布输出：

algorithmic-art（算法艺术）：面向生成式艺术与视觉编程场景，指导智能体通过算法逻辑创作出富有规律与美感的视觉图案。

canvas-design：聚焦画布级的设计与排版任务，帮助用户在可视化的画布空间中合理组织图形与视觉元素。

frontend-design：针对前端界面设计场景，把现代前端的布局审美、组件搭配与视觉交互规范沉淀下来，避免生成千篇一律的简陋页面。

theme-factory：扮演「主题工厂」的角色，用于系统化地生成、定制或切换一套完整的视觉主题方案。

slack-gif-creator：一个非常贴近日常团队趣味沟通与轻量视觉表达的工具技能，专门用于制作适配团队协作聊天场景的 GIF 动图。

2. 开发与技术类

对于每天和代码、接口、测试打交道的工程师来说，开发与技术类技能是提效的重头戏。它们把围绕 Claude 生态做工程开发的常见工作流封装成了标准动作：

mcp-builder（MCP 服务生成）：随着智能体连接外部工具的需求日益增长，如何快速构建一个符合规范的 MCP 服务成了高频任务。mcp-builder 将构建 MCP 服务的步骤、结构与注意事项打包成技能，协助开发者在对话中高效搭建所需服务。

webapp-testing（Web 应用测试）：针对 Web 应用的质量保障环节，将测试流程与验证逻辑标准化，协助开发者自动化地对 Web 应用进行测试与排查。

web-artifacts-builder：专门用于构建复杂的 Web 交互组件与前端产物，让智能体在生成独立可运行的 Web 作品时更加稳定可靠。

claude-api：当开发者需要编写接入 Claude 接口的代码时，这个技能提供了准确的调用方式与规范指导，减少查阅文档与反复调试参数的时间。

skill-creator（技能创作助手）：这是一个非常实用的「元技能」——即用技能来写技能。当你不知道该如何把自己的工作流拆解成符合规范的 SKILL.md 时，直接调用 skill-creator，就能在它的引导下快速孵化出一个新的智能体技能。

3. 企业与沟通类及通用引导

在团队协作、组织管理与日常知识学习中，如何保持输出质量的一致性同样关键：

brand-guidelines（品牌规范）：将企业的视觉识别、用词规范与品牌调性固化下来。智能体在加载该技能后，产出的内容就能自然贴合公司的品牌标准。

internal-comms（内部沟通）：针对企业内部的通知、汇报、周报或跨部门同步等场景，提供符合组织习惯的沟通结构与行文框架。

doc-coauthoring（文档合写）：聚焦多人或人机协作撰写长文档的场景，让智能体不再只是机械地单次生成文本，而是像真正的合著者一样参与起草、润色与结构调整。

academy-guide：提供教学与学院式的引导支持，帮助用户在学习新概念或掌握复杂功能时获得循序渐进的讲解。

discernment-nudge：在人机协作过程中提供辨别力与思考层面的轻推引导，帮助用户在做判断和推进任务时保持清晰的思路。

从这 15 个覆盖面极广的示例技能不难看出，anthropics/skills 并不是一个只服务于硬核程序员的代码库，而是试图把设计师、产品经理、企业运营以及软件工程师的高频工作经验，统统装进同一套标准的文件夹体系里。

三、为什么 docx、pdf、pptx、xlsx 四个文档技能值得单独讲？

在 anthropics/skills 的四大技能分类中，文档技能（Document Skills）占据了一个非常特殊且核心的位置。打开仓库，你会看到四个以常见办公文件格式命名的文件夹：docx、pdf、pptx、xlsx。

为什么这四个文件夹值得所有关注智能体开发的读者单独细看？核心原因在于一条非常关键的事实：docx、pdf、pptx、xlsx 这四个文件夹里的技能，就是 Claude 文档能力背后在用的实现，而且已经正式开源。

在过去很长一段时间里，普通用户和开发者在使用智能体处理办公文档时，往往会有一种「黑盒感」：为什么自己直接用提示词让模型写一段操作文档的代码，经常会出现排版错乱、格式丢失或者表单字段提取不准，而官方产品自带的文档处理能力却显得有条不紊？

现在，通过公开这四个文件夹，Anthropic 直接把这套生产级能力的底层实现摊开在了台面上：

揭秘官方文档能力的构建方式
你会发现，官方之所以能稳定处理复杂的 Word 文档（docx）、演示文稿（pptx）、电子表格（xlsx）以及便携式文档（pdf），并不是靠某一个神秘的私有微调模型，而是同样遵循了「指令 + 脚本 + 资源」的 Skill 文件夹范式。通过阅读这四个文件夹中的 SKILL.md 及配套脚本资源，开发者可以直观地学到官方是如何拆解复杂文档任务、如何规定操作边界，以及如何配合辅助脚本完成精准读写的。

真实任务场景下的开箱即用
这四个技能并不是纸面上的概念演示，而是直接能干活的实用工具。例如在处理 PDF 文件时，你可以直接调用 pdf 技能，让它从指定的 PDF 文件里提取表单字段；在需要产出汇报材料或整理数据报表时，pptx、docx 和 xlsx 也能提供同样稳定的底层支撑。

自定义企业办公流水线的最佳范本
对于许多企业研发团队而言，最迫切的落地场景往往就是「内部文档自动化」——比如按固定格式生成文档草稿（docx）、从业务单据中提取表单字段（pdf）、自动化处理表格数据（xlsx）与演示文稿（pptx）。有了官方开源的这四个真实实现作为参考底座，团队完全可以在此基础上结合自身的 brand-guidelines（品牌规范）或内部流程，打磨出贴合自身业务系统的专属文档工作流。

四、三种使用入口与上手步骤：把技能装进你的工作流

了解了仓库里有哪些现成能力之后，接下来的问题就是：我们该怎么把这些技能真正用起来？

anthropics/skills 提供了三种不同的使用入口，分别对应 Claude Code、Claude 网页端以及 Claude API，覆盖了从个人开发调试、日常对话办公到企业系统集成的完整链路。

入口一：在 Claude Code 中通过插件市场安装使用

如果你是日常使用 Claude Code 进行编码和自动化操作的开发者，接入这套技能库的过程非常直接。仓库根目录下的 .claude-plugin 配置已经将技能打包成了可直接安装的插件集。你可以按照以下三步快速上手：

第一步：注册插件市场
在 Claude Code 中运行以下命令，将 anthropics/skills 仓库注册为插件市场来源：

/plugin marketplace add anthropics/skills

第二步：安装所需的技能插件
注册完成后，你可以选择安装 document-skills（文档技能）或 example-skills（示例技能）插件。你也可以直接运行带有完整命名空间的命令一步完成安装：

/plugin install document-skills@anthropic-agent-skills

或者安装示例技能插件：

/plugin install example-skills@anthropic-agent-skills

第三步：在对话中直接提及即可使用
插件安装妥当后，不需要编写额外的配置代码，直接在对话里提及即可使用。例如，当你装好了 document-skills 后，直接在对话中让 PDF 技能从指定的 PDF 里提取表单字段，Claude Code 就会按需动态加载 pdf 文件夹中的指令与脚本，按规范完成提取任务。同理，当你需要生成 MCP 服务或测试 Web 应用时，在对话里直接呼出 mcp-builder 或 webapp-testing 即可。

入口二：在 Claude 网页端直接使用或上传

如果你更习惯在 Claude 网页端处理日常文档、写作、设计或团队沟通，使用门槛同样很低：

**直接使用示例技能：**仓库中的示例技能已经向付费计划用户提供，无需手动配置环境就能在日常任务中调用这些能力。

**上传自定义技能：**除了使用官方预置的示例外，Claude 网页端也支持上传自定义技能。你可以把团队内部整理好的技能文件夹（例如定制版的 brand-guidelines 或 internal-comms）上传上去，让网页端的智能体立刻掌握你们团队的专属做事方法。

入口三：通过 Claude API 集成到业务系统

对于需要将智能体能力嵌入到自有应用或企业内部平台的开发团队，Claude API 同样提供了完善的技能支持：

**使用 Anthropic 预置技能：**可以直接在接口调用层面使用官方预置技能，省去从头编写复杂文档处理或常见任务逻辑的成本。

**上传自定义技能：**支持上传自定义技能，将企业内部的标准流程封装成独立模块，在自动化服务或后台系统中实现稳定复用。

这三种入口共用同一套 Skill 文件夹结构与 spec 规范。这意味着你写好的一份技能，不仅可以在自己的 Claude Code 里运行，也能打包上传到 Claude 网页端供同事使用，或者通过 Claude API 挂载到生产业务流中。

五、动手写一个自己的 Skill：模板结构与两个必填字段

自己写一个这样的技能难不难？答案是非常简单，这正是 anthropics/skills 获得约 19 万 Star 认可的原因之一：极度轻量化的设计思路。

1. 核心结构：独立文件夹与 SKILL.md

根据仓库中的 spec（Agent Skills 规范）与 template（技能模板），每个技能自成一个文件夹。在这个文件夹内部，最核心的文件是 SKILL.md，里面包含了 YAML 前置元数据（frontmatter）与具体的指令正文；如果有配套的辅助脚本或参考资源文件，也一并存放在同一个技能文件夹下。

2. 极简的前置元数据：必填只有两个字段

在 SKILL.md 顶部的 YAML 前置元数据中，没有繁琐冗长的配置项，必填只有两个字段：

name：技能的唯一标识，格式要求使用小写连字符（例如 algorithmic-art、doc-coauthoring、webapp-testing）。

description：清晰说明这个技能做什么、以及何时使用。

我们可以参考仓库中的 template 模板，写出一个最标准的 SKILL.md 示例结构：

---
name: brand-guidelines
description: 提供公司品牌视觉与行文规范。当需要按公司品牌规范制作文档、设计页面或审校对外宣传材料时使用。
---

# 品牌规范执行指令

在这里编写具体的品牌色彩要求、字体规范、用词准则，以及如何配合当前文件夹下的模板与脚本资源完成任务……

为什么 description 字段如此关键？这直接关系到前面提到的「Claude 按需动态加载」机制。智能体在接收用户任务时，正是依靠读取 name 和 description 来判断当前任务应该触发哪个技能。因此，在 description 中准确写清楚「技能做什么」和「何时使用」，是确保智能体能够在正确时机自动挂载该技能的核心前提。

当你准备动手创建自己的第一个技能时，既可以直接复制仓库里的 template 文件夹，修改 SKILL.md 的 name、description 与正文指令；也可以直接在对话中调用前面介绍过的 skill-creator（技能创作助手），让它引导你把日常重复的工作流程整理成符合 spec 规范的技能文件夹。

六、适用人群与落地注意事项

1. 适用人群

结合仓库的功能设计与三处使用入口，以下两类人群能从中获得最直接的帮助：

**用 Claude Code、Claude 网页端或 Claude API 做开发、写文档、做设计、管企业沟通的开发者与团队：**无论你是想用 mcp-builder、webapp-testing、web-artifacts-builder、claude-api 提升开发效率，用 algorithmic-art、canvas-design、frontend-design、theme-factory 辅助创意设计，还是用 docx、pdf、pptx、xlsx 处理办公文档，仓库里的现成技能都能直接为你节省大量摸索时间。

**想把重复工作沉淀成可复用做法的人：**如果你希望把按公司品牌规范做文档、按组织流程分析数据或自动化个人任务的经验固化下来，通过 SKILL.md 与配套脚本打包成文件夹，就能轻松实现跨对话、跨成员的稳定复用。

2. 官方提示与落地注意事项

尽管仓库中许多技能以 Apache 2.0 许可证开源，且包含了四大文档技能与 Notion 合作技能等丰富内容，但在实际落地应用时，请务必留意官方给出的两点重要提示：

**演示与教学定位：**官方明确提示，仓库中的技能仅作演示与教学用途，实际产品中的实现与行为可能与仓库展示的内容存在不同。

**关键任务前充分测试：**由于智能体会根据上下文动态加载并执行技能中的指令与脚本，在将任何技能用于关键任务前，都应在自己的环境里进行充分测试，确保其实际表现完全符合你的业务预期与安全要求。

结语

从创建于 2025 年 9 月 22 日至今积累约 19 万 Star、约 2.2 万 Fork，到 docx、pdf、pptx、xlsx 四大文档技能底层实现的开源，再到仅需 name 与 description 两个必填字段就能定义的 SKILL.md 规范，anthropics/skills 为我们展示了一种高度务实的智能体工程化路径：用最清晰的「指令、脚本与资源组成的文件夹」，让智能体学会按需动态加载、稳定复用人类沉淀下来的最佳实践。

如果你正在使用 Claude Code、Claude 网页端或 Claude API，不妨挑一个最常遇到的重复性任务，试着用 template 模板或 skill-creator 动手封装你的第一个智能体技能包。