mattpocock/skills 整理自作者 .agents 目录，是一组面向编码代理的技能，用 Shell 编写，强调可组合、易改造，可通过 Claude Code 插件或 skills.sh 安装。
项目做什么
项目目的是把作者日常使用的工程实践固化为可由代理调用的技能，针对与代理需求错位、输出冗长、代码不工作、代码库变成泥球等常见失败模式，提供需求拷问、规格与工单生成、测试驱动开发、缺陷诊断、领域建模、架构改进、代码审查、合并冲突处理、交接、教学等流程。技能分为用户调用和模型调用两类，用户调用技能负责编排，模型调用技能承载可复用纪律，且用户调用技能可调用模型调用技能，但不会调用另一个用户调用技能。
与同类方案相比
优势在于技能被设计得小、易适配、可组合，并声称可配合任意模型使用；安装有两条路径，Claude Code 插件提供托管只读包并随作者更新，skills.sh 则把可编辑技能文件复制进项目，便于自行修改；用户可只挑选需要的技能，但 README 提醒安装方式二选一，否则会出现重复；使用前需在仓库运行 setup-matt-pocock-skills 来配置 issue tracker、triage 标签与文档位置。原生 Codex 插件被列为路线图，当前对 Codex 等代理通过 npx skills 安装。
设计与创新
README 将自身描述为把数十年工程经验压缩成可重复实践，并把 grilling 访谈、共享语言与 CONTEXT.md、ADR、红绿重构、深模块设计、双轴代码审查等做法封装成可调用技能；同时区分用户调用与模型调用，形成编排与可复用纪律的分层。这些设计是否构成相对 GSD、BMAD、Spec-Kit 的实质创新，以及跨模型的一致效果，仅凭给定材料无法独立验证；README 对竞品的评价属于作者观点，缺少可复现实验或第三方证据。
适用场景
适用于使用 Claude Code、Codex 或其他编码代理进行真实项目开发的场景，包括在动手前用 grill-me 或 grill-with-docs 对齐需求并建立领域语言，用 to-spec 和 to-tickets 把讨论转成规格与工单，用 implement 与 tdd 按纵向切片红绿重构实现，用 diagnosing-bugs 排查难复现缺陷或性能回退，用 improve-codebase-architecture 寻找深化机会，用 code-review 审查差异，用 resolving-merge-conflicts 处理合并或变基冲突，也用 handoff、teach、to-questionnaire 等处理非代码协作。
谁会受益
对希望把软件工程基本功固化为例行流程的开发者有实用价值：它覆盖从需求对齐、术语统一、规格拆分、测试驱动实现到审查与架构改进的链条，技能体积小且可组合，容易插入已有仓库，也能按需只安装部分技能。README 称 grilling 相关技能最受欢迎，并强调共享语言可减少冗长、统一命名、帮助代理导航代码。不过这些收益主要来自作者经验与 README 陈述，给定材料没有量化基准、用户调研数据或长期维护承诺，实际效果需在具体项目和代理上自行验证。
使用前需要注意
仅依据仓库简介和 README，无法验证技能的实际有效性、跨模型兼容程度、对大型或老旧代码库的适用性，以及更新是否会带来破坏性变化。README 明确 improve-codebase-architecture 只是调查而非救援，难以自动解开已有泥球；原生 Codex 插件仍在路线图；同时安装插件与 skills.sh 会造成技能重复；setup 需每仓库运行一次。仓库未提供许可证、测试覆盖、安全审计、维护周期或量化对比信息，因此与 GSD、BMAD、Spec-Kit 的优劣及所谓创新点尚无法独立确认。
本文基于抓取时的项目 README 和仓库简介整理；功能、限制与文档可能随项目更新而变化。