v2 · 32 skills · Extended edition

Matt Pocock
Claude Code
Skills Map

Complete two-page reference. NEW skills (28 globally installed this session) are marked NEW. Skills already global: /grill-me, /handoff, /to-prd.

PlanBuildArchReviewProcessWriteMetaLearn

Master flow

/grill-me
or docs
/to-prd
→ /issues
/implement
+ /tdd
/review
/ultra
/arch
pass
/diagnose
/triage

Key aliases

/ultra-review/code-review ultra (already global)

/write-a-skill/skill-creator (already global)

Planning & Discovery

PLAN
/grill-me

Interviews you until the task is clear enough to build. One question at a time.

Use when the request is vague or easy to misunderstand.

PLAN + REPO
/grill-with-docs NEW

Grilling grounded in repo docs, ADRs, and code context.

Use before touching a real codebase.

PROTOTYPE
/prototype NEW

Builds throwaway prototypes to answer high-fidelity UX/design questions.

Use when you need to see it, not just talk about it.

HANDOFF
/handoff

Compacts a rich session into a fresh-agent handoff doc.

Use when context is crowded or switching agents.

DECISION
/decision-mapping NEW

Turns a loose idea into a sequenced map of investigation tickets, then drives them one at a time.

Use when you don't yet know what you don't know.

DOMAIN
/domain-modeling NEW

Builds and sharpens the project domain model; pins terminology and records ADRs.

Use when terms are ambiguous across the team.

Spec & Delivery

SPEC
/to-prd

Turns planning context into a structured engineering PRD.

Use after grilling, before implementation across sessions.

ISSUES
/to-issues NEW

Breaks a PRD into tracer-bullet implementation issues.

Use to convert spec into executable vertical slices.

IMPLEMENT
/implement NEW

Implements a piece of work based on a PRD or set of issues.

Use after /to-issues to drive execution.

TRIAGE
/triage NEW

Moves issues and external PRs through a state machine: categorise → verify → grill → write agent-ready briefs.

Use to manage incoming work from external contributors.

REFACTOR
/request-refactor-plan NEW

Creates a detailed refactor plan with tiny commits via user interview, then files it as a GitHub issue.

Use when you need to plan a refactor safely.

UBIQ LANG
/ubiquitous-language NEW

Extracts a DDD-style ubiquitous language glossary, flags ambiguities, saves to UBIQUITOUS_LANGUAGE.md.

Use when terms drift between code, docs, and conversations.

Architecture & Design

ARCH
/improve-codebase-architecture NEW

Finds deepening refactors, better seams, and more testable boundaries.

Use when the code works but feels shallow or tangled.

DESIGN
/codebase-design NEW

Shared vocabulary for designing deep modules — interfaces, seams, testability, AI-navigability.

Use when designing or improving a module's interface.

INTERFACE
/design-an-interface NEW

Generates multiple radically different interface designs via parallel sub-agents.

Use to explore API shapes — "design it twice".

REVIEW
/review NEW

Checks diff quality against standards and the originating spec.

Use before merge on normal-risk work.

DEEP REVIEW
/ultra-review

Heavier, cloud-style review with multiple perspectives.

→ invoke as /code-review ultra

Use for risky PRs, major refactors, or pre-release.

DEBUG
/diagnosing-bugs NEW

Diagnosis loop for hard bugs and performance regressions.

Use when something is broken/throwing/failing/slow.

Page 2 · Process, Writing, Meta & Learning

Supporting
Skills &
Workflows

The skills that keep quality up and the team learning. Development discipline, a writing workshop, meta-skill creation, and setup utilities.

Full decision matrix (top picks)

SituationBest skill
Idea is fuzzy/grill-me
Repo change with real docs/grill-with-docs
Need to feel the UX/prototype
Need reusable spec/to-prd
Need implementation slices/to-issues → /implement
Terms are drifting/ubiquitous-language
Repo is getting messy/improve-codebase-architecture
Fast confidence check/review
Critical or risky diff/code-review ultra
Something is broken/diagnosing-bugs
Want honest increments/tdd
Learn a framework/domain/teach
Codify a workflow/skill-creator

Development Discipline

DISCIPLINE
/tdd NEW

Pushes one-test, one-implementation, red-green-refactor loops.

Use when you want honest incremental implementation.

GIT MERGE
/resolving-merge-conflicts NEW

Guided resolution of in-progress git merge or rebase conflicts.

Use when you hit a merge conflict mid-rebase.

QA SESSION
/qa NEW

Interactive QA where you report bugs conversationally and the agent files GitHub issues.

Use to report bugs or do QA sessions interactively.

EXERCISES
/scaffold-exercises NEW

Creates exercise directory structures with sections, problems, solutions, and explainers.

Use when setting up a new course section or coding challenges.

Writing Workshop

WRITE
/writing-fragments NEW

Mines you for heterogeneous nuggets — claims, vignettes, sharp sentences, half-thoughts — as raw material.

Use before you have structure: ideate first.

WRITE
/writing-beats NEW

Shapes an article as a journey of beats; pick a beat, write it, pivot. Choose-your-own-adventure.

Use when you have raw material and want narrative, not argument.

WRITE
/writing-shape NEW

Takes raw material and shapes it into a publishable article paragraph by paragraph.

Use when you have a pile of notes and want to turn them into something.

EDIT
/edit-article NEW

Edits and improves articles: restructures sections, improves clarity, tightens prose.

Use when you have a draft and want a quality editing pass.

Meta & Setup

META
/writing-great-skills NEW

Reference vocabulary and principles for writing predictable, reusable skills well.

Use when designing a new skill from scratch. See also /skill-creator.

SETUP
/setup-matt-pocock-skills NEW

Scaffolds repo-level config, docs, and issue-tracker conventions that these skills expect.

Run once per new repo before starting.

PRE-COMMIT
/setup-pre-commit NEW

Sets up Husky pre-commit hooks with lint-staged (Prettier), type checking, and tests.

Use when adding commit-time formatting / type checking to a repo.

GIT SAFETY
/git-guardrails-claude-code NEW

Sets up Claude Code hooks to block dangerous git commands before they execute.

Use to prevent push/reset/clean accidents in Claude Code.

Learning

LEARN
/teach NEW

Builds personalized lessons, resources, and progress artifacts around your goal.

Use to learn frameworks, languages, or any domain systematically.

NOTES
/obsidian-vault NEW

Search, create, and manage notes in your Obsidian vault with wikilinks and index notes.

Use to find, create, or organize notes in Obsidian during a session.

Desk-side heuristics

  • Grill before you build. Expensive context is lost if you skip to code too early.
  • Smart models for planning, cheaper for implementation. Most value at build time is contextual, not parametric.
  • Protect rich context. Extract a PRD or /handoff doc before ending a deep grilling session.
  • Architecture is a maintenance ritual. Schedule /improve-codebase-architecture, don't wait for pain.
  • /ultra-review for the risky stuff. Use it on pre-release or schema migrations — invoke as /code-review ultra.
  • Writing workflow: fragments → beats → shape → edit. Never start from structure.
  • New repo? Run /setup-matt-pocock-skills first, then /setup-pre-commit, then /git-guardrails-claude-code.