32 万星,README 只认 27 个技能
这个仓库最值得读的不是那 27 个技能,而是它把「哪些技能不发货」写成了一条硬规则。
mattpocock/skills 的作者是 Matt Pocock,plugin.json 的 author.name 写的就是这个名字。仓库描述是「Skills for Real Engineers. Straight from my .agents directory.」。
它是一组给编码 agent 用的 Markdown 技能文件,不是运行时,也不是框架。
2026-11-13 用 api.github.com 核对:323,055 星、27,100 fork、240 个未结条目,MIT,主语言 Shell,建于 2026-02-03,最近推送 2026-11-12。默认分支 main,主页指向 aihero.dev/skills。
身份字段先列成表,下面所有数字都来自同一份仓库接口,不引用仓库的 size 字段。
| 字段 | 核对值 |
|---|---|
| 仓库 / 描述 | mattpocock/skills · Skills for Real Engineers |
| 星标 / fork | 323,055 / 27,100 |
| 未结条目 | 240(拆开为 217 issue + 23 PR) |
| 创建 / 最近推送 | 2026-02-03 / 2026-11-12 |
| 许可 / 主语言 | MIT / Shell |
| 默认分支 / 主页 | main / aihero.dev/skills |
240 这个数含 PR。用 search/issues 拆开是 217 个未结 issue、23 个未结 PR,不能当成 240 个 bug 读。
README 的 Reference 只列 27 个技能:Engineering 20 个、Productivity 7 个;按调用方式分是 16 个只能手打、11 个模型可自动触发。插件清单也正好 27 条。
但完整 git tree 里有 39 份 SKILL.md。差的 12 份,仓库自己给了答案。
27 是发货单,39 是库存,规则写在 CLAUDE.md
27 和 39 的差值不是漏数,是 CLAUDE.md 里写死的一条打包规则。
CLAUDE.md 原文规定:engineering/ 与 productivity/ 里的每个技能,都必须同时出现在顶层 README 和 .claude-plugin/plugin.json 的 skills 数组里;括号里补了一句,插件「只发这一组」。
同一段还写明:misc/、in-progress/、deprecated/ 里的技能,两份清单都不许出现。换句话说,README 是发货单,不是库存清单,两个数字本来就不是一个口径。
五个桶按这个口径列成表。20 + 7 + 8 + 4 + 0 得 39,其中被发货的恰好是前两行。
| 桶目录 | SKILL.md | 进 README | 进插件 | 状态 |
|---|---|---|---|---|
| skills/engineering | 20 | 是 | 是 | 正式,日常代码工作 |
| skills/productivity | 7 | 是 | 是 | 正式,通用工作流 |
| skills/in-progress | 8 | 否 | 否 | Beta,刻意公开求反馈 |
| skills/misc | 4 | 否 | 否 | 冻结且不再维护 |
| skills/deprecated | 0 | 否 | 否 | 空桶,退役即删除 |
plugin.json 的 version 是 1.3.2,skills 数组 20 条 engineering 加 7 条 productivity,与 README 逐项对应。marketplace.json 只挂了 1 个插件,source 写的是 ./。
plugin.json 的 author.name 写的是 Matt Pocock,license 为 MIT,和仓库接口的许可字段一致。两份清单里都找不到 in-progress 的路径,规则确实落在文件上,而不只是写在文档里。
tag 共 10 个,最新 v1.3.2;CHANGELOG 从 1.0.0 到 1.3.2 列了 9 个版本段。规则、清单、版本号三处对得上,没有一处需要靠猜。
所以 把 39 写成「README 虚报」是误读:这里真正在维护的是一套筛选规则,技能只是它的产物。
规则写得越细,越容易露出两处没同步
桶清单本身有两处没跟上 CLAUDE.md,第三处看着像漏删,其实是规则允许。
第一处在 in-progress/。桶 README 说这些是 Beta、刻意公开求反馈、不进插件也不进顶层 README,正文列了 7 个技能。目录里却有 8 份 SKILL.md。
多出来的是 chief-of-staff。.changeset/ 里还有一份 chief-of-staff-shared-wiki-procedures.md,说明它正在改动中,只是桶 README 没跟上。CLAUDE.md 明确要求每个桶 README 列出桶内每一个技能。
第二处在 .out-of-scope/。SCOPE.md 的「Already decided」列了 8 份否决记录,目录里实际有 9 份,多的是 lazy-load-writing-for-agents.md。该文件开头要求提 issue 前把这些全部读完。
第三处看着像漏删,其实合规。docs/engineering 有 21 个页面,对应 20 个技能;多出的 resolving-merge-conflicts 首行标着 Archived,写明 v1.3.0 从插件移除、页面保留备查。
CLAUDE.md 对此写了例外:被整体移除的正式技能,文档页留下并标 archived。所以 21 不是错,是留档。把三处并列看,才分得清哪些是漂移、哪些是设计。
| 位置 | 应然 | 实然 | 判断 |
|---|---|---|---|
| in-progress/README.md | 列全桶内技能 | 列 7,目录 8 | 少 chief-of-staff |
| SCOPE.md 已决清单 | 列全 .out-of-scope | 列 8,目录 9 | 少 lazy-load 那份 |
| docs/engineering | 一技能一页 | 21 页 / 20 技能 | 多的是 archived 页 |
体量也说明这是文档工程。完整 git tree truncated=false,282 个节点、184 个 blob、126 个 .md 文件,合计 794,314 字节;39 份 SKILL.md 共 177,615 字节,最小 157、最大 12,594。
根目录 19 个条目,11 个文件、8 个目录。几个关键文件的字节数照 contents 接口列成表,比零散写更清楚。
| 文件 | 字节 | 作用 |
|---|---|---|
| CHANGELOG.md | 66,893 | 9 个版本段的变更记录 |
| README.md | 16,461 | 安装说明与 27 项 Reference |
| package-lock.json | 49,290 | 构建脚本依赖锁 |
| CLAUDE.md | 4,206 | 桶规则与文档同步要求 |
| SCOPE.md | 2,348 | issue 两道闸门与否决清单 |
| AGENTS.md | 9 | 指向 CLAUDE.md 的符号链接 |
CHANGELOG.md 是 README.md 的 4.06 倍长。AGENTS.md 只有 9 字节,内容就是文件名 CLAUDE.md。更新记录比说明书长四倍,这仓库的重心在哪一眼可见。
数据核对:字段均直接读取,三个计数口径不可混用。
- 身份:323,055 星 / 27,100 fork / 240 未结(217 issue + 23 PR),MIT,Shell,建于 02-03,推送 11-12。
- 计数:git tree truncated=false,282 节点 / 184 blob / 126 个 .md;39 份 SKILL.md = 20 + 7 + 8 + 4 + 0。
- 发货:plugin.json v1.3.2,skills 数组 27 条;tag 10 个,CHANGELOG 9 个版本段。
- 边界:贡献者接口合计 539 次提交,commits 分页末页为 555,两者差 16 次,本文按贡献者接口口径。
- 边界:未安装、未运行任何技能,只核仓库里写下来的文件与清单。
核对时间 2026-11-13。
先选插件还是可编辑文件,两条路不能同时走
装它之前要先决定走哪条分发路径,双装会让每个技能出现两次。
README 安装段第一句就是提醒:插件会自更新,skills.sh 拷的是可编辑副本、要手动更新;每个 agent 只挑一种。五条路径按原文列成表,命令不合并、不改写。
| 目标 | 安装命令 | 更新方式 |
|---|---|---|
| Claude Code | claude plugin install mattpocock-skills@claude-plugins-official | 默认自更新 |
| Codex | codex plugin marketplace add mattpocock/skills | 启动时自更新 |
| GitHub Copilot | copilot plugin marketplace add mattpocock/skills | 配置后每日更新 |
| Gemini CLI | gemini skills install ... --path skills/engineering | 手动重跑两条 |
| 其他 / 可编辑 | npx skills@latest add mattpocock/skills -a <agent> | 手动 update 与 add |
装完还要在每个仓库跑一次 /setup-matt-pocock-skills。这一步不是可选项,README 说它会问三件事。
- 用哪个 issue tracker:GitHub、GitLab、本地文件,或自己描述的其他系统
- triage 时给票据贴什么标签:
/triage依赖这些标签 - 过程中产生的文档存到哪里
CLAUDE.md 补了一条口径:Claude Code 走官方市场 claude-plugins-official,其余 agent 走仓库自带的 marketplace.json 拿自动更新;改过任一清单后要跑 claude plugin validate . --strict。
要 Beta 技能得单独装,插件不给:命令是 npx skills@latest add mattpocock/skills --skill=<name>。in-progress/README.md 明说这些技能可能随时改动或消失。
30 秒装完,不等于 30 秒能用:选哪条路径、要不要 Beta、每个仓库的配置问答,都排在安装之后。
让你随意改,却基本关上了改完往回交的门
README 鼓励你自己魔改,治理文件却把贡献通道收得很窄,这两句话得一起读。
README 写着「Hack around with them. Make them your own.」。SCOPE.md 却写明新技能提案与贡献一律关闭,misc/ 冻结且每个 issue 都关;配置选项、适配某个 harness、迁就个人流程,都该放进自己的 CLAUDE.md 或 fork。
CONTRIBUTING.md 说 PR 只对 collaborators 开放,仓库接口的 pull_request_creation_policy 也正是 collaborators_only。
issue 要同时过两道闸:有真实会话里的失败复现,且不撞 .out-of-scope/ 里已拒的概念。
门槛还带时限:14 天没回复就关,拒绝按 not planned 结案。AI 代写的 issue 另有一套要求,一个问题一条、复现写在分析之前、不许贴完整规格或重写后的 SKILL.md。
贡献者接口只有 4 个账号、合计 539 次提交,其中 mattpocock 本人 507 次,占 94.1%。其余三个账号的提交数列成表。
| 贡献者 | 提交 | 占 539 次 |
|---|---|---|
| mattpocock | 507 | 94.1% |
| claude | 15 | 2.8% |
| github-actions[bot] | 9 | 1.7% |
| TESTPERSONAL | 8 | 1.5% |
这更像一份个人工作台的公开发布,而不是社区共建的技能库。32 万星里有作者名气的分量,也有「不 vibe coding」这句口号的传播力,两者很难从星标里拆开。
对普通团队更实际的质疑是:某个技能不合你的项目时,规则明确指向 fork 或自己的 CLAUDE.md,而不是提 PR。那你接手的是一份要自己维护的分支,版本号、桶规则、文档页同步都得跟着走。
把它当一份带版本号的产品说明读,比当插件装进项目更省事。