grill-with-docs · mattpocock — Claude Code skill: what it does, how to install
This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition.
/plugin marketplace add mattpocock/skills
/plugin install mattpocock-skills@mattpocockWhat grill-with-docs does
grill-with-docs turns plan and design review into a structured interview. It asks questions to clarify decisions, then records the results in ADRs and a glossary as the work progresses. That fits projects where the direction exists but terms and design choices still need discussion.
The skill calls the Skill tool twice: once for “grilling” and once for “domain-modeling”. Model invocation is disabled, so you start it explicitly. You need Claude Code and the skill installed from mattpocock/skills. Install it when you want the reasoning and the resulting project documents in one workflow; for a small, settled task, the interview is probably unnecessary.
What it helps with
- challenge a plan before implementation
- surface disputed design decisions
- record architecture decisions in ADRs
- build a shared project glossary
Example prompts for the agent
- Interview me about this plan and record the decisions in ADRs.
- Review this design, ask about unclear choices, and build a glossary.
- Run grill-with-docs to work through the domain model.
How to install grill-with-docs
1Plugin marketplace
/plugin marketplace add mattpocock/skills/plugin install mattpocock-skills@mattpocockThis installs the whole mattpocock-skills plugin with all its skills
2Skills CLI (Vercel)
npx skills add mattpocock/skills --skill grill-with-docs -a claude-code3Manually: put the files in place
~/.claude/skills/grill-with-docs/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grill-with-docs/
Manually: put the files in place
.agents/skills/grill-with-docs/SKILL.mdFor all projects use ~/.agents/skills/
Manually: put the files in place
.cursor/skills/grill-with-docs/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install mattpocock/skills grill-with-docs2Manually: put the files in place
.github/skills/grill-with-docs/SKILL.mdPlatform CLI
gemini skills install https://github.com/mattpocock/skills --path skills/engineering/grill-with-docsManually: put the files in place
.devin/skills/grill-with-docs/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
From the same set32
The whole set →Other versions of grill-with-docs
Similar
Questions about grill-with-docs
How do I install grill-with-docs in Claude Code?
Add the marketplace with /plugin marketplace add mattpocock/skills, then install it using /plugin install mattpocock-skills@mattpocock.
What does grill-with-docs do?
It interviews you about a plan or design, sharpens the decisions, and creates ADRs and a glossary during the process.
How does grill-with-docs run its stages?
It calls the Skill tool twice, for “grilling” and “domain-modeling”. Model invocation is disabled, so you need to start the skill explicitly.
Source text
SKILL.md · MIT
--- 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".
© Matt Pocock · MIT · mattpocock/skills
