Skip to content

The mattpocock/skills plugin for Claude Code: idea to handoff

By Flowy · Updated 2026-08-28

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.

What mattpocock/skills ships

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.

From 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 the grill skills add

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.

Understanding a codebase, not just changing 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.

Setup, safety, and the narrower tools

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.

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 it

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 listing page linked at the top of this guide 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.

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 page linked at the top of this guide, 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.