技能
Anthropic Agent Skills
Anthropic 公开的技能仓库,用来看 SKILL.md 该怎么写。
这是 Anthropic 放出来的 Agent Skills 仓库。一个技能通常是一份 SKILL.md,再加上可选的脚本和参考资料,让支持这种格式的代理在某类任务里按同一套步骤工作,而不是每次聊天都从头交代。
适合想对齐官方写法、再改成自己技能的人。先看仓库说明和示例技能的触发条件,确认依赖以后,把需要的那一份拷到自己的技能目录里改。仓库没有检出 SPDX 许可证,本站不转载技能正文。
本页是导读,不是原文。
解决什么问题
Anthropic 的 anthropics/skills 是官方公开的技能仓库。技能是一个文件夹:里面有一份 SKILL.md,还可以带脚本和参考文件。代理会先读每份技能的名称和描述,只在任务匹配时再加载正文,用来把一套可重复的步骤固定下来,例如按公司规范改文档,或按你们团队的方式跑检查。
这个仓库既有示例技能,也公开了 Claude 文档能力背后的 docx、pdf、pptx、xlsx 技能,供对照 SKILL.md 该怎么写。仓库还指向 Agent Skills 规范(agentskills.io)。README 写明:这些技能主要用于演示和教学,实际行为可能和 Claude 产品里不完全一样,重要任务要在自己的环境里先试。
适合谁
适合已经在用 Claude Code,想安装官方示例或文档技能,或准备自己写 SKILL.md 的人。README 写明,仓库里的示例技能在 Claude.ai 的付费方案中已经可用;也可以按官方说明,通过 Claude API 使用预置技能或上传自定义技能。自定义技能在 Claude Code 里是文件,不必先上传。
使用这些技能的前提是你已经能进入相应产品。Claude Code 本身需要官方支持的付费或 Console 方案,且受 Anthropic 支持地区政策约束,详见 Claude Code 条目。本文不重复展开登录步骤。
怎么装
核验日期为 2026-11-15(Asia/Shanghai),命令来自该仓库 README 和官方技能文档。
在 Claude Code 里,先把本仓库登记为插件市场:
/plugin marketplace add anthropics/skills然后可在界面里选择 anthropic-agent-skills,再安装 document-skills 或 example-skills。也可以直接安装:
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills装好后,用自然语言点名即可。例如官方示例:安装 document-skills 之后,可以说「Use the PDF skill to extract the form fields from path/to/some-file.pdf」。
若要自己写技能,不必走市场。在个人目录创建文件夹和 SKILL.md:
mkdir -p ~/.claude/skills/my-skill-nameSKILL.md 必须以 YAML 前言开头,官方模板是:
---
name: my-skill-name
description: A clear description of what this skill does and when to use it
---
# My Skill Name
[Add your instructions here that Claude will follow when this skill is active]name 与 description 是必需字段。name 用小写字母、数字和连字符,并应与目录名一致。项目级技能放在仓库的 .claude/skills/ 下,以便提交给同事。平台文档还提到:Claude.ai 和 API 里预置的文档技能并不随 Claude Code 捆绑提供;要在 Claude Code 里用 PDF / Word 等技能,请按上面安装 document-skills 插件,不要假定已经内置。
一个实际例子
下面按官方 README 的提示词来做。本次没有在本机实际抽取某个 PDF,因此不编造字段列表。
- 在 Claude Code 中完成市场登记,并安装
document-skills@anthropic-agent-skills。 - 准备一个你自己有权打开的 PDF,换成真实路径。
- 发送:
Use the PDF skill to extract the form fields from path/to/some-file.pdf。按官方说明,点名技能后,Claude 应加载 PDF 技能并尝试提取表单字段。 - 请自己核对提取结果是否完整。仓库免责声明写过,示例实现与产品里的行为可能不同,不要把一次输出当成最终数据。
常见坑
- 把它当成已经保证可用的生产功能。README 的免责声明写明,这些技能用于演示和教学,Claude 里的实现和表现可能不同。请先在自己的环境里测试。
- 两个插件内容重叠。issue #189 报告:
document-skills和example-skills可能装进相同内容,造成重复技能。若列表里出现两份相同技能,先检查是不是两个插件都装了。 - 市场安装失败。issue #14 报告过用 CLI 添加
anthropics/skills时出错。可对照官方插件排障,或改把技能文件夹复制到~/.claude/skills/。 - 装上了却没加载。issue #67 提到,经市场安装后,若缺少预期的
skills/目录结构,Claude Code 可能加载不到。issue #1943 则报告 Claude Desktop 刷新市场后出现「conflicting manifests」。这些 issue 仍可能开放,请以当前报错和官方排障为准。 - 仓库里的文档技能副本可能落后于 Claude.ai。 issue #2104 提到 docx、pptx、xlsx 的仓库副本曾落后数月。需要最新行为时,以产品内技能和官方文档为准。
FAQ
一定要先上传技能吗?
在 Claude Code 里不必。把文件夹放到 ~/.claude/skills/ 或项目的 .claude/skills/ 即可。若走 Claude.ai 或 API,才需要按官方说明上传或使用预置技能。
SKILL.md 最少要写什么?
官方要求 YAML 前言里有 name 和 description。description 会用来判断何时自动加载,所以应写清做什么、什么时候用。正文再写具体步骤。
这些技能是什么许可?
README 写明,仓库中许多技能(含文档技能)以 Apache 2.0 开源。本轮在仓库根目录未找到独立的 LICENSE 文件,许可以 README 和各技能目录内说明为准。
和 CLAUDE.md 有什么不同?
CLAUDE.md 会在每次会话开始时加载,适合长期有效的项目约定。技能按需加载,适合一整套手续。官方建议:当 CLAUDE.md 里某一段已经变成流程,就改写成技能。
Claude Code 里默认就有 PDF、Word 技能吗?
平台文档写明,预置的文档技能不在 Claude Code 里直接提供。要使用,请安装本仓库的 document-skills 插件,或自行复制相应技能文件夹。
来源与许可
来源是 anthropics/skills 在 2026-11-15 的 README,以及官方 Agent Skills 概览、Claude Code 技能文档 和 如何编写技能。本文用自己的话写成,供 CQBase 上下文库使用。若安装命令或许可说明有变,以仓库和官网为准。