Skills Prompts

Popular categories

Agent skill · Skills for Real Engineers

/grill-with-docs Plan interviews that build a project glossary

The grill-with-docs skill runs a structured interview about a plan or design and, during the same session, records agreed terms in GLOSSARY.md and significant decisions as ADRs. It combines the pack's grilling and domain-modeling skills, so you leave with both a settled plan and shared vocabulary the agent reuses later.

Works with

  • Claude Code
  • Codex
  • GitHub Copilot
  • Gemini CLI
  • Cursor, OpenCode, Windsurf, Amp and others

Used forPlanning and specs

When to use it

  • Before starting any non-trivial change, to make sure the agent understands what you want.
  • When a project's jargon is fuzzy and the agent keeps describing things at length.
  • When a design choice is hard to reverse and future readers will need to know why it was made.

How it works

  1. 1
    Map the decisions

    The agent treats the plan as a tree of decisions and finds the ones whose prerequisites are already settled.

  2. 2
    Ask in rounds

    It asks that whole set of numbered questions at once, each with a recommended answer, then waits for yours.

  3. 3
    Look up facts itself

    Questions that depend on facts in the codebase are answered by a sub-agent instead of being put to you.

  4. 4
    Sharpen terms

    It challenges vague or conflicting words, tests them with edge-case scenarios and writes resolved terms to GLOSSARY.md.

  5. 5
    Record key decisions

    It offers an ADR only for decisions that are hard to reverse, surprising and the result of a real trade-off.

What it steers the agent away from

  • Starting to code before the plan is actually agreed
  • Glossaries cluttered with implementation notes
  • ADRs written for decisions that did not need one

Install this skill

It installs with the Skills for Real Engineers pack.

Claude CodeInstalled as a plugin that updates itself by default.
claude plugin install mattpocock-skills@claude-plugins-official
CodexUpdates at startup.
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock
GitHub CopilotWorks in the CLI and VS Code; the README also shows a one-time settings.json entry to enable auto-update.
copilot plugin marketplace add mattpocock/skills
copilot plugin install mattpocock-skills@mattpocock
Gemini CLIRe-run both commands to update.
gemini skills install https://github.com/mattpocock/skills.git --path skills/engineering
gemini skills install https://github.com/mattpocock/skills.git --path skills/productivity
Cursor, OpenCode, Windsurf, Amp and othersCopies editable files into your project; update with npx skills@latest update. Use either this or a plugin per agent, not both.
npx skills@latest add mattpocock/skills -a <agent>

Commands come from the author’s README; check it for changes before you run them.

Questions

How is grill-with-docs different from grill-me?

grill-me only runs the interview and suits non-code topics. grill-with-docs adds domain modeling, so it also maintains a glossary and ADRs in your repo.

Does the agent start implementing after the interview?

No. The session ends when every decision is resolved, and the agent waits for you to confirm shared understanding before acting.

More guides from Skills for Real Engineers

Also in this pack

All 39 skills →

Summary by trendhub. The skill itself lives in mattpocock/skills/skills/engineering/grill-with-docs by Matt Pocock (MIT); read the full, current text there.