Grill Me by Matt Pocock

Use Grill Me by Matt Pocock to clarify a plan through a structured interview. Choose the ordinary grilling conversation or the Grill with Docs mode when a software discussion also needs shared terminology and architectural records, then review the decisions before starting implementation.

Install and get started

Choose your agent to see how to get started. In Floatboat, copy a request that asks the agent to read the original instructions. Other options show the Skill installation command or the publisher’s native setup steps.

Choose an agent

Start in Floatboat

Copy the request into a Floatboat conversation

Read the original Grill Me instructions at https://github.com/mattpocock/skills/blob/main/skills/productivity/grill-me/SKILL.md. Explain its purpose, required tools, and installation options, then help me use it.

Let the agent read the original instructions and check how to use them in your environment.

Download Floatboat ↗

Try this request

Use /grill-with-docs to examine partial order cancellation. Check our glossary and current code, clarify the domain rules, and propose only the glossary or ADR changes that are warranted before implementation.

About Grill Me

Grill Me is Matt Pocock’s user-invoked interview entry, delegating its questioning to the companion grilling Skill. It maps a plan into dependent decisions and asks the choices that can be settled with the information currently available. For software discussions that should also refine project language and durable records, Grill with Docs combines grilling with domain-modeling. That mode checks the glossary, code, and existing architectural decisions, updates resolved terms in GLOSSARY.md, and records an ADR only when a consequential trade-off warrants it. These are two entry points into related methods, so this guide covers them together. Install the collection with its companions, choose the mode that fits the task, and review decisions and any file changes before implementation.

Use Cases for Plan Reviews with Grill Me

Explore plans that need clearer goals, decisions, or shared language before implementation. Use the ordinary interview for a product idea or workflow change, and the document-aware mode when a software discussion must also leave precise terminology and justified architectural decisions for later work.

Shape a product idea

Use the ordinary interview to clarify the audience, useful outcome, and choices that change what should be built.

Review a workflow change

Identify who is affected, what must remain possible, and which dependent decisions need to be settled before work is allocated.

Record a software design discussion

Choose Grill with Docs to check project terms against code and existing records, updating the glossary or an ADR only where the discussion warrants it.

How to Clarify Plans with Grill Me

Install Matt Pocock’s collection with the required companions, then choose Grill Me for an interview or Grill with Docs for project-aware terminology and records. Provide the plan and current evidence, resolve questions in rounds, and confirm the resulting decisions and warranted document changes before starting implementation.

  1. 01

    Choose the interview mode

    Provide the plan and known constraints. Invoke /grill-me for the ordinary interview, or /grill-with-docs when project terminology and records should be part of the discussion.

  2. 02

    Resolve each question round

    Answer the current questions and correct misunderstandings. In document-aware mode, compare terms and decisions with the glossary, code, and existing ADRs.

  3. 03

    Review decisions and records

    Confirm settled choices and remaining gaps. Review any glossary or ADR changes, then decide whether the next task is further discussion, documentation, or implementation.

Explore More Agent Skills

Read another Skill guide and check its original source before using it.

Grill Me FAQ

Is Grill Me the same as grilling?
Grill Me is a user-invoked entry that calls grilling, where the questioning logic lives. Grill with Docs additionally calls domain-modeling. Install these companions together rather than copying an entry file alone.
Does the agent invoke Grill Me automatically?
The current source marks this entry as user-invoked. The companion grilling discipline can also be used by other workflows that explicitly call it.
Is it only for programming plans?
The publisher places Grill Me in productivity and describes it for plans, designs, and non-code uses. Give enough context for the actual decision, whether or not it involves code.
How are the questions organized?
The companion Skill groups decisions by prerequisites. A round covers choices that can be answered now; answers unlock later questions.
What should I prepare?
Provide the plan, existing decisions, constraints, and references. Separate decisions you need to make from facts the agent can look up.
Will it start implementing the plan?
The documented interview ends with shared understanding and user confirmation. Turning the result into code or another deliverable is a follow-up task.
When should I choose Grill with Docs instead?
Choose /grill-with-docs when the conversation should refine project terms and record warranted architectural decisions. It calls grilling and domain-modeling; /grill-me calls only grilling for the ordinary interview.
Does every decision create an ADR?
No. The domain-modeling source limits ADRs to consequential, hard-to-reverse choices with genuine alternatives and context a future reader would need.
What belongs in GLOSSARY.md?
It defines domain terms and relationships. The source explicitly excludes implementation details, specifications, and scratch notes from the glossary.
Will it write project files?
The documented companion workflow can update the glossary as terms are resolved and create warranted ADRs. Review those changes within the scope you authorize.
What if the code contradicts the agreed description?
Surface the discrepancy and decide which behavior is intended. Do not silently rewrite the glossary or code to hide the conflict.