格式定义者的官方仓库：19 个 skill 加 spec 与 template
anthropics/skills
Anthropic 官方实现，17.7 万 star。./skills 下 19 个 skill，外加 ./spec（Agent Skills 规范，现已迁到 agentskills.io）与 ./template 新建骨架。它对 skill 的定义是「指令、脚本、资源三件套，按需动态加载」，渐进式披露这个概念就出自这里。
我们的判断想搞清 SKILL.md 到底该怎么写，读这里比读任何二手教程都准。两件事必须先知道：docx / pdf / pptx / xlsx 四个是 source-available 而不是开源（其余 15 个 Apache-2.0），而且仓库自带免责声明——这些 skill 仅供演示与教学，上关键任务前自己在环境里测过。
/plugin marketplace add anthropics/skills为什么它是基准，而不只是一个仓库
这是 Anthropic 官方的 skill 实现仓库：177,290 stars / 21,004 forks，./skills 下 19 个 skill，外加 ./spec（Agent Skills 规范，现已迁到 agentskills.io）和 ./template（新建 skill 的骨架）。你想理解「SKILL.md 到底该怎么写」，读这里比读任何二手教程都准——因为格式定义者就是它。
仓库对 skill 的定义值得原样记住：folders of instructions, scripts, and resources that Claude loads dynamically——指令、脚本、资源三件套，按需动态加载。渐进式披露（progressive disclosure）就是从这里来的：SKILL.md 只放路由信息，重内容放 references/、scripts/，用到才读。
许可证分两层，这是最容易踩的坑
| 范围 | 许可 | 说明 |
|---|---|---|
skills/docx、skills/pdf、skills/pptx、skills/xlsx | source-available，不是开源 | 正是驱动 Claude 生产环境文件创建能力的那四份代码，作为「复杂 skill 的真实范例」公开给开发者参考 |
| 其余 15 个（algorithmic-art、canvas-design、frontend-design、mcp-builder、webapp-testing、theme-factory、brand-guidelines、internal-comms、doc-coauthoring、claude-api、skill-creator、web-artifacts-builder、slack-gif-creator、academy-guide、discernment-nudge） | Apache-2.0 | 可以 fork 进自己的产品 |
仓库还挂了一段明确的免责声明：这些 skill 仅供演示与教学，Claude 实际返回的实现与行为可能与此处不同，用于关键任务前必须自己在环境里测过。把官方仓库当生产依赖之前，先读这句。
拿 pptx 当教材：一个生产级 skill 长什么样
skills/pptx 是四个文档 skill 里工程含量最高的一个，它把三种操作分了完全不同的技术路径：
- 创建用
pptxgenjs； - 编辑走 unzip → 改 XML → zip，不经渲染引擎，所以不会破坏母版与主题；
- 读取用
markitdown把内容抽成 Markdown。
配套脚本是 thumbnail.py、add_slide.py、clean.py、validate.py，外加一个 soffice.py 包装 LibreOffice。它甚至把 pptxgenjs 的坑写进了指令里，这几条是真金白银换来的：
- pptxgenjs 会就地修改传入的 option 对象 → 绝不在多个 add* 调用间共享同一个对象
- 组合图表用 secondaryValAxis 时，valAxes 与 catAxes 必须各给 2 个条目，
否则 PowerPoint 判定图表损坏并直接丢弃
- 永远不要重排 <p:presentation> 的子元素顺序这就是「skill 里该写什么」的答案：不是通用常识，而是模型自己会踩、且踩了不报错的坑。上面第二条失败模式尤其典型——图表在 PowerPoint 里静默消失，agent 完全不知道自己错了。
三个入口都能用
# Claude Code：先把仓库注册成插件市场
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
/plugin install example-skills@anthropic-agent-skills装完之后靠提及就能触发，例如「用 PDF skill 抽出 path/to/some-file.pdf 的表单字段」。另外两条路：Claude.ai 付费方案已内置这批 example skill（也可直接上传自定义 skill），以及通过 Skills API 在程序里挂载。
怎么用这个仓库最划算
把 template/ + skill-creator 当脚手架，把 pptx/xlsx 当「复杂 skill 的参考答案」通读一遍，然后再写自己的。我们本站 7 个生产 skill 的结构就是照这个套路来的：SKILL.md 里写铁律与流程状态机，重活交给 scripts/，规格类知识沉到正文——而不是把一切都塞进一个 prompt。