把专项流程写成可移植的 SKILL.md
Agent Skills 是开放规范:一个文件夹 + SKILL.md(name / description),agent 按需加载。规范在 agentskills.io。本专区讲格式,不讲 Claude Code 怎么装。
更新于 2026-09-04。数据来自官方仓库当日快照。
如何写一个最小 Skill
3 步按开放规范搭一个 SKILL.md 文件夹
建目录
目录名即 skill name:小写、数字、连字符,1–64 字符,与 frontmatter name 一致。
mkdir pdf-processing写 SKILL.md
必填 name + description。正文放步骤;细节放到 references/,保持主文件短。
---
name: pdf-processing
description: Extract text and tables from PDFs. Use when handling PDF files.
---对照规范
结构、字段、渐进披露以 agentskills.io/specification 为准。
https://agentskills.io/specification避坑指南
别写成 Claude Code 说明书
本专区是 SKILL.md 约定。Claude Code 怎么装、怎么触发技能,走 /claude-code 专区和官方 Claude 文档。
description 写不好就不会触发
规范把 description 当发现入口。写清何时用、给谁用、解决什么;不要只写「通用助手」。
示例仓库许可混杂
不要把 anthropics/skills 整库当成 Apache-2.0 抄进商业产品。文档类技能明确不是开源。
和 MCP、Claude Code 怎么区分
基于官方规范与仓库 README。Skills 是格式,MCP 是工具协议,Claude Code 是消费 Skills 的产品之一。
| 工具 | 它是什么 | 许可(已核实) | 解决什么 | 不解决什么 |
|---|---|---|---|---|
| Agent Skills | SKILL.md 文件夹约定 | 规范 Apache-2.0 | 把专项流程写成可触发说明书 | 不是一个可安装的 agent 产品 |
| MCP | 工具连接协议 | 见 MCP 专区 | 任何客户端接任何工具 | 不规定你怎么写业务流程 |
| Claude Code | 终端 coding agent 产品 | 专有闭源 | 在仓库里改代码、跑命令 | 不是 Skills 规范本身 |
官方资源导航
官方入口
- 规范站点 (agentskills.io)
Agent Skills 开放规范与概览。
- 规范仓库
规范源码 Apache-2.0。
文档与样例
- Specification 正文
目录结构、SKILL.md frontmatter、渐进披露。
- Anthropic 示例仓库
Claude 侧参考实现。仓库内许可并不统一,docx/pdf 等为 source-available。
相关
- Claude 平台文档(实现)
Skills 在 Claude API / Claude Code / Claude.ai 里怎么用。不是规范本身。
- Anthropic 工程博文
官方对 Agent Skills 形态的说明。
最新动态
2026-09-04 · agentskills.io · anthropics/skills
Agent Skills:可移植的 SKILL.md 文件夹约定规范在 agentskills.io。Anthropic 示例仓库 star 快照逾 17 万;规范仓库 Apache-2.0。本专区讲格式,不讲 Claude Code 怎么用。
老金精选推荐
常见问题
- Agent Skills 是什么?
- Agent Skills 是给 agent 用的可移植文件夹:一份 SKILL.md(必填 name + description)加上可选的 scripts/references/assets。规范站点是 agentskills.io,和 Claude Code 产品不是一回事。
- 和 Claude Code、MCP 怎么区分?
- Claude Code 是一个终端 agent 产品,它能加载 Skills。MCP 是「怎么接工具」的协议。Agent Skills 是「怎么把专项流程写成可触发的说明书」。三者常叠用。
- SKILL.md 最少要写什么?
- 规范要求 frontmatter 里有 name 和 description。name 1–64 位小写字母数字和连字符,且要和所在目录名一致。description 决定会不会被触发。
- Anthropic 示例仓库能当开源协议用吗?
- 不能一刀切。README 写明许多技能是 Apache-2.0,但 docx/pdf/pptx/xlsx 等文档技能是 source-available、不是开源。用之前看该文件夹自己的许可。
引用本专区内容 (Cite this Hub)
我们鼓励你将本页内容沉淀至你的知识库、研究报告或直接让 AI Agent 读取。本站保持 CC BY 4.0 开放版权。
本专区如何更新
版本与链接集中在 src/content/agent-skills.ts 维护,star 快照由 GitHub API 自动巡检。教程、导航、精选按 slug 挂载。