Claude Skills 是什么？Agent Skills 上手指南（2026）

Claude Skills（官方叫 Agent Skills，中文常说「技能」）是 Anthropic 推出的一种给 AI 代理扩展能力的方式：把一套针对特定任务的指令、脚本和参考资料打包成一个文件夹，Claude 会在遇到相关任务时按需自动加载，从而在这类任务上表现得更专业、更稳定。它和 MCP、CLAUDE.md 是互补的三件套。这篇 Claude Skills 上手指南带你搞清楚它到底是什么、SKILL.md 怎么写、和 MCP / CLAUDE.md 有什么区别，以及在 Claude Code 里怎么创建和使用。

Claude Skills 是什么

一个 Skill（技能）本质上就是一个文件夹，里面必须有一个 SKILL.md 文件，可选地再带上脚本、参考文档和模板资源。SKILL.md 用一段 YAML 头部声明这个技能「叫什么、什么时候该用」，正文写清具体怎么做。Claude 平时只把所有技能的名称和描述加载进上下文（很省 token），只有当你的任务和某个技能的描述匹配时，才会把这个技能的完整内容读进来照着做。这样就能把「专业领域的做事方法」沉淀成可复用、可分享的能力包，让通用的 Claude 变成某个具体任务上的专家。

SKILL.md 怎么写：一个文件夹的结构

技能目录里只有 SKILL.md 是必需的，其余都可选。典型结构如下：SKILL.md 放核心指令，scripts/ 放可执行脚本，references/ 放需要时才读的参考文档，assets/ 放模板等资源。SKILL.md 必须以 YAML 前置信息（frontmatter）开头，其中 name 和 description 两个字段是必填的——description 尤其关键，Claude 就是靠它判断「这个任务该不该调用这个技能」，所以要把触发场景、用户可能说的原话写清楚。

# 一个技能文件夹的典型结构
my-skill/
├── SKILL.md        # 必需：YAML 头 + 核心指令
├── scripts/        # 可选：Python / Bash 脚本
├── references/     # 可选：按需加载的参考文档
└── assets/         # 可选：模板、样例等资源

---
name: pdf-form-filler
description: 当用户需要填写、提取或处理 PDF 表单时使用。适用于「填 PDF 表单」「提取 PDF 字段」「合并/拆分 PDF」等请求。
---

# PDF 表单处理

遇到 PDF 表单任务时，按以下步骤：
1. 先用 scripts/inspect.py 读出表单字段清单
2. 根据用户数据填充对应字段
3. 复杂字段映射规则见 references/forms.md

（正文写清「怎么做」，把冗长细节拆到 references/ 里按需加载。）

渐进式披露：为什么它比「一股脑塞进提示词」聪明

Skills 的核心设计叫「渐进式披露」（progressive disclosure），分三层加载，既让能力无限扩展，又不浪费上下文：

1. 1第一层——元数据：启动时只把每个技能的 name 和 description 读进系统提示词，占用极小。
2. 2第二层——核心内容：当 Claude 判断某个技能和当前任务相关，才把这个技能的 SKILL.md 正文完整加载。
3. 3第三层——补充文件：需要时再去读 references/ 里的参考文档或调用 scripts/ 里的脚本。

Skills vs MCP vs CLAUDE.md / AGENTS.md：别搞混

这三样经常被放在一起讨论，但解决的问题不同，配合起来用最好：

简单说：CLAUDE.md / AGENTS.md 是「每次都带着的项目说明书」，MCP 是「能伸出去操作外部世界的手」，Skills 是「按需翻出来的专业操作手册」。想深入了解另外两个，站内有 MCP 入门 和 AGENTS.md / CLAUDE.md 怎么写 的专门文章。

在 Claude Code 里创建和使用技能

Skills 可以在 Claude.ai、Claude Code、Claude Agent SDK 和开发者平台（API）里用。以 Claude Code 为例，技能放在两个位置：个人技能放 ~/.claude/skills/（所有项目通用），项目技能放 项目根目录/.claude/skills/（随仓库提交，团队共享同一套）。创建一个技能就是新建文件夹 + 写 SKILL.md 这么简单：

# 创建一个个人技能（对所有项目生效）
mkdir -p ~/.claude/skills/my-skill
# 然后在里面写 SKILL.md（含 name / description 头部 + 指令正文）

# 或创建项目级技能（随 git 提交、团队共享）
mkdir -p .claude/skills/my-skill

# 写好后无需注册，Claude 会自动发现；
# 任务匹配到 description 时自动触发，也可显式点名让它用某个技能。

Claude Skills 把「专业任务的做事方法」变成了可复用、可分享的资产，是继 MCP、CLAUDE.md 之后又一个值得掌握的 AI 编程基本功。但技能写得好不好、能不能真正提效，考验的还是你对任务的拆解能力和工程判断。想系统掌握用 AI 工具做出能交付产品的方法论，欢迎来 IMAI 看看我们的体系化实战课程。