# mattpocock/skills for Claude Code: install and use

> mattpocock/skills is a Claude Code plugin indexing 29 skills built around engineering process rather than one task. It turns an idea into a spec and tickets, builds it test-first, reviews the result along two axes, diagnoses hard bugs, and hands off a conversation cleanly. A separate family of skills interviews and pressure-tests a plan before you commit to it.

Canonical: https://www.flowy.sh/plugins/matt-pocock-flow/guide
Published: 2026-10-29
Updated: 2026-10-29
Author: Flowy

## What does mattpocock/skills ship?

Flowy lists this plugin under the display title Engineering Discipline, and the name fits. `mattpocock/skills` is Matt Pocock's own repository of Claude Code skills, filed under the Development category, and Flowy indexes 29 components here, every one a skill. The 29 line up behind one idea: a change moves from a raw issue through a sharpened understanding of the problem, a test-first build, a diagnosed fix, and a clean handoff.

## How does mattpocock/skills take an idea to a finished, reviewed change?

Intake starts with `to-questionnaire`, turning a decision you cannot fully answer into a questionnaire for someone else, and `prototype`, a throwaway build testing whether a state model or UI actually feels right before it reaches the real codebase. `to-spec` turns a conversation already had into a written spec and publishes it to your issue tracker, no fresh interview needed. `to-tickets` breaks a spec, plan, or conversation into tracer-bullet tickets declaring what blocks them; `wayfinder` scales that up, mapping a big piece of work as decision tickets on the tracker, resolved one at a time.

`implement` builds from a spec or ticket set, and `tdd` is the test-first version for red-green-refactor or integration-test requests. `code-review` checks a finished change along two axes in parallel: repository coding standards, and whether it matches what the originating issue or spec asked for. `diagnosing-bugs` is a separate loop for something already broken, throwing, failing, or slow. `resolving-merge-conflicts` handles a git merge or rebase that will not resolve cleanly, and `handoff` compacts a conversation into a document for the next agent or session.

## What do the grill skills add to mattpocock/skills?

Three skills share a relentless-interview idea, and the output is what separates them. `grill-me` runs the interview and stops, a stress test with nothing written down. `grilling` fires on the same idea, triggering when the user wants their thinking pressure-tested or names it directly. `grill-with-docs` adds a second job: it writes an ADR and a glossary entry as it goes, so the reasoning survives past the conversation. None of the three replaces `to-questionnaire`, which is for a decision nobody present can actually answer. `wait-what` is smaller and sharper: when the last explanation did not land, it stops and re-pitches the point.

## Can mattpocock/skills help me understand a codebase, not just change it?

`codebase-design` is a shared vocabulary for designing deep modules: where a seam belongs, and what makes an interface testable or agent-navigable. `domain-modeling` builds and sharpens a project's domain model, for settling terminology, writing a CONTEXT.md file, or recording an ADR. `improve-codebase-architecture` scans a codebase for deepening opportunities, presents them as a visual HTML report, then grills through whichever you pick. `writing-for-agents` covers the documents that steer an agent's behavior: a skill, an `AGENTS.md` file, or a `CLAUDE.md` file. `research` investigates a question against high-trust primary sources and writes the findings to a Markdown file, built to run as a background agent. `teach` is the outlier: it teaches the user, not the codebase, a new skill or concept within the workspace.

## Which mattpocock/skills cover setup, safety, and narrower jobs?

`setup-matt-pocock-skills` configures a repo's issue tracker, triage label vocabulary, and domain doc layout, and its own description says to run it before any other engineering skill. `setup-pre-commit` sets up Husky pre-commit hooks with lint-staged for Prettier, plus type checking and tests. `git-guardrails-claude-code` installs Claude Code hooks that block dangerous git commands, such as a forced push, a hard reset, or a forced branch delete.

Three are narrower still. `migrate-to-shoehorn` moves test files off type-assertion casts and onto shoehorn, a small library for partial test data. `scaffold-exercises` creates a directory structure of sections, problems, solutions, and explainers for course material rather than a product feature. `wizard` generates an interactive bash script for steps only a human can perform, such as provisioning infrastructure or walking an unfamiliar dashboard.

## How does mattpocock/skills handle routing and triage?

`ask-matt` is the router: ask it which skill or flow fits your situation. `triage` covers external issues and pull requests, moving each through a state machine of roles: categorising, verifying, grilling if needed, and writing an agent-ready brief.

## Should you install mattpocock/skills?

This fits someone who wants a full, opinionated process enforced by name: a spec before code, tickets before a build, a review before a merge, a real handoff instead of a conversation that just ends. It fits less well if you want one piece alone, since installing all 29 skills for `tdd` or `code-review` by itself is more than most people need; [the install card on the listing page](https://www.flowy.sh/listings/matt-pocock-flow#install) shows the full set first.

Flowy indexes what `mattpocock/skills` ships; it does not own, bundle, or host the repository, and updates stay on the author's own release cadence. Run `setup-matt-pocock-skills` first if you plan to use more than one or two of the others, since several assume that tracker and vocabulary already exist.

Sources: [mattpocock/skills on GitHub](https://github.com/mattpocock/skills), [mattpocock/skills README](https://github.com/mattpocock/skills#readme)

## Common questions

### What is mattpocock/skills for Claude Code?

It is Matt Pocock's own repository of Claude Code skills, indexed by Flowy under the display title Engineering Discipline. All 29 components are skills, and together they cover a full engineering process: turning an idea into a spec and tickets, implementing and testing it, reviewing the result, diagnosing bugs, and handing off a conversation to the next agent or session.

### What is the difference between grilling, grill-me, and grill-with-docs?

All three run a relentless interview meant to stress-test a plan, decision, or design. `grilling` and `grill-me` cover much the same interrogation, with `grilling` described as firing on specific trigger phrases. `grill-with-docs` adds a second output on top of the interview: it writes an ADR and a glossary entry as it goes, so the reasoning survives past the conversation itself and not just the sharpened plan.

### Does mattpocock/skills include code review, and what does it check?

Yes, through the `code-review` skill. It reviews the changes since a fixed point, a commit, branch, tag, or merge base, along two axes at once, run in parallel: whether the code follows the repository's own documented coding standards, and whether it matches what the originating issue or spec actually asked for.

### Is there a way to plan work that is too large for one agent session?

Yes, that is what `wayfinder` is for. It lays out a large piece of work as a shared map of decision tickets on your issue tracker, rather than one plan, and resolves them one at a time until the path to the destination is clear. For a smaller spec, `to-tickets` breaks a plan or the current conversation into tracer-bullet tickets instead.

### How do I install mattpocock/skills, and does Flowy host the code?

Flowy indexes what `mattpocock/skills` ships so you can see the real skills before installing anything; it does not own, bundle, or host the repository. Install it from the listing's install card (flowy.sh/listings/matt-pocock-flow#install), and consider running the plugin's own `setup-matt-pocock-skills` skill first, since it configures the issue tracker and label vocabulary that several other skills assume already exist.

## Related

- [The listing page](https://www.flowy.sh/listings/matt-pocock-flow): Install command, components and repository
- [Alternatives to this plugin](https://www.flowy.sh/alternatives/matt-pocock-flow): Peers in its category, ranked by stars
- [The Claude Code plugin marketplace](https://www.flowy.sh/marketplace/plugins): How plugins install, and every plugin in the index
- [superpowers for Claude Code: what it does and how to install it](https://www.flowy.sh/plugins/superpowers-flow/guide): another plugin guide
- [facebook/react for Claude Code: install and use](https://www.flowy.sh/plugins/facebook-react/guide): another plugin guide
