skill 入门
1. 什么是 skill
简单来说，skills 就是一种轻量、开放的格式，用来给 Agent 增加专门的知识和工作流，使其能够更可靠地完成任务。
skill 的核心结构很简单：
my-skill/├── SKILL.md # 必填：元数据 + 操作说明├── scripts/ # 可选：可执行脚本├── references/ # 可选：参考文档├── assets/ # 可选：模板、资源└── ...从上面的结构可以看出，SKILL.md 必须包含：
- 元数据：
name,description(YAML frontmatter) - 正文：Markdown 格式的步骤说明，教 Agent 如何完成某项任务
YAML frontmatter
YAML 指的是一种人类可读的配置格式，它采用 键: 值 来写数据；frontmatter则是前置元数据，它就是放在 Markdown 文件最开头，用 --- 包起来的一段结构化元数据。
YAML frontmatter 的作用是，在 Discovery 阶段，只有 frontmatter 里面的字段会被 Agent 读取，Agent 启动时只看这些简短的元数据，判断这个 skill 是否和当前任务有关。
只有任务匹配时，才会加载元数据下方的完整 Markdown 说明（Activation 阶段）。
1.1 Skill 解决什么问题
当下，Agent 面临的问题之一并不是自身的能力，而是缺少真实工作需要的上下文。Skill 的主要作用就是：将流程性的知识、团队 / 公司 / 个人 的上下文打包成可以版本控制、可移植的文件夹，然后按需加载。
Skill 的主要价值：
- 领域专长：如法律审查流程、数据分析、PPT 格式等；
- 可重复工作流：多步骤任务变成一致、可审计的流程；
- 跨产品复用：Skill 只需要写一次，就可以在支持该标准的多个 Agent 产品中复用。
1.2 Skill 的基本机制
Skill 的基本加载机制是渐进式披露：
| 阶段 | 加载内容 |
|---|---|
| Discovery（发现） | 启动时只读每个 skill 的 name 和 description |
| Activation（激活） | 任务匹配时，才读完整 SKILL.md |
| Execution（执行） | 按说明执行，必要时运行脚本或加载引用文件 |
这样 Agent 可以挂载很多 skills，而不会在上下文里一次性塞满所有内容。
该格式最初由 Anthropic 开发并作为开放标准发布，Cursor 等产品也采用同一套 SKILL.md 结构。
2. Skill 的标准
如前文所述，skill 是最初由 Anthropic 开发并开放的格式，虽然没有官方的统一标准，但 agentskills.io 无疑是事实上的通用标准。其他的一些 skill 标准大多也兼容 agentskills.io 的标准。
3. Skill 的本质
虽然 SKILL.md 正文的本质就是一段 prompt，但 skill 本身已经超出了单纯的 prompt engineering 范畴，它更像是：以 prompt 为核心，加上标准格式、按需加载和资源捆绑的能力封装。
| 维度 | 单纯 prompt engineering | Agent Skill |
|---|---|---|
| 结构 | 一段文本，常散落在各处 | 标准化文件夹 + SKILL.md + 可选资源 |
| 加载方式 | 通常一次性全塞进上下文 | 渐进式披露：先读 name/description，匹配后才加载全文 |
| 触发机制 | 靠用户手动粘贴或固定 system prompt | description 专门用于 Agent 自动判断是否激活 |
| 附带能力 | 通常只有文字 | 可捆绑 scripts/、references/、assets/ |
| 可移植性 | 绑定某个产品/某次对话 | 写一次，多个 skills-compatible 客户端复用 |
| 维护方式 | 难版本管理、难评估 | 可 git 管理、可写 eval 测触发率和输出质量 |
- Prompt engineering：教模型「这次对话该怎么想、怎么做」
- Agent Skill：把「某类任务该怎么想、怎么做」做成可安装、可发现、按需加载的能力模块
Skill 里当然包含 prompt 设计（尤其是 description 的触发优化和正文指令），但还多了：
- 元数据层（frontmatter）——给机器读的「目录索引」
- 运行时协议（Discovery → Activation → Execution）——给客户端实现的加载逻辑
- 资源层（脚本、模板、参考文档）——不只是文字，还能真正执行
Skill 的来源
这里列举一些 skills 的相关资源：
| 网站 | 网址 |
|---|---|
| Skill 聚合入口 | https://skills.sh/ |
| Skills 市场（中文界面） | https://skillsmp.com/zh |
| 腾讯家的 Skills 市场 | https://skillhub.tencent.com/ |
| Agent Skills 官方标准站点 | https://agentskills.io |
| Anthropic 官方工程文章（Agent Skills 实战理念） | https://www.anthropic.com/engineering/equipping-agents-for-the-real-world-with-agent-skills |
| VS Code Copilot Agent Skills 文档 | https://code.visualstudio.com/docs/copilot/customization/agent-skills |
| Anthropic 官方 Skills GitHub 仓库 | https://github.com/anthropics/skills |
| Claude 技能精选列表（Awesome 系列） | https://github.com/ComposioHQ/awesome-claude-skills |
| 软件开发自动化工作流 Skills 集合 | https://github.com/obra/superpowers |
| 自动生成 Skill 的 Skill（官方示例） | https://github.com/anthropics/skills/tree/main/skills/skill-creator |
文章分享
如果这篇文章对你有帮助，欢迎分享给更多人！
评论区
音乐
暂未播放