PluginBench
Skill
Pass
Audit score 90

grill-with-docs

mattpocock/skills

Conduct rigorous design interviews while auto-generating ADRs and glossary docs.

SourceView on skills.sh

What is grill-with-docs?

A structured interview skill that challenges assumptions and refines plans or designs through relentless questioning. As you work through the interview, it simultaneously generates Architecture Decision Records (ADRs) and domain glossary entries to document decisions and terminology.

  • Asks probing questions to stress-test and sharpen your plan or design
  • Captures key decisions and records them as ADRs
  • Builds a domain glossary from terminology discussed during the interview
  • Identifies gaps and assumptions in your thinking
  • Creates documentation artifacts as a byproduct of the interview process

How to install grill-with-docs

npx skills add https://github.com/mattpocock/skills --skill grill-with-docs
Claude Code
Cursor
Windsurf
Cline

How to use grill-with-docs

  1. 1.Call the Skill tool with 'grilling' mode to begin the relentless interview
  2. 2.Answer the probing questions honestly to stress-test your plan
  3. 3.Call the Skill tool with 'domain-modeling' mode to extract and formalize terminology
  4. 4.Review the generated ADRs and glossary entries for completeness
  5. 5.Iterate on your design based on gaps or challenges uncovered

Use cases

Good for
  • Validating a new system architecture before implementation
  • Refining a product design by questioning core assumptions
  • Documenting design decisions while they're being made
  • Building shared vocabulary across a team during design sessions
  • Stress-testing a plan to uncover hidden dependencies or risks
Who it's for
  • Architects and technical leads
  • Product managers designing new features
  • Teams planning major system changes
  • Anyone formalizing implicit design knowledge

grill-with-docs FAQ

What's the difference between 'grilling' and 'domain-modeling' modes?

'Grilling' conducts the relentless interview to challenge your plan; 'domain-modeling' extracts and formalizes the terminology and concepts discussed into a glossary and ADR entries.

Do I need to prepare anything before using this skill?

Have a plan, design, or proposal in mind that you want to stress-test. The skill works best when you have something concrete to discuss.

Will this replace my design review process?

No, it's a complement to design reviews. It helps you prepare by identifying gaps and documenting decisions, but human review and feedback are still essential.

Can I use this for existing systems?

Yes, you can use it to retrospectively document and challenge decisions in an existing design, or to plan improvements to current systems.

Full instructions (SKILL.md)

Source of truth, from mattpocock/skills.


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".