Just shippedBest skills for each job.See the picks →

planningclaude-codecodexcursorEvidence not reviewed

Grill with docs: interview to sharpen a plan and write ADRs

A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.

Upstream publishes this file as a Claude skill (SKILL.md). Cursor reads the same SKILL.md shape. This page does not claim either product ships the file.

What the research says

Evidence not reviewed

Nobody has reviewed the evidence for this skill yet.

Let your agent do it

Copy a prompt for Claude Code, Codex, or Cursor.

Paste it into your coding agent in this repo. It does the setup and asks before anything leaves your machine.

Runs the same job in your agent session, on the plan you are signed in with. No API key, no Action.

Install the "Grill with docs: interview to sharpen a plan and write ADRs" agent skill from AgentFlows (https://agentflows.sh/skills/mattpocock-grill-with-docs) and use it with the plan I'm signed in with. No API key needed.

Install these agent skills first. Download each SKILL.md from its source (respect its license) into .claude/skills/<name>/SKILL.md, or wherever this agent loads skills from:
- Grill with docs: interview to sharpen a plan and write ADRs: https://github.com/mattpocock/skills/tree/main/skills/engineering/grill-with-docs (MIT), notes at https://agentflows.sh/skills/mattpocock-grill-with-docs

Then confirm the skill loaded, tell me in two lines when it kicks in, and offer to run it now on this repo.

The file

SKILL.md

Copy the upstream file, including its own frontmatter, into .claude/skills/mattpocock-grill-with-docs/SKILL.md.

.claude/skills/mattpocock-grill-with-docs/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".