---
title: "Ask Matt Skill: How to Use /ask-matt in Claude Code"
canonical: https://skillselion.com/guides/ask-matt-skill-claude-code-guide
content_type: text/markdown
description: "The ask-matt skill (868,544 installs) is Matt Pocock's router for mattpocock/skills. Type `/ask-matt` with your situation and it names the skill or flow."
---

# Ask Matt Skill: How to Use /ask-matt in Claude Code

> The ask-matt skill (868,544 installs) is Matt Pocock's router for mattpocock/skills. Type `/ask-matt` with your situation and it names the skill or flow.

Canonical: https://skillselion.com/guides/ask-matt-skill-claude-code-guide

The ask-matt skill (868,544 installs) is Matt Pocock's router for mattpocock/skills. Type `/ask-matt` with your situation and it names the skill or flow to run: grill-with-docs for a new idea, triage for incoming issues, diagnosing-bugs for breakage, wayfinder for a huge foggy build.

## Key facts

- Last updated: November 14, 2026

## Article

The mattpocock/skills repo on GitHub holds 39 SKILL.md files (GitHub, November 2026), and most developers forget which one to run next. The [ask-matt skill](/skills/mattpocock/skills/ask-matt) (868,544 installs) is the repo's own router: you describe your situation and it points you at the right skill or flow.

## Key takeaways

- ask-matt has 868,544 installs, and the mattpocock/skills repo has 328,210 GitHub stars (skills.sh registry, GitHub).
- It sets `disable-model-invocation: true`, so it never fires on its own. You type `/ask-matt` when you are unsure where to start.
- It sorts the repo into a main flow, an on-ramps section with 3 entry points, a codebase-health skill, 2 vocabulary skills and a standalone group.
- It tells the agent to read a skill's own SKILL.md before it describes that skill or suggests skipping a step.
- It names 5 options at a phase boundary and makes `/compact` the default. The [Matt Pocock skills map](/guides/matt-pocock-skills-map) covers the version history.

## What is the ask-matt skill?

ask-matt is a router skill: it does no work itself and only tells you which other skill in mattpocock/skills fits your situation. Its SKILL.md opens with one line, "You don't remember every skill, so ask." The skill has 868,544 installs (skills.sh registry). It treats its own summaries as orientation only and sends the agent to the target skill's SKILL.md before it makes a claim about it.

## How do you install and run ask-matt?

Install the whole repo, then type `/ask-matt` followed by a sentence about your task. In Claude Code the repo installs with `claude plugin install mattpocock-skills@claude-plugins-official`, and any other agent can use `npx skills@latest add mattpocock/skills`. Run [/setup-matt-pocock-skills](/guides/setup-matt-pocock-skills-claude-code-guide) once per repo first. ask-matt lists it as the precondition for every engineering flow, and the setup skill has 1,167,959 installs (skills.sh registry).

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

## Which flow does ask-matt recommend for a new feature?

For an idea you want built, it points to the main flow: `/grill-with-docs`, then `/to-spec` and `/to-tickets` for a multi-session build, then `/implement` per ticket. [grill-with-docs](/guides/grill-with-docs-skill-claude-code-guide) has 1,350,303 installs, [to-spec](/skills/mattpocock/skills/to-spec) has 828,965 and implement has 884,701 (skills.sh registry). A build that fits in one session skips the spec and goes straight to `/implement` in the same window. Either way the code is driven by `/tdd` (1,261,344 installs) and closed by `/code-review` (914,095 installs), a review on two axes: standards and spec. If a question needs a runnable answer, the router adds a detour: `/handoff` out, `/prototype`, then `/handoff` back.

## What if the work does not start from an idea?

The on-ramps section of ask-matt routes 3 other starting points onto the main flow. Incoming bug reports and feature requests go to [triage](/skills/mattpocock/skills/triage) (1,093,682 installs). The skill warns that tickets made by `/to-tickets` are already agent-ready and should not be triaged. A bug that resists a first look goes to `/diagnosing-bugs` (952,814 installs), which wants a command that already fails on this bug before it guesses at a cause. A greenfield project too big for one session goes to [wayfinder](/skills/mattpocock/skills/wayfinder) (829,610 installs). Wayfinder produces decision tickets, not code, and then hands off to `/to-spec`.

## What does ask-matt say about context and phase boundaries?

It asks you to keep grilling, spec and ticketing in one unbroken context window, then start each `/implement` fresh. The limit is the "smart zone", which the skill puts at about 150k tokens on current models. At each boundary between phases it lists 5 options: continue, `/clear`, `/handoff`, a subagent, or `/compact`. It makes `/compact` the default and says to rule out continuing first. `/handoff` (1,157,430 installs) is reserved for a new harness, a new directory, a colleague, or a side task forked mid-phase.

## When should you use grill-me instead of grill-with-docs?

Use `/grill-me` only when there is no working directory, for example when you test a plan or a piece of writing. ask-matt calls `/grill-with-docs` the better choice whenever a repo exists, because it saves what it learns to `GLOSSARY.md` and ADRs. Both run the same `/grilling` interview. grill-me has 1,581,280 installs and grill-with-docs has 1,350,303 (skills.sh registry). Anthropic's [Agent Skills documentation](https://docs.anthropic.com/en/docs/agents-and-tools/agent-skills/overview) explains how slash-invoked skills like these load.

## A complete starter stack

- `/setup-matt-pocock-skills`: configures the tracker, triage labels and doc layout once per repo.
- `/ask-matt`: picks the entry point when you are unsure.
- `/grill-with-docs`: sharpens the idea and records the vocabulary.
- `/to-spec` and `/to-tickets`: turn the thread into a spec and tracer-bullet tickets.
- `/implement` with `/tdd` and `/code-review`: builds and reviews each ticket.
- [codebase-design](/guides/codebase-design-skill-claude-code) (975,841 installs): the deep-module vocabulary underneath `/tdd` and `/improve-codebase-architecture`.

More planning skills are on the [best skills for docs and planning](/best/skills-for-docs-planning) page and in the [docs and planning category](/category/docs-planning).

## Common pitfalls

- Expecting ask-matt to run on its own. Model invocation is disabled, so you have to type the command.
- Running `/triage` on tickets that `/to-tickets` wrote. They are already agent-ready.
- Compacting in the middle of the grill, spec and tickets sequence. The skill wants those 3 steps in one window.

Run `/ask-matt` at the start of a task, and the skill does the remembering for you.

## 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/setup-matt-pocock-skills-claude-code-guide](https://skillselion.com/guides/setup-matt-pocock-skills-claude-code-guide)
- [/guides/grill-with-docs-skill-claude-code-guide](https://skillselion.com/guides/grill-with-docs-skill-claude-code-guide)

## FAQ

### What is the ask-matt skill?

ask-matt is a router skill in mattpocock/skills that tells you which skill or flow fits your situation. It has 868,544 installs (skills.sh registry). See the [ask-matt skill page](/skills/mattpocock/skills/ask-matt).

### How do I use ask-matt in Claude Code?

Install the repo with `claude plugin install mattpocock-skills@claude-plugins-official`, then type `/ask-matt` and describe your task. The repo has 328,210 GitHub stars. See [how to install a Claude Code skill](/guides/how-to-install-a-claude-skill).

### Does ask-matt run automatically?

No. Its SKILL.md sets `disable-model-invocation: true`, so you start it with `/ask-matt`. It has 868,544 installs. Read the [ask-matt listing](/skills/mattpocock/skills/ask-matt).

### What should I run before ask-matt?

Run `/setup-matt-pocock-skills` once per repo. ask-matt lists it as the precondition for every engineering flow, and it has 1,167,959 installs. See the [setup guide](/guides/setup-matt-pocock-skills-claude-code-guide).

### What is the difference between ask-matt and the Matt Pocock skills map?

ask-matt is a skill you run in your session to pick the next step; the skills map is a guide you read for the version history, such as /to-prd becoming /to-spec (828,965 installs). Read the [Matt Pocock skills map](/guides/matt-pocock-skills-map).

## 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/)
