用 Cursor 或 Claude Code 写代码，你可能反复解释同一件事：PR 怎么写、commit 格式、发版前要跑哪些检查……每次新开对话从头教，费嘴也费 Token。

Skill 把这类「怎么做」沉淀成 可版本控制、可跨工具复用、按需加载 的说明包——相关任务才翻开全文，而不是整本手册常驻上下文。

读完后，你会知道 Skill 是什么、标准从哪来、怎么写最小示例、去哪找开源模板，以及它和 Token 的关系。

---

一、Skill 是什么？

Skill 英·美 /skɪl/，与日常英语「技能」同音。

AI Skill（Agent Skill，智能体技能） 不是训练新模型，而是 目录 + 必填 SKILL.md：YAML 头写 name、description，正文写步骤；可选 scripts/、references/。

和另外两层上下文别混：

层	代表	加载方式	解决什么
Rules（规则）	.cursor/rules、AGENTS.md、CLAUDE.md	全局、常长期占上下文	项目约定：代码风格、测试命令、禁区
MCP（Model Context Protocol，模型上下文协议）	工具连接	会话中挂载	能干什么（接数据库、API）
Skill	SKILL.md 目录包	渐进式披露，相关才读全文	怎么做（写 PR、发版等分步流程）

分工一句：全局约定写 AGENTS.md（跨工具）或 .cursor/rules（Cursor）；某类任务的固定流程写成 Skill。CLAUDE.md 是 Claude Code 专用，默认不读 AGENTS.md，需在 CLAUDE.md 里 @AGENTS.md 导入。

---

二、谁提出的？官网在哪？

Agent Skills 由 Anthropic 提出，并 开源沉淀为开放标准。

Anthropic 英 /ænˈθrɒp.ɪk/ · 美 /ænˈθrɑː.pɪk/（读音像 安-斯罗-匹克，非中文译名；一个词，重音在第二音节，th 读如 think 而非 the）。词源希腊语 anthropos（人），意为「与人类相关的」——Claude 的开发公司。

• 规范：agentskills.io | 仓库 agentskills/agentskills（约 20k+ Star，含 skills-ref validate 校验）
• Cursor：cursor.com/docs/context/skills

---

三、有什么用？怎么写？开源从哪找？

1）日常用处

固化 Code Review / commit 模板 / 发布 checklist 等 playbook（分步操作手册，类似团队 SOP）。

工具	项目级	个人级
Cursor	.cursor/skills/	~/.cursor/skills/
Claude Code	.claude/skills/	~/.claude/skills/

2）最小写法

my-skill/SKILL.md：

---
name: my-skill
description: 按团队模板写 PR 描述；用户提到 pull request 时启用
---

# PR 描述规范
1. 标题格式 …
2. 必须包含测试说明 …

description 要写清「做什么 + 何时用」。敏感流程（发版、删库）建议设 disable-model-invocation: true，用 /my-skill 手动触发，避免误启用。

3）开源模板

• anthropics/skills — 官方示例，约 150k+ Star
• VoltAgent/awesome-agent-skills — 社区策展 1000+，约 25k+ Star

---

四、和 Token 消耗什么关系？

标准用 渐进式披露（Progressive Disclosure）：① 启动只加载各 Skill 的 name + description（约百 Token 级/个）；② 任务相关才读正文；③ scripts/、references/ 用时再拉。

比整份 Rules 正文常驻更省——但 Skill 过多、description 太宽误触发、正文写成百科，启动成本照样上去。

CodeBurn 的 optimize 会扫 未使用的 Skill、过大的 AGENTS.md / CLAUDE.md（见上一篇）。Skill 写对上下文，CodeBurn 看见浪费——治理与观测，是省钱逻辑的两面。

---

五、写在最后

三个词：标准、按需、可共享。

今天试三件事：① .cursor/skills/ 写一个 description 清晰的小 Skill；② /skill-name 手动触发对比自动启用；③ Star anthropics/skills 找模板。

Agent（智能体）缺的不总是智商，常是上下文里的上岗手册。 写短、写准、写可复用，比每次口头教一遍划算。

---

参考链接

• agentskills.io · 规范 · anthropics/skills · awesome-agent-skills · AGENTS.md 标准 · Cursor 文档 · CodeBurn