skills.rest
ZubairImtiaz3
ZubairImtiaz3COMMUNITY
Explore all skills by this author →
Website𝕏@zubairimtiaz1GitHub

grill-with-docs

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

Updated Sep 2, 2026
Search Tags:#planning#domain modeling#adr#glossary#interview#design review#architecture decision record
One-click install
npx skills add https://github.com/ZubairImtiaz3/Safar-E-Iman-Portal --skill grill-with-docs-zubairimtiaz3
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/ZubairImtiaz3/Safar-E-Iman-Portal/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/ZubairImtiaz3/Safar-E-Iman-Portal --skill grill-with-docs-zubairimtiaz3

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions, vague terminology, and unchallenged decisions. This Skill runs a relentless interview to stress-test a plan or design while simultaneously producing documentation artifacts (Architecture Decision Records and a glossary) as the conversation progresses. ## Core Features & Use Cases - Design Interrogation: Delegates to a "grilling" skill that challenges assumptions and weak points in a plan or design. - Domain Modeling: Delegates to a "domain-modeling" skill to capture entities, terms, and decisions uncovered during the interview. - Documentation as Output: Produces ADRs and a glossary as byproducts of the review session. - Use Case: Before implementing a new service, run this Skill on your design proposal to expose gaps and walk away with written ADRs and a shared vocabulary. ## Quick Start Ask the assistant to grill my design document 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 interrogation of the design that challenges assumptions, edge cases, and trade-offs. This Skill delegates to a grilling skill for the interview and a domain-modeling skill to capture the results as ADRs and a glossary.

How to generate ADRs from a design discussion?▼

Invoke this Skill on your plan or design; as the interview surfaces decisions, the domain-modeling step records them as Architecture Decision Records along with a glossary of domain terms.

What outputs does the grill-with-docs skill produce?▼

It produces Architecture Decision Records (ADRs) and a glossary, created incrementally during the design interrogation. The interview itself is handled by the delegated grilling skill.

Does grill-with-docs work on its own?▼

No. It is an orchestration wrapper that calls two other skills, "grilling" and "domain-modeling", via the Skill tool. Those skills must be available for it to function.

When should I not use a design grilling interview?▼

Avoid it for trivial changes with no architectural impact or when requirements are already fully validated. The interview adds the most value on ambiguous, high-stakes designs where decisions need documentation.

Related Skills

Explore More Software Engineering Skills→
BING0116-gifBING0116-gif

grill-master

Interviews users with focused questions to clarify requirements before planning or implementation.

Community
Intermediate
DawnMoon1542DawnMoon1542
7

writing-plans

Generates sequential per-stage implementation plans from completed stage designs.

Community
Advanced
vorynkavitaliyvorynkavitaliy

stride-analysis-patterns

Identify STRIDE threats with category mappings and mitigation guidance.

Community
Advanced
inkfininkfin

grill-with-docs

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

Community
Basic