# Anthropic Agent Skills

Canonical: https://cqbase.net/zh/entry/anthropics-skills
Chinese: https://cqbase.net/zh/entry/anthropics-skills
English: https://cqbase.net/en/entry/anthropics-skills

> Anthropic 公开的技能仓库，用来看 SKILL.md 该怎么写。

这是 Anthropic 放出来的 Agent Skills 仓库。一个技能通常是一份 SKILL.md，再加上可选的脚本和参考资料，让支持这种格式的代理在某类任务里按同一套步骤工作，而不是每次聊天都从头交代。

适合想对齐官方写法、再改成自己技能的人。先看仓库说明和示例技能的触发条件，确认依赖以后，把需要的那一份拷到自己的技能目录里改。仓库没有检出 SPDX 许可证，本站不转载技能正文。

## 解决什么问题

Anthropic 的 [anthropics/skills](https://github.com/anthropics/skills) 是官方公开的技能仓库。技能是一个文件夹：里面有一份 `SKILL.md`，还可以带脚本和参考文件。代理会先读每份技能的名称和描述，只在任务匹配时再加载正文，用来把一套可重复的步骤固定下来，例如按公司规范改文档，或按你们团队的方式跑检查。

这个仓库既有示例技能，也公开了 Claude 文档能力背后的 docx、pdf、pptx、xlsx 技能，供对照 `SKILL.md` 该怎么写。仓库还指向 Agent Skills 规范（[agentskills.io](https://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 里，先把本仓库登记为插件市场：

```text
/plugin marketplace add anthropics/skills
```

然后可在界面里选择 `anthropic-agent-skills`，再安装 `document-skills` 或 `example-skills`。也可以直接安装：

```text
/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`：

```bash
mkdir -p ~/.claude/skills/my-skill-name
```

`SKILL.md` 必须以 YAML 前言开头，官方模板是：

```markdown
---
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，因此不编造字段列表。

1. 在 Claude Code 中完成市场登记，并安装 `document-skills@anthropic-agent-skills`。
2. 准备一个你自己有权打开的 PDF，换成真实路径。
3. 发送：`Use the PDF skill to extract the form fields from path/to/some-file.pdf`。按官方说明，点名技能后，Claude 应加载 PDF 技能并尝试提取表单字段。
4. 请自己核对提取结果是否完整。仓库免责声明写过，示例实现与产品里的行为可能不同，不要把一次输出当成最终数据。

## 常见坑

- 把它当成已经保证可用的生产功能。README 的免责声明写明，这些技能用于演示和教学，Claude 里的实现和表现可能不同。请先在自己的环境里测试。
- 两个插件内容重叠。[issue #189](https://github.com/anthropics/skills/issues/189) 报告：`document-skills` 和 `example-skills` 可能装进相同内容，造成重复技能。若列表里出现两份相同技能，先检查是不是两个插件都装了。
- 市场安装失败。[issue #14](https://github.com/anthropics/skills/issues/14) 报告过用 CLI 添加 `anthropics/skills` 时出错。可对照官方插件排障，或改把技能文件夹复制到 `~/.claude/skills/`。
- 装上了却没加载。[issue #67](https://github.com/anthropics/skills/issues/67) 提到，经市场安装后，若缺少预期的 `skills/` 目录结构，Claude Code 可能加载不到。[issue #1943](https://github.com/anthropics/skills/issues/1943) 则报告 Claude Desktop 刷新市场后出现「conflicting manifests」。这些 issue 仍可能开放，请以当前报错和官方排障为准。
- 仓库里的文档技能副本可能落后于 Claude.ai。 [issue #2104](https://github.com/anthropics/skills/issues/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](https://github.com/anthropics/skills) 在 2026-11-15 的 README，以及官方 [Agent Skills 概览](https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview)、[Claude Code 技能文档](https://code.claude.com/docs/en/skills) 和 [如何编写技能](https://claude.com/docs/skills/how-to)。本文用自己的话写成，供 CQBase 上下文库使用。若安装命令或许可说明有变，以仓库和官网为准。

## 收录信息

- 作者: anthropics
- 许可证: 未知
- 来源: https://github.com/anthropics/skills
- 收录: 2026-11-15
- GitHub 星标: 194890（采集 2026-11-15）

