grill-with-docs

Refines plans and designs through iterative questioning while creating ADRs and glossaries.

Updated Sep 14, 2026
One-click install
npx skills add https://github.com/Suge8/skills --skill grill-with-docs-suge8
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Suge8/skills/tree/main/workflow/grill-with-docs
Command: npx skills add https://github.com/Suge8/skills --skill grill-with-docs-suge8

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and vague terminology that cause problems later. This Skill pressure-tests your plan or design through continuous questioning and captures the outcomes as durable documentation. ## Core Features & Use Cases - Iterative Interrogation: Uses the grilling skill to challenge and refine a plan or design through persistent follow-up questions. - Documentation Generation: Uses the domain-modeling skill to produce Architecture Decision Records (ADRs) and a domain glossary during the refinement process. - Use Case: You have a draft architecture for a new service. Invoke this Skill to be grilled on your design decisions, and walk away with ADRs documenting each decision plus a glossary of agreed domain terms. ## Quick Start Use the grill-with-docs skill to challenge my current design proposal and record the decisions as ADRs and a glossary.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I refine a software design through AI questioning?▼

Invoke this Skill with your draft plan or design, and it will apply the grilling skill to ask persistent follow-up questions that expose weak assumptions. Each resolved decision is then documented as an ADR.

What documentation does design grilling produce?▼

The process produces Architecture Decision Records (ADRs) capturing each design decision and its rationale, plus a domain glossary defining agreed terminology. Both are created via the domain-modeling skill during the session.

What is an ADR in software architecture?▼

An ADR (Architecture Decision Record) is a short document capturing a single architectural decision, its context, and its consequences. This Skill generates ADRs automatically as decisions are settled through questioning.

Does grill-with-docs work without the grilling and domain-modeling skills?▼

No, this Skill explicitly depends on the grilling and domain-modeling skills being available. It orchestrates those two skills rather than implementing the questioning or documentation logic itself.

When should I use design grilling instead of a normal design review?▼

Use it when you want adversarial, persistent questioning of a plan before implementation, with decisions captured as written ADRs and a glossary. It is less suited for quick sanity checks or informal feedback.