mattpocock/skills Skill：把真实工程师工作流打包成可安装的原子化 Skill 合集

总结

mattpocock/skills 是 TypeScript 名人 Matt Pocock（Total TypeScript 创始人、前 Vercel 工程师）把自己的 .agents/ 工作目录公开上传的开源 Skill 合集。它瞄准编码 Agent 最高频的四个失败场景——理解偏差、Token 浪费、代码跑不通、架构腐化——并为每个场景配备了可直接调用的原子化 Skill（/grill-with-docs、/tdd、/diagnosing-bugs 等）。2026 年 9 月已斩获 271,368 ⭐，多次登顶 GitHub Trending，是 2026 年最受关注的 Agent Skills 仓库之一。

功能与原则

该仓库的核心哲学是”小、适配性强、可组合”（small, easy to adapt, composable），不追求大而全的框架，而是把真实工程判断力拆成最小单元：

• 对齐优先：用 /grill-with-docs 在动手前做需求访谈，消除 Agent 与开发者的认知偏差
• 反馈驱动：用 /tdd 强制 Agent 先写失败测试再写代码，建立红→绿→重构闭环
• Token 节省：用共享语言（CONTEXT.md + ADR）压缩上下文，让对话更精简
• 架构守护：用 /improve-codebase-architecture 定期扫描腐化风险，而非等崩盘后救火

所有 Skill 均遵循 Anthropic 官方 SKILL.md 格式，MIT 许可证，零遥测、零付费墙。

认可度

链接

GitHub 仓库：https://github.com/mattpocock/skills

原作者

Matt Pocock（GitHub @mattpocock）——TypeScript 教育家，Total TypeScript 课程创始人，前 Vercel 工程师（负责 TypeScript 基础设施），前 Stately 工程师（XState），YouTube 频道订阅者约 19 万，专注于把生产级工程实践转化为 AI Agent 可复用的工作流。

介绍

mattpocock/skills 起源于一个简单观察：大多数用 AI Coding Agent 的开发者，遇到的问题不是模型不够强，而是工作流不对。Agent 做出了你没想到要的东西，或者 Token 全烧在解释流程而非写代码，或者代码看着对跑起来就崩。

Matt Pocock 没有为此造一个新框架，而是把自己每天在真实项目中使用的 .claude/skills/ 目录整个开源。他把这套方法论称为”真实工程师的 Skills”（Skills for Real Engineers），核心观点是：瓶颈从来不是模型，而是流程。

该仓库包含约 35 个独立 Skill，覆盖工程（grill-with-docs、tdd、diagnosing-bugs、improve-codebase-architecture、to-spec 等）、生产力（grill-me、ask-matt）、杂项（git-guardrails-claude-code 等）多个分类。每个 Skill 都是一个标准 SKILL.md 文件，可独立安装、自由改编。

特点

• 原子化设计：每个 Skill 做一件事，可独立调用也可组合拼装
• MIT 全开源：无遥测、无付费墙，Skill 文件即普通 Markdown
• 双安装路径：Claude Code 插件方式（只读自动更新）或 npx skills@latest add（复制到本地可编辑）
• 跨 Agent 兼容：标准 SKILL.md 格式，支持 Claude Code、Codex CLI、Cursor 等所有兼容该格式的 Agent
• 渐进披露：v1.0 引入渐进式上下文加载，基准上下文减少约 63%（详见仓库 v1.0-guide）

使用方法

方式一：Claude Code 插件（推荐小白）

claude plugins install mattpocock-skills
# 或在会话内
/plugin install mattpocock-skills

方式二：npx 安装到本地（推荐想自定义的工程师）

npx skills@latest add mattpocock/skills
# 运行 once-per-repo 初始化
/setup-matt-pocock-skills

最小使用流程（来自官方推荐）：

1. 启动新功能：/grill-me → 需求讨论 → /to-prd → /to-issues
2. 第一个切片：/tdd（先写失败测试）
3. 遇到卡点：/ask-matt（Matt 本人写的路由 Skill）

使用场景与人群

• 适用场景：AI Coding Agent 的日常工程实践、TDD 工作流建立、代码库架构维护、需求对齐访谈
• 目标用户：使用 Claude Code / Codex / Cursor 等 Agent 工具的工程师，特别是感觉”Agent 老是做偏、跑不通、代码越改越烂”的开发者
• 不适合：纯需求文档写作、非编码类 Agent 任务

输入与输出案例

案例 1：/grill-with-docs 需求对齐

• 输入：开发者执行 /grill-with-docs，描述”课程平台里某节课状态变为’已发布’时，需要同时更新该节课所在季的统计数字”
• 输出：Agent 追问细节后，生成统一术语文档（CONTEXT.md），将上述复杂描述浓缩为”materialization cascade”等精准术语；同时生成 ADR 记录这个业务规则，供后续参考

案例 2：/tdd 红绿重构循环

• 输入：开发者执行 /tdd，描述”写一个 sum 函数接受数组返回累加和”
• 输出：Agent 先写一条失败测试（红），再实现 sum 函数通过测试（绿），最后提示可以重构的候选点——全程有结构、有约束，不会跳步直接写实现

📌 GitHub：https://github.com/mattpocock/skills
📌 Stars：271,368 ⭐（截至 2026-09-29）

GitHub: https://github.com/mattpocock/skills