# Matt Pocock's skills

> The 35 agent skills by Matt Pocock: what each one does and when to use it. MIT license.

- Source: https://doutorai.pt/en/sources/mattpocock
- Author: Matt Pocock
- License: MIT
- Site: Doutor AI (https://doutorai.pt/en) - AI tools for small businesses

Matt Pocock is one of the most followed voices in the TypeScript world, and he has published a set of skills for coding agents: grilling a plan until it holds up, reviewing changes along several axes, diagnosing hard bugs, and writing documents an agent can follow.

We brought the set to Doutor AI with one page per skill, each explaining what it does and when to use it. Each page shows the original skill file, in English, as the agent reads it.

## The 35 skills

- [ask-matt](https://doutorai.pt/en/components/skills__mattpocock-skills__ask-matt): Ask which skill or flow fits your situation. A router over the skills in this repo.
- [claude-handoff](https://doutorai.pt/en/components/skills__mattpocock-skills__claude-handoff): Hand the current conversation off to a fresh background agent that picks up the work immediately.
- [code-review](https://doutorai.pt/en/components/skills__mattpocock-skills__code-review): Review the changes since a fixed point (commit, branch, tag, or merge-base) along two axes - Standards (does the code follow this repo's documented co
- [codebase-design](https://doutorai.pt/en/components/skills__mattpocock-skills__codebase-design): Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide 
- [diagnosing-bugs](https://doutorai.pt/en/components/skills__mattpocock-skills__diagnosing-bugs): Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing
- [domain-modeling](https://doutorai.pt/en/components/skills__mattpocock-skills__domain-modeling): Build and sharpen a project's domain model. Use when the user wants to pin down domain terminology or a ubiquitous language, record an architectural d
- [git-guardrails-claude-code](https://doutorai.pt/en/components/skills__mattpocock-skills__git-guardrails-claude-code): Set up Claude Code hooks to block dangerous git commands (push, reset --hard, clean, branch -D, etc.) before they execute. Use when user wants to prev
- [grill-me](https://doutorai.pt/en/components/skills__mattpocock-skills__grill-me): A relentless interview to sharpen a plan or design.
- [grill-with-docs](https://doutorai.pt/en/components/skills__mattpocock-skills__grill-with-docs): A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
- [grilling](https://doutorai.pt/en/components/skills__mattpocock-skills__grilling): Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrase
- [handoff](https://doutorai.pt/en/components/skills__mattpocock-skills__handoff): Compact the current conversation into a handoff document for another agent to pick up.
- [implement](https://doutorai.pt/en/components/skills__mattpocock-skills__implement): Implement a piece of work based on a spec or set of tickets.
- [improve-codebase-architecture](https://doutorai.pt/en/components/skills__mattpocock-skills__improve-codebase-architecture): Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.
- [loop-me](https://doutorai.pt/en/components/skills__mattpocock-skills__loop-me): Grill me about specs for the workflows I want to build, within this workspace.
- [migrate-to-shoehorn](https://doutorai.pt/en/components/skills__mattpocock-skills__migrate-to-shoehorn): Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs 
- [prototype](https://doutorai.pt/en/components/skills__mattpocock-skills__prototype): Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explor
- [research](https://doutorai.pt/en/components/skills__mattpocock-skills__research): Investigate a question against high-trust primary sources and capture the findings as a Markdown file in the repo. Use when the user wants a topic res
- [resolving-merge-conflicts](https://doutorai.pt/en/components/skills__mattpocock-skills__resolving-merge-conflicts): Use when you need to resolve an in-progress git merge/rebase conflict.
- [scaffold-exercises](https://doutorai.pt/en/components/skills__mattpocock-skills__scaffold-exercises): Create exercise directory structures with sections, problems, solutions, and explainers that pass linting. Use when user wants to scaffold exercises, 
- [setup-matt-pocock-skills](https://doutorai.pt/en/components/skills__mattpocock-skills__setup-matt-pocock-skills): Configure this repo for the engineering skills - set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use o
- [setup-pre-commit](https://doutorai.pt/en/components/skills__mattpocock-skills__setup-pre-commit): Set up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests in the current repo. Use when user wants to add pre-commit hooks, 
- [setup-ts-deep-modules](https://doutorai.pt/en/components/skills__mattpocock-skills__setup-ts-deep-modules): Wire dependency-cruiser into a TypeScript repo so each package is a deep module - implementation hidden in subfolders, reachable only through its entr
- [tdd](https://doutorai.pt/en/components/skills__mattpocock-skills__tdd): Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.
- [teach](https://doutorai.pt/en/components/skills__mattpocock-skills__teach): Teach the user a new skill or concept, within this workspace.
- [to-questionnaire](https://doutorai.pt/en/components/skills__mattpocock-skills__to-questionnaire): Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
- [to-spec](https://doutorai.pt/en/components/skills__mattpocock-skills__to-spec): Turn the current conversation into a spec and publish it to the project issue tracker - no interview, just synthesis of what you've already discussed.
- [to-tickets](https://doutorai.pt/en/components/skills__mattpocock-skills__to-tickets): Break a plan, spec, or the current conversation into a set of tracer-bullet tickets, each declaring its blocking edges, published to the configured tr
- [triage](https://doutorai.pt/en/components/skills__mattpocock-skills__triage): Move issues and external PRs through a state machine of triage roles - categorise, verify, grill if needed, and write agent-ready briefs.
- [wait-what](https://doutorai.pt/en/components/skills__mattpocock-skills__wait-what): Stop. That last message did not land - re-pitch it.
- [wayfinder](https://doutorai.pt/en/components/skills__mattpocock-skills__wayfinder): Plan a huge chunk of work - more than one agent session can hold - as a shared map of decision tickets on your issue tracker, and resolve them one at 
- [wizard](https://doutorai.pt/en/components/skills__mattpocock-skills__wizard): Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentia
- [writing-beats](https://doutorai.pt/en/components/skills__mattpocock-skills__writing-beats): Writing, exploit - assemble raw material into a journey of beats, grounding each term before a beat leans on it.
- [writing-for-agents](https://doutorai.pt/en/components/skills__mattpocock-skills__writing-for-agents): Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.
- [writing-fragments](https://doutorai.pt/en/components/skills__mattpocock-skills__writing-fragments): Writing, explore - mine raw fragments, no structure yet.
- [writing-shape](https://doutorai.pt/en/components/skills__mattpocock-skills__writing-shape): Writing, exploit - shape raw material into an article, paragraph by paragraph.

## License and credit

These skills were written by Matt Pocock and are published at [mattpocock/skills](https://github.com/mattpocock/skills) under the MIT license, which allows this redistribution as long as the credit is kept. What is ours is the curation: one page per skill, each with what it does and when to use it.

## Frequently asked questions

### Who is Matt Pocock?

A developer and educator known for his work on TypeScript. These skills are the set he published for use with coding agents, and they are here with the original credit and MIT license.

### Are the skills in English?

Yes. Each page shows the original skill file, in English, as the agent reads it, together with a short description and the install command.

### Can I use these skills in a commercial project?

Yes. The MIT license allows commercial use, as long as you keep the copyright notice and the license. Each page shows the install command.

## Save hours every week with AI, no hassle

**Doutor AI** gives you 1,859 ready-to-copy AI prompts, by industry and in plain English - plus a complete technical library for those who want to go further. [See plans →](https://doutorai.pt/en/pricing)

---
Content by Doutor AI (https://doutorai.pt/en). When quoting, please cite the source: https://doutorai.pt/en/sources/mattpocock