📌 项目地址:anthropics/skills | ⭐ 142,722 颗星 | 🔧 Python | 📜 未标注
这个仓库装了什么?不是工具,是Claude的任务说明书
anthropics/skills 是Anthropic官方发布的一组技能示例。仓库里每个文件夹包含一个 SKILL.md 文件和配套资源。Claude在运行时加载这些文件,然后按照你写的步骤执行任务──比如按品牌规范生成文档、按特定工作流分析数据、自动处理个人事务。
仓库本身不提供运行环境,也不提供 pip install 的包。它的价值在于:给出了“怎么写一份Claude能看懂的任务说明书”的规范、模板、和示例。
三个顶层目录:
./spec– Agent Skills规范定义./template– 空白技能模板./skills– 几十个示例技能,按四类归档(创意设计、开发技术、企业通信、文档处理)
我先给你一个明确的阅读排序。
spec:10分钟看懂,否则你写的技能Claude不认识
./skills/spec 定义了 SKILL.md 必须包含的字段:name、description、tools、prompt、resources。字段格式写错了,Claude不会报错,只会忽略整个技能文件。花10分钟读完这个目录,你就能写出Claude能正确解析的技能文件。写技能时遇到字段不确定,回来对照查。
template:写技能最快的方式
./template 目录内容:一个填充了占位符的 SKILL.md,一个空的 resources 文件夹。复制→填空→可用。这是整个仓库里唯一需要从头到尾看完并参考的文件。
skills:挑两个看结构就好,不用遍历
./skills 下有几十个技能,类别为:Creative & Design、Development & Technical、Enterprise & Communication、Document Skills。每个技能结构高度重复:一个 SKILL.md 描述步骤和工具调用,有时带资源文件。
我建议你只挑两个看:
- 最简单的,比如
skills/words(单词游戏),理解最小技能结构。 - 偏向技术的,比如
skills/mcp-server(生成MCP服务器),理解工具调用模式。
剩下的大量示例看目录名就能知道是什么,不需要打开每个文件。
有个例外:skills/docx、skills/pdf、skills/pptx、skills/xlsx 这四个技能是驱动Claude文档创建功能(create files)的底层实现。许可证是source-available(非开源),你只能读,不能改后商用。它们展示了复杂技能的工作方式──但代码不能直接复制到你自己产品里。
许可证:一个仓库两种协议,必须逐个文件夹确认
大多数技能标了 Apache 2.0 开源。但 skills/docx、skills/pdf、skills/pptx、skills/xlsx 这四个文件夹各自带有单独的 LICENSE 文件,是source-available许可证。你用之前必须翻开每个目录查看许可证。不要假设整个仓库都是Apache 2.0。
官方使用方式(信息有缺失,需要你额外查文档)
README里写了三种使用场景:
- Claude Code:README说“You can register this repository as a Claude Code Plugin marketplace by running the following comm…”──命令被截断了,没有给出完整命令。你需要自行查阅Claude Code官方文档补全这条命令。
- Claude.ai:目前只支持内置的部分技能,自定义技能能否加载要看官方动态(原文没给出具体操作方式)。
- API:把
SKILL.md塞进system prompt或tools参数,具体参数名和格式需要查Anthropic API文档,README没有给出示例。
官方也直接说了:技能展示的可能性与实际Claude的行为可能不一致。照着示例写,跑起来结果不同是正常的。这些技能用来展示模式,不是100%可复现的保证。
14万星背后:收藏多,但真正用起来的人少
142722颗星(写这篇文章时)代表了这个项目在GitHub上的热度和关注度。但历史经验表明,大多数Star是“收藏等以后看”。仓库真正能让你省时间的部分只有 spec 和 template。如果你还没看过这两个目录就开始翻skills示例,很可能写出格式错误、Claude不认的技能文件。
我的上手步骤(你也能这样试)
- 读10分钟
./spec,记住字段定义。 - 复制
./template,在SKILL.md的prompt字段里写明每步工具调用规则和错误处理。 - 参考一个简单示例(如
skills/words)确认结构没问题。 - 在Claude Code里加载技能文件夹(命令自己去补),跑一条测试任务,观察Claude是否按步骤执行。
- 商用前检查每个文件夹的
LICENSE。
用这套方法,你2小时内就能写出一份自己能用的技能文件。