skills.rest
CYRUS-pinto
CYRUS-pintoCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

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

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague terms, and unrecorded decisions. This Skill stress-tests a plan through relentless questioning while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Runs a structured grilling interview that challenges assumptions and exposes gaps 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, have the design grilled so every contested decision is recorded as an ADR and every domain term is defined in a shared glossary. ## 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 that challenges each assumption and design choice in the plan. This Skill coordinates that interview and records the outcomes as ADRs and a glossary.

How to generate ADRs from a design discussion?▼

The Skill captures decisions surfaced during the grilling interview and writes them as Architecture Decision Records. Each contested choice becomes a documented ADR with its rationale.

What is a domain glossary in software design?▼

A domain glossary defines the key terms and concepts used in a system so all stakeholders share the same vocabulary. This Skill builds one automatically as terms come up during the interview.

Can this Skill be invoked automatically by the AI?▼

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

When should I not use a design grilling interview?▼

Avoid it for trivial changes or well-understood tasks where questioning adds no value. It is best suited to novel designs with significant ambiguity or architectural risk.

Related Skills

Explore More Software Engineering Skills→
gjallagjalla
1

write-design-doc

Draft structured software design documents with required sections before implementation.

Official
Advanced
DawnMoon1542DawnMoon1542
7

writing-plans

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

Community
Advanced
wesleyegbertowesleyegberto
3

domain-driven-design

Align software models with business domains using ubiquitous language and bounded contexts.

Community
Advanced
Lev-itLev-it

grill-me

Review plans or designs through a structured series of targeted questions.

Official
Intermediate