grill-with-docs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain unchallenged assumptions and undocumented decisions. This Skill runs a relentless interview to stress-test a plan or design while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Invokes a grilling workflow that challenges assumptions, edge cases, and trade-offs in a plan or design. - Documentation Generation: Produces Architecture Decision Records (ADRs) and a domain glossary as the interview progresses. - Use Case: Before implementing a new service, run this Skill on your design proposal to surface weak points and automatically record the decisions and terminology agreed upon during the review. ## Quick Start Grill my design document for the new payment service and produce ADRs and a glossary from the discussion.

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 software design before implementation?▼

Run a structured grilling interview on the design that challenges assumptions, edge cases, and trade-offs. This Skill coordinates that interview and records the resulting decisions as ADRs and a glossary.

How to generate ADRs from a design review discussion?▼

Invoke this Skill on your plan or design; it calls the grilling and domain-modeling skills so that decisions surfaced during the interview are captured as Architecture Decision Records along with a domain glossary.

What documents does a design grilling session produce?▼

The session produces Architecture Decision Records (ADRs) capturing key decisions and a glossary defining domain terminology, both generated incrementally as the interview progresses.

Can this Skill be invoked automatically by the AI?▼

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

When should I not use a design grilling workflow?▼

Avoid it for trivial changes or well-understood tasks where a full interview adds overhead without new insight. It is best suited to non-trivial plans and designs with meaningful architectural trade-offs.