---
title: "How to Install Matt Pocock's Skills"
canonical: https://skillselion.com/guides/setup-matt-pocock-skills-claude-code-guide
content_type: text/markdown
description: "To install Matt Pocock's skills in Claude Code, run `claude plugin install mattpocock-skills@claude-plugins-official`, then run `/setup-matt-pocock-skills`."
---

# How to Install Matt Pocock's Skills: setup-matt-pocock-skills Explained

Title: How to Install Matt Pocock's Skills

> To install Matt Pocock's skills in Claude Code, run `claude plugin install mattpocock-skills@claude-plugins-official`, then run `/setup-matt-pocock-skills`.

Canonical: https://skillselion.com/guides/setup-matt-pocock-skills-claude-code-guide

To install Matt Pocock's skills in Claude Code, run `claude plugin install mattpocock-skills@claude-plugins-official`, then run `/setup-matt-pocock-skills` once per repo. The setup skill (1,174,580 installs) records your issue tracker, 5 triage labels and domain doc layout in `docs/agents/` for the other engineering skills.

## Key facts

- Last updated: November 12, 2026
- Claude Code: `npx skills add https://github.com/mattpocock/skills --skill setup-matt-pocock-skills -a claude-code`
- Cursor: `npx skills add https://github.com/mattpocock/skills --skill setup-matt-pocock-skills -a cursor`
- Codex: `npx skills add https://github.com/mattpocock/skills --skill setup-matt-pocock-skills -a codex`

## How to install setup-matt-pocock-skills

`npx skills add https://github.com/mattpocock/skills --skill setup-matt-pocock-skills -a claude-code`

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

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

## Article

Matt Pocock's engineering skills assume each repo has told them where issues live and where docs go. The [setup-matt-pocock-skills skill](/skills/mattpocock/skills/setup-matt-pocock-skills) (1,174,580 installs, 329,813 GitHub stars) writes that configuration once, and the install itself takes two steps.

## Key takeaways

- setup-matt-pocock-skills has 1,174,580 installs and the mattpocock/skills repo has 329,813 stars (skills.sh registry, GitHub).
- The README gives one install command per agent. For Claude Code it is `claude plugin install mattpocock-skills@claude-plugins-official`.
- The setup skill covers 3 sections: issue tracker, triage labels and domain docs. It follows 5 steps: explore, present, confirm, write, done.
- It offers 4 tracker options: GitHub, GitLab, local markdown, or any other workflow you describe in a paragraph.
- You run it once per repo. The [Matt Pocock skills map](/guides/matt-pocock-skills-map) shows the flow it prepares.

## How do you install Matt Pocock's skills?

Run one install command for your agent, then run `/setup-matt-pocock-skills` in each repo. The README in the [mattpocock/skills repo on GitHub](https://github.com/mattpocock/skills) (329,813 stars) lists the commands:

- Claude Code: `claude plugin install mattpocock-skills@claude-plugins-official`
- Any other agent, or editable files: `npx skills@latest add mattpocock/skills`

![Matt Pocock avatar on GitHub](https://github.com/mattpocock.png?size=200)

The README says to pick one method per agent, because installing both gives you every skill twice. The plugin updates itself. The `npx skills` route copies editable files into your project, and you update them with `npx skills@latest update`. If you use that installer, include `setup-matt-pocock-skills` when it asks which skills to take. The general steps are in [how to install a Claude Code skill](/guides/how-to-install-a-claude-skill).

## What does setup-matt-pocock-skills do?

It scaffolds the per-repo configuration that the engineering skills read. The skill has 1,174,580 installs (skills.sh registry) and describes itself as prompt-driven: it explores the repo, presents what it found, confirms with you, then writes. During exploration it checks `git remote -v`, looks for `CLAUDE.md` or `AGENTS.md`, and looks for an existing `GLOSSARY.md`, `docs/adr/` folder and `.scratch/` directory. It also detects monorepo signals such as `pnpm-workspace.yaml`. It sets `disable-model-invocation: true`, so you start it yourself with the slash command.

## What questions does the setup skill ask?

It works through 3 sections in order, one answer per section, and leads each with a recommended answer. Section A is the issue tracker. A GitHub remote gets GitHub Issues through the `gh` CLI, a GitLab remote gets GitLab Issues through `glab`, and local markdown stores issues under `.scratch/<feature>/`. Section B runs only when the triage skill is installed. It asks whether to keep the 5 default labels: `needs-triage`, `needs-info`, `ready-for-agent`, `ready-for-human` and `wontfix`. Section C is domain docs. The default is single-context, with one `GLOSSARY.md` and `docs/adr/` at the repo root, and the skill writes it without asking unless it found a monorepo. The [triage skill](/skills/mattpocock/skills/triage) has 1,099,693 installs (skills.sh registry).

## Which files does setup-matt-pocock-skills write?

It writes up to 3 files in `docs/agents/` and one block in your agent instructions file. The files are `issue-tracker.md`, `domain.md` and, when triage is installed, `triage-labels.md`. The block is an `## Agent skills` section added to `CLAUDE.md` if it exists, or to `AGENTS.md` if that exists. If neither exists, the skill asks which one to create. It updates an existing block in place and leaves your surrounding text alone. On GitHub or GitLab it also creates any configured label the tracker lacks. The skill counts 1,174,580 installs (skills.sh registry).

## Which skills depend on the setup?

The skills that read or write issues depend on it most. The SKILL.md names three: [to-spec](/skills/mattpocock/skills/to-spec) (835,581 installs), [to-tickets](/skills/mattpocock/skills/to-tickets) (831,148 installs) and triage (1,099,693 installs). Each needs to know whether to call `gh issue create`, write a markdown file under `.scratch/`, or follow the workflow you described. The domain docs section tells skills where the glossary and ADRs live, which matters for planning sessions such as [grill-with-docs](/skills/mattpocock/skills/grill-with-docs) (1,357,770 installs). The [best docs and planning skills](/best/skills-for-docs-planning) page lists comparable workflows.

## A complete starter stack

- setup-matt-pocock-skills (1,174,580 installs): run once per repo.
- grill-with-docs (1,357,770 installs): align on the change before any code.
- to-spec (835,581 installs) and to-tickets (831,148 installs): turn the plan into tracked work.
- triage (1,099,693 installs): move issues through the 5 label roles.

## Common pitfalls

- Installing the plugin and the `npx skills` copy for the same agent. The README warns that this gives you every skill twice.
- Running setup again after every update. The skill says a re-run is needed only to switch issue trackers or start over, and you can edit `docs/agents/*.md` directly.
- Picking GitHub with no remote. The skill asks for the repo URL and wires the remote, and it stops if `gh repo view` cannot print the project.

Install once, run setup in each repo, then browse the [docs and planning category](/category/docs-planning) for skills that fit the rest of your workflow.

## Related

- [/best/skills-for-docs-planning](https://skillselion.com/best/skills-for-docs-planning)
- [/category/docs-planning](https://skillselion.com/category/docs-planning)
- [/guides/matt-pocock-skills-map](https://skillselion.com/guides/matt-pocock-skills-map)
- [/guides/how-to-install-a-claude-skill](https://skillselion.com/guides/how-to-install-a-claude-skill)
- [/guides/grill-with-docs-skill-claude-code-guide](https://skillselion.com/guides/grill-with-docs-skill-claude-code-guide)

## FAQ

### How do I install Matt Pocock's skills in Claude Code?

Run `claude plugin install mattpocock-skills@claude-plugins-official`, then `/setup-matt-pocock-skills` in your repo. The setup skill has 1,174,580 installs. See [how to install a Claude Code skill](/guides/how-to-install-a-claude-skill).

### What is setup-matt-pocock-skills?

It is the skill that configures a repo for Matt Pocock's engineering skills: issue tracker, triage labels and domain docs. It has 1,174,580 installs. See [setup-matt-pocock-skills](/skills/mattpocock/skills/setup-matt-pocock-skills).

### Do I have to run /setup-matt-pocock-skills in every repo?

Yes, once per repo. It writes up to 3 files in docs/agents/ that are specific to that repo. The skill has 1,174,580 installs. See the [Matt Pocock skills map](/guides/matt-pocock-skills-map).

### Does the setup skill work without GitHub?

Yes. It offers 4 tracker options: GitHub, GitLab, local markdown under .scratch/, or a workflow you describe, such as Jira or Linear. The skill has 1,174,580 installs. Browse the [docs and planning category](/category/docs-planning).

### What triage labels does the setup skill create?

It writes 5 default labels: needs-triage, needs-info, ready-for-agent, ready-for-human and wontfix, and only when the triage skill (1,099,693 installs) is installed. See the [triage skill](/skills/mattpocock/skills/triage).

## Machine access

- [Sitemap](https://skillselion.com/sitemap.xml)
- [llms.txt](https://skillselion.com/llms.txt)
- [llms-full.txt](https://skillselion.com/llms-full.txt)
- [Developer resources](https://skillselion.com/developers)
- [OpenAPI spec](https://skillselion.com/openapi.json)
- [MCP handshake](https://skillselion.com/.well-known/mcp)
- [API catalog](https://skillselion.com/.well-known/api-catalog)
- [AI catalog](https://skillselion.com/.well-known/ai-catalog.json)
- [Pricing](https://skillselion.com/pricing.md)
- [Auth](https://skillselion.com/auth.md)
- [AGENTS.md](https://skillselion.com/AGENTS.md)
- [Contact](https://skillselion.com/contact)
- [Home](https://skillselion.com/)
