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/superpowers285,280MITShell14 个 harness 各一套4,773 KB
mattpocock/skills259,638MITShellClaude 插件 / npx skills1,679 KB
tt-a1i/archify58,400MITJavaScriptnpx skills -g139,162 KB
coreyhaines31/marketingskills49,530MITJavaScript6 种方式3,249 KB
blader/humanizer46,872MITPythonnpx skills --global205 KB
ayghri/i-have-adhd41,258MITPython交给 agent 自己装403 KB
cathrynlavery/diagram-design38,343MITHTML8 个客户端各自装12,115 KB
openai/skills26,903无(null)Python$skill-installer2,528 KB
jakubkrehel/skills6,143MITMarkdownnpx skills451 KB
humanlayer/skills3,755MITTypeScriptnpx skills --skill66 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/skillsopenai/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 CLIarchify / humanizer / jakubkrehel / humanlayer / marketingskills交互式选择,默认写进 .agents/skills/
让 agent 自己读文档装i-have-adhdagent 自己决定,不可复现
包管理器 / 手动解压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 自己的判断力,也解释了为什么这个生态至今没有统一的安装规范。

选型建议:按你要解决的问题挑

哪三个我建议先放着:

我的判断

适合谁:已经在用 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趋势