setup-matt-pocock-skills (mattpocock/skills) for Claude Code: What It Does and How to Install It

Walks you through a one-time setup of your repo so Matt Pocock's engineering skills know where your issues, labels and domain docs live.

Installs: 1.1M; on skills.sh
Stars: 309.2K; on GitHub
Files: 6; besides SKILL.md
Updated: Nov 2026; last repo commit

setup-matt-pocock-skills makes Claude look at your repo, ask up to three short questions, and write the config the other engineering skills read. You run it once, by typing it yourself, before you use skills like triage. It checks your git remote and any CLAUDE.md or AGENTS.md, proposes defaults, shows a draft, and writes files only after you confirm.

It adds an "Agent skills" block to your existing CLAUDE.md or AGENTS.md and writes files under docs/agents/. It may run git and gh or glab commands, and it creates triage labels in GitHub or GitLab if they are missing. It runs no bundled scripts and needs no API key.

Good for

Developers about to use triage and the other mattpocock engineering skills
Teams that track issues on GitHub or GitLab and want agents to follow the same label names
Solo developers who keep issues as markdown files in the repo

Install setup-matt-pocock-skills

Claude Code

Copy this prompt.

Install the setup-matt-pocock-skills skill in Claude Code. Run this command:

npx skills add https://github.com/mattpocock/skills --skill setup-matt-pocock-skills

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

From its listing on skills.sh. Source.

What's in the skill

When it loads

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Sections in SKILL.md

Process
1. Explore
2. Present findings and ask
3. Confirm and edit
4. Write
Agent skills
Issue tracker
Triage labels
Domain docs
5. Done

Key facts

Author: Matt Pocock (mattpocock/skills)
License: MIT
Installs on skills.sh: 1,094,220 (Nov 2, 2026)
GitHub stars: 309,237 (whole repo, Nov 2, 2026)
Last commit: Nov 1, 2026 (repo)
Files it bundles: SKILL.md, agents/openai.yaml, domain.md, issue-tracker-github.md, issue-tracker-gitlab.md, issue-tracker-local.md, triage-labels.md
Starts: Only when you call it

What it includes

Reads git remotes, CLAUDE.md, AGENTS.md, glossary and ADR folders first
Files · Explore the repo
Picks GitHub, GitLab, local markdown or other; saves it to issue-tracker.md
Write · Section A: issue tracker
Keeps or renames the five triage labels; skipped when triage is not installed
Write · Section B: triage labels
Defaults to one GLOSSARY.md plus docs/adr; offers a multi-context map only for monorepos
Write · Section C: domain docs
Shows drafts, then edits CLAUDE.md or AGENTS.md and writes docs/agents/*.md
Write · Confirm and write
Runs gh or glab to create any missing labels
Runs code · Create missing labels
Five templates: three issue trackers, triage labels, domain docs
Read · Bundled templates

From the official docs

Permissions

Low risk

What it can do

Read your data
Create and change things
Delete things
Read-only modeHow to turn it on

Watch out for

Edits an existing file in place
It updates your CLAUDE.md or AGENTS.md. Commit your work first so you can review the diff.
skills.sh audits
Gen Agent Trust Hub pass, Socket pass, Snyk pass. skills.sh

Technical details

Turning on read-only	The exploration step only reads. It shows drafts and writes files only after you confirm.
Talks to	GitHub or GitLab (through gh or glab)
Sign-in and keys	Uses whatever gh or glab is already signed in to. No separate key.
Scopes	Runs git remote -v and reads CLAUDE.md, AGENTS.md, GLOSSARY.md and docs/ Edits CLAUDE.md or AGENTS.md and writes docs/agents/*.md after you confirm May run git init and git remote add origin if you pick a tracker with no remote Runs gh label create or glab label create for missing triage labels

Questions

What does setup-matt-pocock-skills do?

It sets up your repo for the engineering skills in mattpocock/skills. It records where issues live, which labels triage uses, and where GLOSSARY.md and ADRs go. Output is a "## Agent skills" block in CLAUDE.md or AGENTS.md plus files in docs/agents/.

How do I install and run it?

Use the install box at the top of this page, then type the skill name in your agent once per repo. It does not start on its own. The README also asks you to install it with the rest of the set.

Do I have to run it for every repo?

Yes, once per repo. Re-run it only to switch issue trackers or start over. You can edit docs/agents/*.md by hand any time.

Does it need an API key?

No. For GitHub or GitLab trackers it relies on the gh or glab command line tool being able to reach your repo. If neither works, it stops and tells you what is missing.

Is it safe?

It asks before it writes, and shows drafts of every file first. It edits your CLAUDE.md or AGENTS.md in place, so commit your work first. skills.sh audits: Gen Agent Trust Hub pass, Socket pass, Snyk pass.

Which skills need it?

The engineering skills such as triage read the files it writes. triage tells you to run it when label mapping is missing.

Information

updated Nov 2, 2026

Repository: mattpocock/skills
Folder: skills/engineering/setup-matt-pocock-skills

mattpocock/skills skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 3

setup-matt-pocock-skills SKILL.md · github.com
setup-matt-pocock-skills on skills.sh · skills.sh
mattpocock/skills · github.com