GitHub 趋势 · 第 52 期
10 个 Agent Skills 仓库横评:26,903 star 的那个,官方自己标了「已弃用」
#AgentSkills#技术选型#横向对比
先说结论。把今天榜单上这 10 个 Agent Skills 仓库的 star 加一遍,是 816,122。但它们能不能用在你项目上,和这个数关系不大。
第一个结论:star 排名第 8 的那个,官方自己在 README 第一行标了「已弃用」,而它本周还在周榜上吃 1,490 个新增 star。
第二个结论:这 10 个里 9 个是 MIT,唯一的例外是 openai/skills —— 它的仓库根目录里根本没有 LICENSE 文件。而官方指认来接替它的 openai/plugins,根目录同样没有。
第三个结论:同一个动作「装个 skill」,这 10 个仓库给了你至少四套互不兼容的通道。装错通道的典型症状是:命令跑完没报错,skill 就是不生效。
先说明为什么这一期是合集。今天是 2026-09-12,我把日榜(16 项)、周榜(23 项)、月榜(23 项)全部抓下来,逐个跟已写清单比对:三个榜单的未写候选加起来是 0。日榜零星那几项(iloader +36、DeskcommCRM +126、hyperresearch +118)已经连续四期数字一字未变,属于长期低动量存量;月榜的 claude-plugins-community 和 humanlayer/skills 此前已实抓核实、判薄结案。
Skills 这类东西的痛点很特殊:它本质上不是软件,是给 agent 看的一堆 Markdown。
这带来两个后果。一是没有编译器帮你发现问题 —— 装没装上、有没有生效,全靠你盯着 agent 的行为变化肉眼判断。二是它天然跨工具,而每个 agent 客户端都有自己的 skill 目录约定,于是「一个仓库能不能用」,实际变成了「它认不认你手上这个客户端」。
所以挑 skills 仓库真正该看的是三件事:许可写在哪、装到哪个目录、支持哪几个 harness。star 只能排在这三件事后面。
先看这张表
10 个仓库,按 star 降序。所有数字来自 GitHub REST API,抓取时间 2026-09-12 凌晨。「体量」是 API 返回的仓库 size 字段(单位 KB),它比 star 更能说明一个仓库里到底塞了多少东西。
| 仓库 | Star | 许可 | 语言 | 主安装通道 | 体量 |
|---|---|---|---|---|---|
| obra/superpowers | 285,280 | MIT | Shell | 14 个 harness 各一套 | 4,773 KB |
| mattpocock/skills | 259,638 | MIT | Shell | Claude 插件 / npx skills | 1,679 KB |
| tt-a1i/archify | 58,400 | MIT | JavaScript | npx skills -g | 139,162 KB |
| coreyhaines31/marketingskills | 49,530 | MIT | JavaScript | 6 种方式 | 3,249 KB |
| blader/humanizer | 46,872 | MIT | Python | npx skills --global | 205 KB |
| ayghri/i-have-adhd | 41,258 | MIT | Python | 交给 agent 自己装 | 403 KB |
| cathrynlavery/diagram-design | 38,343 | MIT | HTML | 8 个客户端各自装 | 12,115 KB |
| openai/skills | 26,903 | 无(null) | Python | $skill-installer | 2,528 KB |
| jakubkrehel/skills | 6,143 | MIT | Markdown | npx skills | 451 KB |
| humanlayer/skills | 3,755 | MIT | TypeScript | npx skills --skill | 66 KB |
表里有三处值得停下来看:许可列出现了一个空的;体量列的跨度是 2,100 倍(archify 的 139,162 KB 对 humanlayer 的 66 KB);以及 star 排第 8 的那一个,恰好是这 10 个里唯一没有许可的。
错位一:官方让你迁去的地方,star 只有被弃置处的四分之一
openai/skills 现在挂在周榜第 8 位,本周新增 1,490 star,总数 26,903。它的 README 第一行是这个:
This repository is deprecated. For current Codex skill and plugin examples, use the OpenAI Plugins repository (https://github.com/openai/plugins).
官方指认的替代品 openai/plugins,现在的 star 是 6,432 —— 只有它要接替的那个仓库的 23.9%。换句话说,周榜还在给一个已经判了死刑的仓库送新增 star,而官方让你去的地方,热度只有它的四分之一不到。
这不是孤例,是个结构性问题:star 记录的是「多少人曾经觉得这个方向值得收藏」,而不是「这个仓库现在还能不能用」。
榜单是过去时,README 第一行才是现在时。所以「看到榜单就装」这个习惯,应该改成「看到榜单 → 先读 README 前五行」。
错位二:26,903 star 的仓库,根目录没有许可文件
GitHub API 返回的 license 字段,openai/skills 和 openai/plugins 都是 null。我不放心,把两个仓库的根目录都拉了一遍,结果是:
openai/skills -> .gitignore README.md contributing.md skills openai/plugins -> .agents .gitignore README.md plugins
两个仓库各 4 个条目,都没有 LICENSE、LICENSE.md 或 LICENSE.txt。而 openai/skills 的 README 是这么交代许可的:
The license of an individual skill can be found directly inside the skill's directory inside the LICENSE.txt file.
也就是说,它把许可拆散到了每个 skill 子目录里去。这件事本身不算错 —— 一个 catalog 里的 skill 来自不同作者,逐个声明确实更严谨。但后果很实际:仓库级别的许可字段是空的,你 clone 下来默认并没有拿到任何授权。要用哪个 skill,就得进哪个目录去读它自己的 LICENSE.txt;找不到,就按无授权处理。
对照一下另外 8 个:全部 MIT,全部在根目录放了 LICENSE。coreyhaines31/marketingskills 的 README 甚至专门写了一行 MIT - Use these however you want —— 直译就是「随你怎么用」。
所以结论很直接:从这类仓库里挑一个放进商业项目之前,先花 30 秒确认根目录有没有 LICENSE。没有就去 skill 子目录找,还找不到,就当它不可商用。这一步比看 star 重要得多。
错位三:同一个「装个 skill」,四套互不兼容的通道
上面第一张表里的「主安装通道」列,看着都在说「装」,实际分成四类,而且彼此不通用:
| 通道类型 | 代表仓库 | 装到哪 |
|---|---|---|
| 插件市场(plugin marketplace) | superpowers / diagram-design / mattpocock | 各客户端自己的插件目录,自动更新 |
| 第三方 skills CLI | archify / humanizer / jakubkrehel / humanlayer / marketingskills | 交互式选择,默认写进 .agents/skills/ |
| 让 agent 自己读文档装 | i-have-adhd | agent 自己决定,不可复现 |
| 包管理器 / 手动解压 | humanizer(ZIP)/ archify(Raven ZIP) | 解压到指定目录,靠软链同步 |
这里有个坑特别值钱,coreyhaines31/marketingskills 的 README 主动把它写了出来:
If you run the command from inside an agent session (e.g., asking Claude Code to install the skills for you), the CLI runs non-interactively and may only install to the universal .agents/skills/ directory, which Claude Code does not read.
解药它也顺手给了一行:
npx skills add coreyhaines31/marketingskills -a claude-code
这个坑的形状很有代表性:你在 Claude Code 里让 Claude Code 帮你装 skill,它会把它装到一个 Claude Code 自己不读的目录里。命令成功、退出码 0、没有任何报错,skill 就是不生效。
这就是为什么「装了没反应」会成为 skills 生态里最高频的一类问题 —— 它通常不是配置写错了,而是两边的目录约定本来就不一致。遇到这种情况,先去 .agents/skills/ 和 .claude/skills/ 两个目录各看一眼,比反复重装有用。
上手:四条能直接跑的命令
下面四条全部逐字取自各自 README,按「最少折腾」排序。
# 1) 想要覆盖最广的框架(README 的 Getting Started 列了 14 个 harness) /plugin install superpowers@claude-plugins-official pi install git:github.com/obra/superpowers hermes plugins install obra/superpowers --enable
# 2) 想在 Claude Code 上装一套完整的工程化 skills claude plugins install mattpocock-skills
# 3) 通用 CLI 路线(可编辑,装到当前项目) npx skills add blader/humanizer --global npx skills add tt-a1i/archify -g
# 4) 不确定要哪个,让 agent 自己去读文档 Install the i-have-adhd skill/plugin from https://github.com/ayghri/i-have-adhd, refer to the repo's AGENTS.md for instructions.
第 4 条不是我偷懒,是 ayghri/i-have-adhd README 原文给的安装方式 —— 一个 41,258 star 的仓库,把安装步骤直接写成了一句自然语言,让使用者转告自己的 agent:去读这个仓库的 AGENTS.md,按里面的说明装。这本身就说明 skills 的安装有多依赖 agent 自己的判断力,也解释了为什么这个生态至今没有统一的安装规范。
选型建议:按你要解决的问题挑
- ▪想让 agent 按固定流程写代码 → obra/superpowers,harness 覆盖最广(14 个),从头脑风暴到 code review 是完整方法论;注意 README 有一节 Commercial Services,是商业支持入口,不影响 MIT 本身。
- ▪只想让 agent 少说废话 → ayghri/i-have-adhd,10 条规则写在 SKILL.md 里,每条都可验证(比如「步数编号」「不给收尾寒暄」)。
- ▪要出图(架构图 / 时序图 / 数据流) → tt-a1i/archify(Node 渲染 + JSON IR + 校验)或 cathrynlavery/diagram-design(39 种编辑风图表,README 覆盖 8 个客户端);有个细节:后者的仓库描述写的是 38 种,README 标题写的是 39 种。
- ▪做营销 / 增长 → coreyhaines31/marketingskills,README 挂着一张 skill 清单,我逐条数下来是 50 条,从 copywriting 到 revops 都有。
- ▪改文案去 AI 味 → blader/humanizer,README 原话是「Because it is just Markdown, it works with any agent that supports skills」,任何支持 skills 的客户端都能用,风控最低。
- ▪改 UI / 排版 / 配色 / 无障碍 → jakubkrehel/skills,共 11 个 skill,其中 7 个是 better-* 系列,其余 4 个是 review / explain / break / variant,从同心圆角到 OpenType 特性都有覆盖。
- ▪想要一套能直接抄的工程规范 → mattpocock/skills,它把 skill 按「用户调用 / 模型调用」两个轴分开,这个划分本身值得借鉴。
哪三个我建议先放着:
- ▪openai/skills —— README 第一行就是 deprecated,要装就装它指的那家。
- ▪humanlayer/skills —— 3,755 star 换来的是 5 个 skill、根目录 5 个条目、注册 watcher 只有 7 个,投入产出比不划算。
- ▪cathrynlavery/diagram-design 的企业路径 —— Claude Cowork 的 organization marketplace 目前要求私有或内部仓库,你得先把公开仓库镜像一份到自己的组织里,多一道运维。
我的判断
适合谁:已经在用 Claude Code / Codex / Cursor 其中任意一个、并且手上有一个稳定项目的开发者。这类人装 skills 的收益是最直接的 —— 它改变的是 agent 的行为习惯,不需要改你的代码。
不适合谁:还没确定主力 agent 客户端的人。上面四个安装通道是按客户端分的,你换一个客户端,至少一半的 skill 要重装,有些干脆没有对应通道。另外,如果你的项目是严格合规环境,openai/skills 那条「许可拆在每个子目录」的路线会让你多出一层逐个审计的工作量。
坑一:装了没反应。先查 .agents/skills/ 和 .claude/skills/ 两个目录,不要第一反应就重装。
坑二:star 不代表可用。26,903 star 的仓库可以第一行就写着弃用。判断可用性的顺序应该是:README 前五行 → LICENSE 是否存在 → 支持的客户端列表。
坑三:许可要落到文件上。API 的 license 字段为 null 时,不要停在「Other」这个结论上,去根目录和 skill 子目录各找一遍 LICENSE。找不到,就当它保留了所有权利。
数据来源:GitHub REST API(repos / contents / README 原文),抓取时间 2026-09-12 凌晨(北京时间)。
star 以 REST API 实测为准,Trending 页快照略有差异:superpowers 285,306(周榜快照)/ mattpocock/skills 259,661 / archify 58,394 / marketingskills 49,598 / humanizer 46,869 / i-have-adhd 41,245 / diagram-design 38,397 / openai/skills 26,906 / jakubkrehel/skills 6,224 / humanlayer/skills 3,755 / openai/plugins 6,435。
许可:obra/superpowers、mattpocock/skills、tt-a1i/archify、coreyhaines31/marketingskills、blader/humanizer、ayghri/i-have-adhd、cathrynlavery/diagram-design、jakubkrehel/skills、humanlayer/skills 均为 MIT;openai/skills 与 openai/plugins 的仓库级许可为空(根目录无 LICENSE 文件)。
地址:github.com/obra/superpowers · github.com/mattpocock/skills · github.com/tt-a1i/archify · github.com/coreyhaines31/marketingskills · github.com/blader/humanizer · github.com/ayghri/i-have-adhd · github.com/cathrynlavery/diagram-design · github.com/openai/skills · github.com/jakubkrehel/skills · github.com/humanlayer/skills · github.com/openai/plugins
原文引用:openai/skills README(deprecated 声明与许可说明)、coreyhaines31/marketingskills README(-a claude-code 提示)、ayghri/i-have-adhd README(安装提示语)、blader/humanizer README(兼容性说明)。
本文所有安装命令均逐字取自对应仓库 README 原文,未作改写。
今天这期做的是横向对比,所以没写「怎么用」。如果你已经装了其中某一个,欢迎在评论区说说实际体验 —— 尤其是「装了没反应」那类问题,你的排查顺序是什么。
下一期还是会先抓三榜。如果榜单上出现了明显更强的新面孔,就回到单项目精读;如果继续零候选,就做一期「skills 之外」的横向对比:这一轮榜单上反复出现的 MCP server 与 CLI agent 外围工具,同样是 star 很高但很少有人逐个核对许可和安装通道的一类。
#AgentSkills#技术选型#GitHub趋势