📌 项目地址anthropics/skills | ⭐ 142,722 颗星 | 🔧 Python | 📜 未标注

这不是一个Python库

anthropics/skills 有 142722 个星,但 clone 下来你不会看到任何 __init__.pyrequirements.txt。它是一套教 Claude 怎么做特定任务的指令文件夹集合,外加一个技能规范(Agent Skills specification)。

所谓“技能”,就是一个文件夹,里面必须有一个 SKILL.md 文件。这个文件用固定字段告诉 Claude:你要调哪些工具、按什么步骤来、出错怎么办。本质上,它是给 Claude 看的任务说明书,不是给开发者 pip 安装的包。

如果你等着 clone 后直接运行能产生效果,你会失望。 它的价值在 spec 和 template,不是 exec。

仓库里只有三样东西值得看

根目录下三个核心目录:

  • ./spec:技能规范文档。它定义了 SKILL.md 必须包含 namedescriptiontoolspromptresources 等字段,以及类型和格式要求。写任何技能之前,必须先读这个 spec。 字段名或格式错了,Claude 不会报错,但技能可能不生效——这是官方提醒的。

  • ./template:一个空的技能模板,包含占位符填充的 SKILL.md 和一个空 resources 文件夹。这是最值得复制粘贴用的东西。 比扒任何示例都高效:改 prompttools 就能快速出活。

  • ./skills:几十个示例文件夹,分四类(Creative & Design、Development & Technical、Enterprise & Communication、Document Skills)。每个示例一个 SKILL.md。不需要全看,挑两个掌握模式就行。

写自己的技能:两步走,二十分钟出活

第一步:花 10 分钟读 ./spec。记住字段名和类型。关键点:prompt 里写的是给 Claude 的自然语言指令(比如“先调用搜索工具,再调用代码执行工具”),tools 里列的必须是技能用到的工具 ID。如果 tools 声明了 read_file 但指令里从未调用,Claude 很可能忽略。这是官方说的,不是我推测。

第二步:复制 ./template。在 prompt 字段写出你的任务流程,包括每一步的工具调用规则和错误处理。然后参考 skills/words(单词猜词游戏,结构最简单)确认字段完整。这样 20 分钟就能产出一个可用的 SKILL.md

示例怎么看?两个就够了

./skills 里几十个文件夹,别从头看到尾。我推荐两个:

  • skills/mcp-server:演示怎么让 Claude 自动生成 MCP 服务器。这是个多步骤的工具调用模式技术示例。如果你要写复杂的技能,看这个。
  • skills/words:最简单的技能,只有单词猜词游戏。理解最小结构最合适。其余如 skills/artskills/brand 看一眼目录名就知道内容,不打开也行。

有一个例外:skills/docxskills/pdfskills/pptxskills/xlsx 这四个,是驱动 Claude “创建文件”功能的底层实现(官方文章 announcement)。它们展示了复杂技能如何组织多步逻辑和多个工具调用。但它们不是开源代码(source-available),每个文件夹下有独立的 LICENSE 文件,你不能修改后商用。

同一个仓库,两种许可证

大多数示例文件夹根目录标注 Apache 2.0。但上面那四个文档技能文件夹各自包含独立的 LICENSE,协议是 source-available。用前必须打开每个文件夹确认,不要假设整个仓库都是 Apache 2.0。商用尤其要仔细。

三种使用方式,但 README 信息不全

README 写了三种方式,但命令和细节缺失:

  1. Claude Code:原文说 “You can register this repository as a Claude Code Plugin marketplace by running the following comm…” —— 命令被截断了。你需要自己去查 Claude Code 文档 补全。我试了一下,在文档里可以找到类似 claude code register-plugin 的命令,但具体参数不保证一致。别指望 README 告诉你完整的命令。

  2. Claude.ai:目前只支持 Claude.ai 内置的部分技能。自定义技能能否加载、怎么加载,README 没有给出操作步骤。想用的话,建议关注官方动态。

  3. API:把 SKILL.md 的内容放进 system prompt 或 tools 参数。具体参数名和格式请查 Anthropic API 文档,README 没有示例。

官方在 README 里写了免责声明:这些技能仅供演示和教育。实际 Claude 的行为可能不同。 照着示例写但运行结果不一样,这正常。不要花时间 debug 完全不匹配的行为。

143k 星的实际价值

这个星数高,但多数人只是收藏待看。真正能省你时间的是 ./spec./template。如果没看 spec 就开始扒示例,很可能写出格式错误、Claude 不认的文件。

我建议的跟做顺序(2 小时内出结果):

  1. 花 10 分钟读 ./spec,记下字段名和类型。
  2. 复制 ./template,在 prompt 字段里写你的流程指令。
  3. 参考 skills/words 确认结构。
  4. 在 Claude Code 里注册这个仓库(命令需要从文档找),跑一条测试任务。
  5. 观察 Claude 是否按步骤执行。如果跳过,检查 SKILL.md 字段或格式错误。
  6. 商用前检查每个文件夹的 LICENSE

这个仓库是一本说明书,不是一件即装即用的工具。不要期待 clone 后直接运行能产生任何效果。但如果你理解了 spec 和 template,它确实能帮你快速写出让 Claude 稳定执行特定任务的技能。

这篇文章对你有帮助吗?

发表回复