1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | setup-pre-commit-mattpocock-skills | — |
| 作者/维护者 | Matt Pocock（个人开发者） | GitHub API |
| 来源链接 | https://github.com/mattpocock/skills/tree/main/skills/misc/setup-pre-commit | — |
| 许可证 | MIT | GitHub API |
| 所属合集仓库 Stars | 225,009（整个 mattpocock/skills 合集共 50+ 子技能共享，不代表本技能自身热度） |
GitHub API |
| 该技能安装次数 | 237,400+ 次（skills.sh 独立统计） | skills.sh |
| Forks | 19,330（合集仓库整体） | GitHub API |
| 最新版本 | v1.2.3 | GitHub API（tags） |
| 安装方式 | Claude Code 插件市场 / npx skills@latest add mattpocock/skills |
GitHub README |
2. 功能介绍与亮点
setup-pre-commit 是 mattpocock/skills 合集中的一个独立技能，用于在任意 JavaScript/TypeScript 仓库里一次性配置好完整的提交前质量门禁。它会：
- 自动探测包管理器（npm / pnpm / yarn / bun，依据锁文件判断）
- 安装并初始化 Husky 的 pre-commit hook
- 配置 lint-staged 对暂存文件运行 Prettier 格式化
- 若仓库已有
typecheck/test脚本，一并接入提交前检查；没有则明确告知用户跳过 - 若仓库尚无 Prettier 配置，写入一份合理的默认配置
- 执行后自带一份验证清单（hook 是否可执行、配置文件是否齐全、
npx lint-staged是否能跑通）
亮点：文档结构清晰，步骤按顺序编号且每步都给出可直接使用的命令/文件内容；仓库当天仍有提交，维护活跃；三项第三方自动化安全审计（Gen Agent Trust Hub、Socket、Snyk）全部为 Pass，在同仓库其他子技能中较为少见。
3. 适用场景
固定分类：工程效率与代码质量
适用于任何使用 npm/pnpm/yarn/bun 管理依赖的 JavaScript 或 TypeScript 项目，尤其是多人协作、希望在代码进入仓库前就统一格式、拦住类型错误和测试失败的团队与个人开发者。典型触发场景：新建仓库需要快速搭好质量门禁；老项目补齐 Husky + lint-staged 流水线；为已有 typecheck/test 脚本的项目接入提交前自动校验。
4. 跨 Agent 兼容性
| Agent | 结论 | 依据 |
|---|---|---|
| Claude Code | ✅ 原生支持 | 收录于 Claude Code 官方插件市场（claude plugins install mattpocock-skills），无需额外配置 |
| Codex | ✅ 原生支持 | 该技能目录下自带 agents/openai.yaml 适配文件；仓库同时提供 npx skills@latest add 通用安装器，README 明确列出 Codex 支持 |
| OpenClaw | ❓ 未验证 | 仓库文档未提及，官方安装渠道未逐一列出该 Agent |
| Hermes Agent | ❓ 未验证 | 同上 |
5. 推荐理由
它把“配置提交前质量门禁”这个几乎每个 JS/TS 项目都要做、却总要临时查文档拼凑的琐碎工作，压缩成一次可重复执行的标准流程：探测包管理器、装依赖、初始化 Husky、写好 lint-staged 与 Prettier 配置、按需接入类型检查与测试，并自带验证清单。对初中级用户而言，最大价值在于不用再逐个记忆 Husky v9 的新写法、lint-staged 的正确语法这些容易过时的细节。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | skills.sh 独立统计安装次数 237,400+，属大规模独立使用；数字为该子技能自身的安装数据，非合集仓库共享的 stars |
| 可用性 | 8 | 步骤清晰、每步给出可直接执行的命令与文件内容，示例完整；合集仓库当天仍有提交，维护活跃；专门适用于 npm 生态项目 |
| 安全性 | 9 | 检查清单：①仅执行标准 npm 生态命令（安装 devDependencies、npx husky init、写入本地配置文件），权限范围明确且可解释；②不联网外发数据；③不涉及 API key/凭据；④SKILL.md 全文未见可疑指令或隐蔽外发；⑤作者为具名个人开发者，无造假迹象；⑥MIT 许可证明确；⑦维护活跃、无弃置风险。三项第三方自动化审计（Gen Agent Trust Hub / Socket / Snyk）均为 Pass |
综合评分：8.67
7. 跟同类 Skills 相比的优势
| 技能 | 定位 | 与本技能的差异 |
|---|---|---|
triage（同合集） |
把 issue/PR 推进一套分诊状态机，产出可交给 agent 执行的任务简报 | 面向项目管理与 issue 流程，不涉及提交前代码质量检查；两者解决完全不同的工作流问题 |
GitGuardian install-hooks |
安装 pre-commit hook 用于密钥泄露扫描 | 只做密钥扫描这一件事；setup-pre-commit 覆盖格式化、类型检查、测试三类质量校验，两者可以叠加使用而非互相替代 |
手写 .husky/pre-commit 脚本（无 skill） |
开发者自行查阅 Husky/lint-staged 文档手动配置 | 需要自己记忆 Husky v9 的新写法（无需 shebang）、lint-staged 语法等容易过时的细节，出错率更高 |
8. 用户评价
该技能在 GitHub issue 区可查到具名用户的直接反馈：用户 nichcraft 曾提出 issue（#707）建议将其加入插件技能清单，属于真实使用后提出的改进诉求；用户 cs-stainly 曾提交两份 issue（#13、#14）指出 SKILL.md 文档中的潜在拼写错误，说明确有用户逐字阅读并实际使用过该技能的安装说明。目前尚未检索到 Reddit、Hacker News 等平台上针对该子技能本身的具名长评。
9. 其他补充
mattpocock/skills 合集提供两种安装路径：Claude Code 插件市场（订阅式，随作者更新自动同步）与 npx skills@latest add（复制式，可自行修改）。二者选一即可，同时安装会导致技能重复。
10. 安装使用方式
方式一：Claude Code 插件市场
claude plugins install mattpocock-skills安装后整套技能集以只读插件形式接入，无需单独指定 setup-pre-commit。
方式二：通用安装器（Codex 等其他 Agent 同样适用）
npx skills@latest add mattpocock/skills复制技能文件到本地项目后可自由修改。
安装后在支持的 Agent 中直接用自然语言触发，例如“给这个仓库配置 pre-commit hooks”或“设置 Husky”，技能会按 SKILL.md 中的步骤自动探测包管理器并完成配置；执行完成后建议按其自带的验证清单确认 .husky/pre-commit、.lintstagedrc、.prettierrc 均已正确生成。
11. 注意事项
- 仅适用于 npm/pnpm/yarn/bun 管理的 JavaScript/TypeScript 项目，不支持其他语言生态
- 若仓库原本没有
typecheck或test脚本，技能会跳过对应检查项并明确告知，不会强行生成假的校验步骤 - 首次执行会对暂存文件运行 Prettier 格式化，建议在干净的工作区中先试跑一次，确认格式化结果符合团队预期