grill-with-docs

Interrogates a plan or design while generating ADRs and a glossary.

Updated Apr 23, 2026

Search Tags:#planning #architecture #domain modeling #adr #glossary #interview #design review

Ready to run

npx skills add https://github.com/sndrgrdn/skills --skill grill-with-docs-sndrgrdn

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/sndrgrdn/skills/tree/main/grill-with-docs
Command: npx skills add https://github.com/sndrgrdn/skills --skill grill-with-docs-sndrgrdn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and unresolved questions that surface too late. This Skill runs a relentless interview to stress-test a plan or design while capturing the outcomes as documentation. ## Core Features & Use Cases - Design Interrogation: Invokes the "grilling" skill to challenge a plan or design with probing questions. - Documentation Generation: Invokes the "domain-modeling" skill to produce ADRs (Architecture Decision Records) and a glossary as the interview progresses. - Use Case: Before committing to a new system architecture, run this Skill to expose weak points in the design and automatically record the decisions and terminology that emerge. ## Quick Start Ask the assistant to grill my current design plan and document the decisions and glossary as we go.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I stress-test a design plan with AI?▼

Use this Skill to run a structured interview that challenges your plan or design with probing questions. It invokes the grilling skill to expose weak assumptions and undocumented decisions before implementation begins.

How to generate ADRs during a design review?▼

This Skill creates Architecture Decision Records and a glossary as the interview progresses by invoking the domain-modeling skill. Decisions and terminology surface naturally from the questioning and are captured as documentation.

What skills does grill-with-docs depend on?▼

It calls the Skill tool twice, once for "grilling" and once for "domain-modeling". Both skills must be available in the environment for this Skill to function as intended.

Can grill-with-docs be invoked automatically by the model?▼

No. The Skill sets disable-model-invocation to true and its agent policy disallows implicit invocation, so it only runs when explicitly requested by the user.

When should I not use an interview-based design review?▼

Avoid it when the design is already finalized and only needs implementation, or when you need automated static analysis of code rather than conversational exploration of decisions and assumptions.