同一件事每次都要重新交代?Skill 就是把「这件事该怎么做」存成一个文件夹,AI 需要时自己读进去。讲清它的结构、三级加载机制,以及它和提示词、MCP 的分工
Skill(技能)是一个文件夹,里面必须有一个 SKILL.md,写清楚某件事该怎么做,还可以附上脚本、模板和参考资料。AI 通过「渐进式加载」使用它:启动时只读名称和描述,任务对得上才读正文,需要时才打开附带文件——所以你可以挂很多个 Skill 而几乎不占上下文。Skill 由 Anthropic 提出并已开源成公开标准,Claude Code、Codex、Cursor、VS Code、Gemini CLI 等几十个工具都支持。
如果你已经用 AI 做过一段时间的重复工作,大概率有过这种感觉:
每一次你都在把同一份说明书口述一遍。说漏一句,产出就跑偏一次。
Skill 解决的就是这个问题:把这份说明书写下来存好,AI 需要的时候自己去读。

这一篇只讲它是什么、长什么样、怎么工作。安装看 3.5,自己动手封装看 4.4。
官方标准站(agentskills.io)的定义是:
Agent Skills 是一种轻量的开放格式,用来给 AI agent 扩展专门的知识和工作流程。它的核心就是一个包含
SKILL.md文件的文件夹:这个文件包含元数据(至少要有 name 和 description)和指导 agent 完成某项任务的说明;此外还可以打包脚本、参考资料、模板等资源。
所以一个 Skill 的目录结构长这样:

my-skill/
├── SKILL.md # 必需:元数据 + 说明
├── scripts/ # 可选:可执行的代码
├── references/ # 可选:参考文档
├── assets/ # 可选:模板、素材
└── ... # 其他任何文件
SKILL.md 本身就是一个普通的 Markdown 文件,开头有一小段 YAML 元数据:
---
name: weekly-report
description: 按公司模板写周报。当用户要求写周报、周总结时使用。
---
# 周报写法
1. 先读 records/ 目录下本周的工作记录
2. 按「本周完成 / 下周计划 / 风险」三块组织
3. 每条不超过两行,只写结果不写过程
...
注意:里面写的是中文说明,不是代码。 你会写文档,就会写 Skill。
这是 Skill 设计里最关键的一点,官方叫渐进式加载(progressive disclosure),分三个阶段:
| 阶段 | 发生了什么 | 占多少上下文 |
|---|---|---|
| ① 发现 | 启动时,agent 只加载每个 skill 的名称和描述 | 极少,每个大约几十个 token |
| ② 激活 | 当任务和某个描述对得上,才把 SKILL.md 正文读进上下文 | 几百到几千 token |
| ③ 执行 | 按说明做事,需要时才打开 scripts/、references/ 里的文件 | 用到才占 |
为什么要这么设计?回到上一篇的结论:上下文越长,模型越容易抓错重点。 如果把你所有的说明书一股脑塞进去,还没开始干活额度就用掉一大半了。
三级加载的效果是:你可以挂几十个 Skill,平时几乎不占地方,用到哪个才展开哪个。

这也解释了为什么
description那一行特别重要——它是 AI 判断「这件事要不要用这个 skill」的唯一依据。描述写得含糊,skill 就永远不会被触发。
这三个最容易混,一张表分清:
| 它给 AI 的是 | 存在哪 | 生效范围 | |
|---|---|---|---|
| 提示词 | 这一次要做什么 | 你当场打的字 | 只这一次 |
| Skill | 这件事该怎么做(流程、标准、模板) | 一个文件夹,存在你电脑或项目里 | 反复使用,需要时自动加载 |
| MCP | 能连什么(外部工具和数据的通道) | 一个配置 + 一个服务端程序 | 连上之后一直可用 |
用一个具体任务串起来:「每周一从数据库拉上周数据,做成周报」
一句话记法:MCP 管「能不能拿到」,Skill 管「拿到之后怎么做」。

Skill 这个格式最早由 Anthropic 提出,之后被开源成公开标准(agentskills.io),现在支持它的工具已经有几十个,包括:
这件事对你的实际意义是:
这也是 Skill 和「某个产品的自定义指令」最大的差别:它不绑在某一家产品上。
不是所有事都要封装。判断标准是三条同时成立:
| 条件 | 说明 |
|---|---|
| 重复 | 这件事你会做很多次,不是一次性的 |
| 有标准 | 做得好和做得差有明确差别,你能说清标准是什么 |
| 说不清就会错 | 不交代清楚,AI 每次都会做偏 |
适合封装的: 周报/日报格式、封面图规范、代码审查清单、会议记录整理、固定格式的文档生成、某个工具的操作流程。
不适合封装的: 一次性的任务、每次要求都不同的创意工作、你自己都还没想清楚标准的事。
一个务实的起步方法:先用普通对话把这件事做成功一次,然后把「这次是怎么做对的」整理成 SKILL.md。先有成功案例,再有 skill,比一上来就写规范靠谱得多。

Skill 就是你交给 AI 的岗位说明书:写一次,以后它自己照着做。 接着看:怎么装到你的工具里 → 3.5 Skill 安装全攻略;怎么自己封装一个 → 4.4 封装 Agent Skill。
不是。插件通常是带代码的功能扩展,要安装、可能要跑服务。Skill 的主体是一份 Markdown 说明书,可以附脚本但不是必须的——它扩展的是「AI 知道该怎么做这件事」,而不是「AI 多了一个能连的系统」。
不需要。最小的 Skill 就是一个文件夹加一个 SKILL.md,里面用中文把流程和标准写清楚就行。脚本、模板这些是可选项,等你确实需要固定某一步的执行方式时再加。
按工具而定,通常有「用户级」和「项目级」两个位置:用户级对你所有项目生效,项目级只对当前项目生效并且可以提交到 Git 供团队共用。具体路径看 3.5 那一篇,里面覆盖了四个平台。
十有八九是 description 写得太含糊。这一行是 AI 判断是否该激活的唯一依据,要写清楚「做什么」和「什么时候用」,比如「按公司模板写周报。当用户提到周报、周总结、本周汇报时使用」。