数据来自官方和社区,未经本站实测。文中信息都来自项目官方页面,星数为 2026-11-03(首尔时间)核实时的数字;项目更新和发布日期按美国太平洋时间。
先看结论
- Agent Skills 是一种开放的文件格式,不是某个软件。一个「技能」就是一个文件夹,里面至少有一个
SKILL.md:开头写名字和用途,正文写操作步骤;还可以放脚本、参考文档和模板。 - 智能体启动时只读每个技能的名字和简介(约 100 个 token),真正用到时才读全文和附带文件,所以装很多技能也不太占上下文。
- 想直接用:用 Vercel 的开源命令行
npx skills add <仓库>一键装到项目里,官方写明支持 OpenCode、Claude Code、Codex、Cursor 以及另外 75 种智能体。 - 注意许可和安全:技能里可以带脚本,智能体会执行;装别人的技能前先看一遍内容。Anthropic 官方仓库里的文档类技能(docx / pdf / pptx / xlsx)是「源码可见」,不是开源。
格式长什么样
来源:Agent Skills 规范(规范仓库 agentskills/agentskills,代码 Apache-2.0,约 2.69 万星)。
skill-name/
├── SKILL.md # 必需:开头元数据 + 正文说明
├── scripts/ # 可选:可执行脚本
├── references/ # 可选:参考文档
└── assets/ # 可选:模板、图片、数据
SKILL.md 开头的元数据:
| 字段 | 是否必需 | 规则 |
|---|---|---|
| name | 必需 | 最多 64 个字符,只能用小写字母、数字和连字符,不能以连字符开头或结尾、不能连续两个连字符,要和文件夹名一致 |
| description | 必需 | 最多 1024 个字符,写清「做什么」和「什么时候用」,带上关键词方便智能体识别 |
| license | 可选 | 许可名称或附带的许可文件名 |
| compatibility | 可选 | 最多 500 个字符,写环境要求(比如需要 git、docker、联网) |
| metadata | 可选 | 自定义键值,比如作者、版本 |
| allowed-tools | 可选(实验性) | 预先允许的工具列表,各智能体支持程度不同 |
规范建议:SKILL.md 正文控制在 500 行以内,详细资料拆到 references/ 里;引用文件只用一层相对路径。规范还提供了校验工具 skills-ref validate ./my-skill。
去哪找现成技能
| 仓库 | 是什么 | 许可 | 核实时状态 |
|---|---|---|---|
| anthropics/skills | Anthropic 官方示例技能:创意设计、开发测试、企业沟通、文档处理等;在 Claude Code 里可以用 /plugin marketplace add anthropics/skills 添加 |
多数技能 Apache-2.0;docx / pdf / pptx / xlsx 四个文档技能是源码可见、不是开源 | 约 18.7 万星,最近更新 2026-10-28 |
| VoltAgent/awesome-agent-skills | 社区整理的技能清单,收录各开发团队发布的技能,标注 1497+ 个;列了 Claude Code、Codex、Gemini CLI、Cursor、GitHub Copilot 等的安装路径 | MIT(清单本身;收录的技能各有许可) | 约 3.68 万星,最近更新 2026-11-02 |
| skills.sh | skills 命令行配套的技能目录网站,可以浏览和搜索技能 | — | 可访问 |
Anthropic 在仓库里写明:这些技能仅供演示和学习,实际效果可能和 Claude 内置功能不同,重要任务前要自己充分测试。
一键安装:skills 命令行
来源:vercel-labs/skills(MIT,约 3.90 万星,2026-11-11 首尔时间读取;npm 包 skills 最新 1.8.1,2026-11-11 首尔时间发布,见 v1.8.1 发布页)。需要 Node.js 22.20 以上。按 v1.8.0 发布说明,从 1.8.0 起锁文件升级为第 2 版,可以校验技能内容的哈希;新增了可在代码里调用的编程接口;删除技能时只动锁文件记录在案的技能目录。
npx skills add vercel-labs/agent-skills # 选技能、选装到哪个智能体
npx skills add vercel-labs/agent-skills --skill web-design-guidelines -a claude-code
npx skills find # 搜索技能
npx skills list # 列出已装技能
npx skills use <source>@<skill> # 不安装,直接用某个技能(生成提示词,或加 --agent 启动智能体)
npx skills check # 检查有没有更新
npx skills update # 更新已装技能
npx skills remove # 删除已装技能
npx skills init my-skill # 新建技能模板
默认装到当前项目,加 -g 装到全局。命令行会自动识别你装了哪些智能体,让你选装到哪里。
安装前检查清单
- 看许可:技能仓库的许可和里面每个技能的
license字段可能不同;源码可见不等于可以随便改和分发。 - 看脚本:
scripts/里的代码会被智能体执行,先读一遍,特别是会联网、删文件、读密钥的脚本。 - 看 allowed-tools:这个字段会预先放行某些工具,不放心就删掉,让智能体每次都问你。
- 看维护:优先选最近还有更新、有明确作者的仓库。
小结
Agent Skills 把「给智能体写说明书」变成了一个通用格式:写一次,Claude Code、Codex、Cursor 等都能用。想上手,先用 npx skills 装一两个官方示例看看结构,再照规范给自己的常用流程写一个;装第三方技能前务必检查许可和脚本。
站内推荐