skills.rest
Kunj-Sharma03
Kunj-Sharma03COMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

Interrogates a plan or design through structured questioning while generating ADRs and a glossary.

Updated Aug 11, 2026
Search Tags:#planning#domain modeling#adr#glossary#interview#design review#architecture decision records
One-click install
npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill grill-with-docs-kunj-sharma03
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Kunj-Sharma03/agent-contextify/tree/main/skills-main/skills/engineering/grill-with-docs
Command: npx skills add https://github.com/Kunj-Sharma03/agent-contextify --skill grill-with-docs-kunj-sharma03

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions, vague requirements, and undocumented decisions that surface too late. This Skill runs a relentless interview session that stress-tests a plan or design while simultaneously capturing the outcomes as durable documentation. ## Core Features & Use Cases - Structured Interrogation: Runs a /grilling session that challenges a plan or design with probing questions to expose gaps and weak assumptions. - Documentation as a Byproduct: Produces Architecture Decision Records (ADRs) and a project glossary as the interview progresses. - Domain Modeling Integration: Leverages the /domain-modeling skill to ground the discussion in a shared vocabulary and model. - Use Case: Before starting implementation of a new service, run a grilling session on the design proposal to clarify edge cases, record key decisions as ADRs, and align the team on terminology. ## Quick Start Ask the agent to run a grilling session on your current design document so it can challenge the plan and produce 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 stress-test a software design before implementation?▼

Run a grilling session on the design document, which subjects it to relentless structured questioning that exposes hidden assumptions and gaps. The session also records the outcomes as ADRs and a glossary.

How to generate ADRs from a design discussion?▼

This Skill creates Architecture Decision Records automatically as the interview progresses, capturing each decision and its rationale. It also builds a glossary of domain terms alongside the ADRs.

What is a grilling session in software design review?▼

A grilling session is a structured interview where the design author is challenged with probing questions to clarify requirements and defend decisions. It uses the domain-modeling skill to keep terminology consistent.

Does grill-with-docs require other skills to work?▼

Yes, it depends on the domain-modeling skill to ground the session in a shared vocabulary and model. It is also designed to be invoked manually, as implicit invocation is disabled.

When should I not use a grilling session for planning?▼

Avoid it for trivial or well-understood tasks where formal ADRs add overhead without value. It is best suited for designs with meaningful architectural decisions and multiple stakeholders.

Related Skills

Explore More Software Engineering Skills→
steltzsteltz

brainstorming

Clarify goals and constraints to produce concrete design outlines.

Community
Intermediate
atelier-fashionatelier-fashion
159

architect

Generate architecture designs and task breakdowns from requirements.

Official
Advanced
VrooliVrooli
54

Domain Compression

Compress overlapping domain concepts into a minimal consistent vocabulary.

Official
Advanced
organvm-i-theoriaorganvm-i-theoria

feedback-pedagogy

Generates rubrics, feedback comments, and peer review protocols for educational assessment.

Official
Intermediate