Setup Matt Pocock Skills

This is the setup step you run once per repo before using Matt Pocock's engineering skills like `triage`, `to-issues`, or `improve-codebase-architecture`. It walks you through three decisions (GitHub vs GitLab vs local markdown for issues, your triage label names, and whether you have one CONTEXT.md or multiple in a monorepo) then writes the config to `docs/agents/` and adds an Agent skills block to CLAUDE.md or AGENTS.md. It's interactive and shows you drafts before writing anything. The nice part is it doesn't assume defaults, it actually reads your .git config and existing files first, so you're not fighting with wrong assumptions later when the other skills try to create issues or read ADRs.

skills.sh installs: 6.2K
GitHub stars: 5.7K
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add vinvcn/mattpocock-skills-zh-cn --skill setup-matt-pocock-skills --agent claude-code

Installs into .claude/skills of the current project.

Files

配置 Matt Pocock 的 Skills

搭建 engineering skills 所假定的每仓库配置：

Issue tracker - issues 存放在哪里（默认 GitHub；也原生支持 local markdown）
Triage labels - 五个 canonical triage roles 使用的字符串
Domain docs - GLOSSARY.md 与 ADRs 的位置，以及读取它们的 consumer rules

这是 prompt-driven skill，不是确定性脚本。先探索，展示发现，与用户确认，然后写入。

流程

1. 探索

查看当前 repo，理解起始状态。读取已有内容，不要假设：

git remote -v 和 .git/config - 这是 GitHub repo 吗？是哪一个？
repo root 的 AGENTS.md 和 CLAUDE.md - 是否存在？其中是否已有 ## Agent skills section？
repo root 的 GLOSSARY.md 和 GLOSSARY-MAP.md，以及 legacy 的 CONTEXT.md / CONTEXT-MAP.md。如果存在 legacy 文件，提议用 git mv 把它改名为对应的 GLOSSARY 名称，并改写 docs/agents/domain.md 中的这些名称。
docs/adr/ 以及任何 src/*/docs/adr/ directories
docs/agents/ - 这个 skill 之前是否已经输出过内容？
.scratch/ - 表明已经在使用 local-markdown issue tracker 约定
是否已安装 triage skill（本 skill 旁边有 triage folder，或 available skills 中存在 triage）？这决定 Section B 是否运行。
Monorepo signals：pnpm-workspace.yaml、package.json 的 workspaces field，或已有内容且各自带 src/ 的 packages/*。只有真正的大型 multi-package repo 才算；没有这些 signal 就是 single-context，几乎所有 repo 都如此。