Matt Pocock's skill for actively building a project's domain model while you design: it challenges terms against GLOSSARY.md, sharpens vague language, stress-tests concepts with scenarios, checks claims against the code and records ADRs sparingly.
Grill With Docs Skill
Matt Pocock's combined skill that interviews you relentlessly about a plan or design while writing ADRs and a domain glossary as decisions are made, by chaining his grilling and domain-modeling skills.
Install
Other ways to install
About
- Chains the grilling and domain-modeling skills in a single command
- Interviews you about a plan or design until open decisions are resolved
- Records settled decisions as Architecture Decision Records (ADRs)
- Builds a glossary of domain terms as the conversation goes
- Manual invocation only (disable-model-invocation), so it never starts unasked
Grill With Docs is one of the most installed skills in Matt Pocock's mattpocock/skills collection, and it is deliberately tiny: its whole SKILL.md tells the agent to call two other skills from the same repository, grilling and domain-modeling, in turn. The result is a design review that leaves paperwork behind. The grilling half questions a plan or design one point at a time until the open decisions are pinned down; the domain-modeling half captures what was settled as Architecture Decision Records and a glossary of the project's domain terms while the conversation is still going.
It is meant for developers who use a coding agent to think through a feature before building it and want the reasoning to survive the session, so the next person (or the next agent run) can read why something was decided instead of re-litigating it. The frontmatter sets disable-model-invocation: true, so the agent never starts it on its own: you invoke it explicitly, typically as /grill-with-docs in Claude Code.
Because it only orchestrates, it works only when the grilling and domain-modeling skills are installed alongside it. Installing the repository with npx skills add mattpocock/skills and picking the skills you want covers that. The collection is MIT licensed.
SKILL.md
The instructions your agent loads, as published by Matt Pocock.
Related Skills
See all Grill With Docs alternativesPlanning skill that interrogates your use case before any code is written, then recommends the right Twilio Conversations stack — ConversationRelay, Memory, Intelligence, Orchestrator, TaskRouter — and the implementation skills to follow.
Matt Pocock's skill for throwaway prototypes that answer one design question: a single-file HTML walkthrough for state models and logic, or several switchable UI variations on one route.
Matt Pocock's /improve-codebase-architecture command: finds shallow modules worth deepening, renders them as a visual HTML report with before/after diagrams, then grills you through the one you pick.