1. Habit
  2. Skills
  3. Grill With Docs skill
Matt Pocock · 1.2M installsAI Hero · ex-Vercel · Total TypeScript

Grill With Docs skill
Runs by itself, when you start a plan.

Your project's decisions pile up in writing.

Install the Grill With Docs skill and make it a habit: follow https://gethabit.dev/skills/mattpocock/grill-with-docs.md

  1. 1Copy
  2. 2Paste into Claude Code, Codex or Cursor
  3. 3It runs by itself

1.2M installs300K starsMIT licenceSource on GitHub ↗

Grill With Docs

by Matt Pocock · 1.2M installs

The skill

Asks you hard questions about a plan and writes down the answers.

Only when you ask.

Better plans

Your project's decisions pile up in writing. Less re-explaining later.

↻ Runs by itselfwhen you start a plan

How the habit works.
You don't have to.

Three questionsWhen does it start? How does it check its work? What does it remember?

01

It starts by itself

you start a plan. Runs in Claude Code routine.

  • ↻ you start a plan
  • user invokes grill with docs

02

It checks its work

you answer + docs check. If a check fails, it tells you.

  • ✓at least one ADR or glossary entry was added or changed in the diff
  • ✓the run log entry for this plan exists

03

It remembers

grill runs log. The next run reads it first: plans grilled before and the docs each run touched.

loops/grill-docs-loop/runs.md

One run, step by step.
Then it stops.

Stop ruleStops after one plan per run.

  1. 01

    Start the plan

    You call grill with docs on a plan or design.

  2. 02

    Read the log

    Your agent reads past runs so it does not ask settled questions again.

  3. 03

    Grill

    It calls the grilling skill and interviews you hard about the plan.

  4. 04

    Model the domain

    It calls the domain modeling skill to record ADRs and glossary terms during the talk.

  5. 05

    Check the docs

    The diff must show at least one ADR or glossary change, otherwise you get a note.

  6. 06

    Log the run

    It writes the plan and the docs it touched to the run log.

What it may do.
Nothing more.

Safe by defaultIt writes only in its own folder and asks you before anything goes out.

Is it for you?
Use it when it fits.

Quick checkRead both lists. If the left one sounds like you, the Grill With Docs skill helps.

Use it when

  • ✓ You plan a new feature
  • ✓ You want decisions recorded
  • ✓ Your domain terms are fuzzy

Skip it when

  • – You need no written docs
  • – The plan is already settled

Questions

Grill With Docs skill, answered.

Which skills does it need?

It calls two others: grilling and domain modeling. Install both.

What does it write?

Architecture decision records (ADRs) and glossary entries, made by the domain modeling skill.

How do I install the Grill With Docs skill?

Copy the prompt at the top into your agent. It installs the skill from mattpocock/skills and sets up the habit. Or run npx skills add mattpocock/skills --skill grill-with-docs.

Is the Grill With Docs skill free?

Yes. It is published under MIT. Habit is free too.

Grill With Docs. Now as a habit.

Install the Grill With Docs skill and make it a habit: follow https://gethabit.dev/skills/mattpocock/grill-with-docs.md

  • Free
  • No account
  • Undo in one line

All Matt Pocock skills →More planning skills →

Works in

  • Claude Code
  • Codex
  • Cursor
  • ChatGPT
  • Claude app

Made by Matt Pocock, published under MIT. Habit links to the original and never changes it. Is this your skill?

Copying didn't work here. Select the line and copy it by hand.