Skip to content
Grill With Docs

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.

GitHub Docs

Install

Install with the skills CLI

One command for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf and dozens of other agents. Needs Node.js; the skill is fetched straight from mattpocock/skills.

$ npx skills add mattpocock/skills --skill grill-with-docs

Run it in a terminal. The CLI finds the agents installed on your machine, asks which ones to add the skill to, and whether to install it into the folder you ran it from or for all your projects.

Other ways to install

Copy the whole skill folder — SKILL.md and any scripts or references beside it — into ~/.claude/skills/grill-with-docs/, where Claude Code picks it up in every project. Only git is needed.

tmp=$(mktemp -d) && \
  git clone --depth 1 --branch main https://github.com/mattpocock/skills.git "$tmp" && \
  mkdir -p ~/.claude/skills && \
  cp -R "$tmp"/skills/engineering/grill-with-docs ~/.claude/skills/grill-with-docs

No scripts or references next to it? Saving the SKILL.md alone as ~/.claude/skills/grill-with-docs/SKILL.md works too.

Using another agent? Its personal skills folder
Codex
~/.agents/skills/
Cursor
~/.cursor/skills/
GitHub Copilot
~/.copilot/skills/
Gemini CLI
~/.gemini/skills/
Windsurf
~/.codeium/windsurf/skills/
OpenCode
~/.config/opencode/skills/

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.

SKILL.md
name
grill-with-docs
description
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
disable-model-invocation
true

Call the Skill tool twice, for "grilling" and "domain-modeling".

Install

Skill: Domain Modeling

by Matt Pocock

New

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.

Planning 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.

71 views

Skill: Prototype

by Matt Pocock

New

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.

Browse all skills →