Agent Skills
Agent Skills 是模块化能力系统，扩展 Claude 的功能。每个 Skill 打包指令、元数据和可选资源（脚本、模板），Claude 在相关时自动使用。
为什么使用 Skills
Skills 是可复用的、基于文件系统的资源，为 Claude 提供领域特定专业知识：工作流、上下文和最佳实践，将通用代理转变为专家。
关键优势：
- 专业化 Claude：为特定领域任务定制能力
- 减少重复：创建一次，自动使用
- 组合能力：组合 Skills 构建复杂工作流
使用 Skills
Anthropic 为常见文档任务（PowerPoint、Excel、Word、PDF）提供预构建的 Agent Skills，你也可以创建自己的自定义 Skills。两者工作方式相同，Claude 在相关时自动使用它们。
预构建 Agent Skills
所有 claude.ai 和 Claude API 用户都可以使用。查看可用 Skills 章节了解完整列表。
自定义 Skills
让你打包领域专业知识和组织知识。可在 Claude 的所有产品中使用：在 Claude Code 中创建，通过 API 上传，或在 claude.ai 设置中添加。
Skills 工作原理
Skills 利用 Claude 的 VM 环境提供超越单纯提示的能力。Claude 在具有文件系统访问的虚拟机中运行，允许 Skills 作为包含指令、可执行代码和参考材料的目录存在。
渐进式披露
Skills 可以包含三种类型的内容，每种在不同时间加载：
Level 1: 元数据（始终加载）
- Skill 的 YAML frontmatter 提供发现信息
- Claude 在启动时加载此元数据并包含在系统提示中
- 轻量级方法意味着你可以安装许多 Skills 而无上下文惩罚
Level 2: 指令（触发时加载）
- SKILL.md 主体包含过程知识：工作流、最佳实践和指导
- 当你请求与 Skill 描述匹配的内容时，Claude 通过 bash 从文件系统读取 SKILL.md
- 只有这时内容才进入上下文窗口
Level 3: 资源和代码（按需加载）
- Skills 可以捆绑额外材料：
- 指令: 额外的 markdown 文件
- 代码: Claude 通过 bash 运行的可执行脚本
- 资源: 数据库模式、API 文档、模板或示例等参考材料
| Level | 加载时机 | Token 成本 | 内容 |
|---|---|---|---|
| Level 1: 元数据 | 始终（启动时） | ~100 tokens/Skill | YAML frontmatter 中的 name 和 description |
| Level 2: 指令 | Skill 触发时 | <5k tokens | SKILL.md 主体的指令和指导 |
| Level 3+: 资源 | 按需 | 实际无限 | 通过 bash 执行的捆绑文件，内容不加载到上下文 |
可用 Skills
预构建 Agent Skills
以下预构建 Agent Skills 可立即使用：
- PowerPoint (pptx): 创建演示文稿、编辑幻灯片、分析演示内容
- Excel (xlsx): 创建电子表格、分析数据、生成带图表的报告
- Word (docx): 创建文档、编辑内容、格式化文本
- PDF (pdf): 生成格式化的 PDF 文档和报告
这些 Skills 在 Claude API 和 claude.ai 上可用。查看快速开始教程开始在 API 中使用它们。
自定义 Skills 示例
完整的自定义 Skills 示例，请参阅 Skills cookbook。
Skill 结构
每个 Skill 需要一个带 YAML frontmatter 的 SKILL.md 文件：
---
name: 你的 Skill 名称
description: 此 Skill 的简要描述以及何时使用它
---
# 你的 Skill 名称
## 指令
[Claude 遵循的清晰分步指导]
## 示例
[使用此 Skill 的具体示例]必需字段: name 和 description
Frontmatter 限制:
name: 最多 64 字符description: 最多 1024 字符
快速导航
安全注意事项
我们强烈建议仅使用来自可信来源的 Skills：你自己创建的或从 Anthropic 获得的。Skills 通过指令和代码为 Claude 提供新能力，虽然这使它们强大，但也意味着恶意 Skill 可以指导 Claude 以与 Skill 声明目的不符的方式调用工具或执行代码。
限制和约束
跨表面可用性
自定义 Skills 不跨表面同步。上传到一个表面的 Skills 不会自动在其他表面可用。
运行时环境约束
Skills 在代码执行容器中运行，有以下限制：
- 无网络访问: Skills 无法进行外部 API 调用或访问互联网
- 无运行时包安装: 仅预装包可用
- 仅预配置依赖: 查看代码执行工具文档了解可用包列表