在 Claude 的生态中，“**Agent Skills（代理技能）”是一个非常核心的概念。它不是简单的一段话或提示语，而是一种能够让 Claude 执行复杂任务、自动调用功能模块并复用专业知识的强大机制。通过 Skill，Claude 不再是“通用的大模型”，而成为一个能够专业完成特定任务的智能助手。

什么是 Agent Skills？

简单来说，Agent Skills 是一组可复用的模块化能力，它们包含具体的说明、元数据和可选资源（比如脚本、模板等），能够扩展 Claude 的功能。Skills 能让 Claude 在遇到特定任务时自动触发并加载相关逻辑，而不需要每次都重复写提示语。

相比传统通过提示（prompt）一次性指令的方式，Skills 是一种长期积累、按需调用的机制：

• 让 Claude 更专业 (Specialize Claude)：为特定领域或任务定制专属能力

• 减少重复工作 (Reduce repetition)：一次创建，自动复用

• 能力可组合 (Compose capabilities)：通过组合多个 Skills，构建复杂的工作流程

Skills 是如何工作的？

Claude 的 Skills 是基于虚拟机（VM）和文件系统的架构，这种底层设计使得 Skills 可以分层加载信息，有效节省上下文空间：

三级加载机制

Level 1 — 元数据（Meta）- always loaded：

• 每个 Skill 都有 YAML 格式的元数据：name、description 等信息。

• Claude 启动时就预加载这些信息，但不会占用大量上下文。

---
name: pdf-processing
description: Extract text and tables from PDF files, fill forms, merge documents. Use when working with PDF files or when the user mentions PDFs, forms, or document extraction.
---

Level 2 — 指令（Instructions）- loaded when triggered：

• 当 Skill 被触发，Claude 才会加载这个 Skill 的主体内容（例如操作流程、示例等）。

• 这部分最多几千个 token，不会浪费上下文。

# PDF Processing

## Quick start

Use pdfplumber to extract text from PDFs:

```python
import pdfplumber

with pdfplumber.open("document.pdf") as pdf:
    text = pdf.pages[0].extract_text()
```

For advanced form filling, see [FORMS.md](FORMS.md).

Level 3 — 代码和资源 -  (loaded as needed)：

• Skills 可以包括脚本、资源文件或额外文档。

• Claude 只有在真正需要运行或读取时才会访问，节省空间且提升执行效率。

pdf-skill/
├── SKILL.md (main instructions)
├── FORMS.md (form-filling guide)
├── REFERENCE.md (detailed API reference)
└── scripts/
    └── fill_form.py (utility script)

这种“渐进式揭露（Progressive Disclosure）”机制确保 Claude 在执行任务时，只把真正需要的信息纳入其思考上下文，不会一次性加载大量内容。

Skills 的架构

Skills 运行在一个代码执行环境中，在这个环境里，Claude 拥有文件系统访问权限、可以执行 bash 命令，并具备运行代码的能力。你可以这样理解：Skills 就像是存在于一台虚拟机上的目录，而 Claude 通过与你在自己电脑上浏览文件时相同的 bash 命令来与这些目录进行交互。

Agent Skills 架构展示了 Skills 是如何与智能体的配置以及虚拟机环境集成在一起的。

Claude 如何访问 Skill 内容

当某个 Skill 被触发时，Claude 会使用 bash 命令从文件系统中读取 SKILL.md，并将其中的指令加载到上下文窗口中。如果这些指令引用了其他文件（例如 FORMS.md 或数据库结构说明），Claude 会通过额外的 bash 命令继续读取这些文件。

当指令中提到可执行脚本时，Claude 会通过 bash 运行这些脚本，并只接收脚本的输出结果（脚本本身的代码不会进入上下文）。

这种架构带来的能力

按需加载文件

Claude 只会读取当前任务真正需要的文件。
一个 Skill 中可以包含几十个参考文件，但如果你的任务只需要“销售数据结构”，Claude 就只会加载那个文件，其余文件仍保留在文件系统中，完全不占用 token。

高效的脚本执行

当 Claude 运行 validate_form.py 这类脚本时，脚本源码不会被加载进上下文窗口。
只有脚本的执行结果（例如“校验通过”或具体的错误信息）才会消耗 token。这种方式比让 Claude 即时生成并理解等价代码要高效得多。

几乎无限的内容容量

由于文件只有在被访问时才会消耗上下文，Skills 可以打包：

• 完整的 API 文档

• 大型数据集

• 大量示例

• 各类参考资料

未被使用的内容不会产生任何上下文成本，因此在实践中几乎不存在内容规模的限制。

渐进式揭露（Progressive Disclosure）

这种基于文件系统的模型，正是实现“渐进式揭露”的关键。

Claude 像阅读一本入职手册一样，只在需要时查阅特定章节，而不是一次性把整本书塞进大脑中——每个任务只加载它真正需要的信息。

示例：加载一个 PDF 处理 Skill

下面是 Claude 加载并使用一个 PDF 处理 Skill 的过程：

1.启动阶段： 系统提示中包含 Skill 的元信息，例如：PDF Processing —— 从 PDF 文件中提取文本和表格、填写表单、合并文档

2. 用户请求： 用户输入：

“从这个 PDF 中提取文本并进行总结”

3. Claude 触发 Skill

Claude 执行：
bash: read pdf-skill/SKILL.md
→ 将 Skill 的指令加载进上下文

4. Claude 判断所需内容

发现当前任务不需要填写表单
→ FORMS.md 不会被读取

5. Claude 执行任务

使用 SKILL.md 中的指令完成文本提取与总结

上下文加载示意图说明

该示意图展示了：

• 默认状态：系统提示和 Skill 元数据已预加载

• Claude 通过 bash 读取 SKILL.md 触发 Skill

• 根据需要选择性读取其他文件（如 FORMS.md）

• Claude 继续完成任务

这种动态加载机制确保只有与当前任务相关的 Skill 内容才会占用上下文窗口。

Skills 可以在哪些场景使用？

Claude 提供了大量预制的 Skills，并支持开发者和团队自定义：

预制内置 Skills

目前官方提供的预制 Skills 覆盖了常见的文档处理任务：

• PowerPoint（pptx）：创建、编辑、分析幻灯片；

• Excel（xlsx）：生成表格、做数据分析、图表设计；

• Word（docx）：撰写/格式化文档；

• PDF（pdf）：提取文本、填表单、合并/生成 PDF 报告。

这些 skills 能够让 Claude 在相关任务上做到比普通提示更专业、更自动。

如何创建自定义 Skills？

除了预制的能力，你还可以：

• 在 Claude Code 中创建自己的 Skill；

• 通过 API 上传和管理 Skills；

• 在 claude.ai 设置界面 中部署 Skills；

自定义 Skills 可以帮助团队封装组织内部流程、业务逻辑甚至行业专用知识，让 Claude 变成真正的“业务专家”。

⚠️ 安全提示：由于 Skills 可能包含可执行代码或文件访问内容，务必只使用来自可信来源的 Skills，并严格审查 Skill 内的指令与脚本。

Skills 和传统 Prompt 有什么不同？

特性	Prompt	Skills
是否复用	❌ 每次需要重复输入	✅ 定义一次即可复用
是否专业	✖ 通用	✔ 可定制专业流程
是否可触发执行	❌ 需要手动提示调用	✔ Claude 可自动识别并触发
是否含代码逻辑	❌ 纯自然语言	✔ 可包含脚本和资源

这样，Skills 不再只是写提示，而是让 Claude 具备“按模块执行任务”的专业能力。

总结

Claude 的 Agent Skills 是一种将 AI 变成可组合、可自动执行的“智能模块”的机制，它通过文件系统组织结构、渐进式加载和可扩展性，让 Claude 在专业任务上更高效、更稳定。无论是处理文档，还是构建复杂工作流程，Skills 都是不可或缺的能力拓展工具。

如果你正在构建自己的 AI 工具链，或者希望 Claude 能更“贴合业务场景”，深入学习 Skills 的架构和用法将是非常重要的一步。

参考资料

https://platform.claude.com/docs/en/agents-and-tools/agent-skills/overview

https://agentskills.io/home

https://github.com/anthropics/skills