grill-with-docs

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

Updated Jul 12, 2025
One-click install
npx skills add https://github.com/kpayakv2/check-products --skill grill-with-docs-kpayakv2
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/kpayakv2/check-products/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/kpayakv2/check-products --skill grill-with-docs-kpayakv2

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague terms, and unchallenged decisions. This Skill runs a relentless structured 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 - Relentless Interview: Challenges every assumption, ambiguity, and design choice through a structured grilling process. - Documentation as a Byproduct: Creates ADRs and a domain glossary during the interview rather than as a separate task. - Composed Workflow: Delegates to two underlying capabilities, "grilling" and "domain-modeling", invoked together. - Use Case: Before implementing a new service, run this Skill on your design proposal to expose weak points and walk away with written ADRs and a shared vocabulary for the team. ## Quick Start Ask the assistant to grill my current 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 grilling interview on the design that challenges every assumption, ambiguous term, and unexamined decision. This Skill conducts that interview and records the outcomes as Architecture Decision Records and a glossary.

How to generate ADRs during a design review?▼

ADRs are generated as a byproduct of the interview process rather than written separately. As each design decision is questioned and resolved, the outcome is captured as an Architecture Decision Record alongside a domain glossary.

What documents does a design grilling session produce?▼

The session produces two documentation artifacts: Architecture Decision Records capturing resolved design decisions, and a glossary defining domain terms clarified during the interview.

Can this Skill be invoked automatically by the AI?▼

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

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

Avoid it for trivial changes with no architectural impact or when decisions are already finalized and documented. The interview format adds the most value for ambiguous, early-stage plans and designs.