Agent Skills

Skill（技能）是 Claude 的一种模块化能力扩展机制。每个 Skill 本质上是一个包含指令、脚本和资源文件的文件夹，当 Claude 判断某个任务与某个 Skill 相关时，会自动加载其中的指令来指导自己完成任务。

简单来说，Skill 就像是给 Claude 发了一本「专业操作手册」。平时手册放在书架上不占桌面空间，需要时才拿下来翻开使用。

Claude 本身已经很强大，但面对某些任务时，没有 Skill 和有 Skill 的区别非常明显：

没有 Skill 的痛点

有了 Skill 之后

每个 Skill 本质上就是一个文件夹，结构非常简洁：

SKILL.md 的基本格式

---
name: daily-report
description: "生成团队日报。当用户提到日报、每日总结、工作汇报时触发此 Skill。"
---

# 团队日报生成器

## 工作流程
1. 询问用户今天完成的工作内容
2. 按照以下模板整理输出
3. 生成 Markdown 格式的日报

## 输出模板
# [日期] 工作日报
## 今日完成
## 进行中
## 明日计划
## 需要协助

就这么简单！一个 SKILL.md 文件就是一个完整的 Skill。上面的 YAML 部分（两行 --- 之间）是元数据，下面的 Markdown 正文是详细指令。

Skill 最精妙的设计是它的三级渐进式加载（Progressive Disclosure）机制。这保证了效率——不用的指令不占空间。

Level 1：元数据扫描（始终在上下文中）

Claude 启动时，会加载所有可用 Skill 的 name 和 description。就像看书架上每本书的书脊标题——只需一眼就知道有什么，每个 Skill 仅占约 100 tokens。

Level 2：SKILL.md 正文（触发时加载）

当 Claude 判断某个 Skill 与当前任务相关时，才加载该 Skill 的完整指令。就像从书架上取下那本书翻开阅读。

Level 3：捆绑资源（按需使用）

SKILL.md 中引用的脚本、参考文档、模板等，只有在实际需要时才会读取或执行。就像翻到食谱某一页后，发现需要用到附录里的酱料配方表，才翻到附录去看。

Skill 有两种调用方式，取决于谁来决定「用不用这个 Skill」：

自动触发的工作流程

官方预置 Skill

社区热门自定义 Skill

你可以用 Skill 做什么？

• 标准化工作流程——每次做日报、周报、代码审查都遵循统一格式
• 封装领域知识——把公司的品牌规范、编码标准打包成 Skill
• 教会 Claude 用特定工具——比如教它如何使用你的内部 API
• 自动化多步骤任务——部署、测试、生成报告等复杂流程
• 团队知识共享——一个人写好 Skill，整个团队都能受益

让我们一步步创建一个真实可用的 Skill。我们将创建一个「会议纪要生成器」。

步骤一：创建文件夹

mkdir meeting-notes
cd meeting-notes
touch SKILL.md

步骤二：编写 SKILL.md

---
name: meeting-notes
description: "生成结构化的会议纪要。当用户提到会议纪要、
  meeting notes、会议记录、会议总结时使用此 Skill。"
---

# 会议纪要生成器

根据用户提供的会议信息，生成结构化的会议纪要。

## 工作流程

1. 确认以下信息（如用户未提供则主动询问）：
   - 会议主题
   - 参与人员
   - 会议日期
   - 讨论内容要点
2. 按照下方模板整理输出
3. 提取关键的待办事项（Action Items）并标注负责人

## 输出模板

使用以下 Markdown 格式：

```
# 会议纪要：[主题]
**日期**：[YYYY-MM-DD]
**参会人**：[人员列表]
**记录人**：AI 助手

## 会议要点
- [要点 1]
- [要点 2]

## 决议事项
| 编号 | 决议 | 负责人 | 截止日期 |
|------|------|--------|----------|

## 待办事项 (Action Items)
- [ ] [任务] — @[负责人] — DDL: [日期]

## 下次会议
- 时间：
- 议题：
```

## 注意事项
- 语言风格保持正式、简洁
- 待办事项必须有明确的负责人
- 如果信息不完整，先总结已有信息，再列出需要补充的部分

步骤三：安装使用

根据你使用的平台，安装方式不同（详见第 10 章）。在 Claude.ai 中，你可以将文件夹压缩为 zip，然后在「设置 → 功能 → 自定义技能」中上传。在 Claude Code 中，放到 .claude/skills/ 目录即可。

元数据字段（YAML Frontmatter）

编写 description 的黄金法则

正文编写技巧

• 使用祈使语气——「生成报告」而不是「你应该生成报告」
• 提供具体示例——输入是什么样、输出应该是什么样
• 解释 "为什么"——告诉 Claude 为什么某些步骤很重要，比单纯的命令更有效
• 控制在 500 行以内——超出则拆分到 references/ 子文件中
• 给出输出模板——明确的格式模板能大幅提升一致性

简单的 Skill 只需一个 SKILL.md。但对于复杂任务，你可以添加可执行脚本和参考文档。

添加脚本

脚本是 Skill 的「肌肉」——它们处理确定性的、重复性的任务，比如文件转换、数据处理等。

在 SKILL.md 中引用脚本：

## 数据清洗
使用内置脚本清洗 CSV 文件中的异常值：
```bash
python scripts/clean_csv.py input.csv output.csv
```
脚本会自动处理：空行删除、编码转换、列名标准化。

添加参考文档

当 Skill 需要支持多种场景时，把不同场景的详细说明拆分到 references/ 目录中：

Claude 只会读取与当前任务相关的那个参考文件。如果用户说「部署到 AWS」，Claude 只加载 aws.md，不会浪费上下文读取 gcp.md。

资源文件 (assets/)

assets/ 目录用来存放输出中会用到的静态资源，如模板文件、公司 Logo 图片、自定义字体等。Claude 在执行任务时会直接引用这些文件。

Skill 是跨平台的开放标准。创建一次，可以在 Claude 的所有产品中使用：

在 Claude.ai 中使用

在 Claude API 中使用

import anthropic

client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-20250514",
    max_tokens=4096,
    tools=[{"type": "code_execution"}],
    # 在 container 中指定 Skill
    container={
        "type": "default",
        "skills": [
            {
                "type": "anthropic",
                "skill_id": "pptx",  # 预置 Skill
            },
            {
                "type": "custom",
                "skill_id": "sk_abc123",  # 自定义 Skill
            }
        ]
    },
    messages=[{
        "role": "user",
        "content": "创建一份 Q3 销售汇报 PPT"
    }]
)

Skill 和 MCP 是 Claude 生态中两种互补的扩展机制。理解它们的区别是架构决策的关键。

什么时候用什么？

生态现状

截至 2026 年初，Skill 生态已经蓬勃发展：

• 2025 年 12 月，Anthropic 将 Agent Skills 规范开源发布
• OpenAI 为 Codex CLI 和 ChatGPT 采纳了同样的 SKILL.md 格式
• 社区已创建数千个 Skill，覆盖编程、设计、运维、写作、数据分析等领域
• SkillsMP.com 等市场平台涌现，提供 Skill 发现与分发服务
• 官方预置的文档类 Skill（docx、pptx、xlsx、pdf）已在 Claude.ai 和 API 中广泛使用

安全注意事项

未来方向