grill-with-docs

Runs a structured design interview that produces ADRs and a glossary.

Updated Aug 2, 2026
One-click install
npx skills add https://github.com/mikalv/pi-extensions --skill grill-with-docs-mikalv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/mikalv/pi-extensions/tree/main/packages/pi-atelier/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/mikalv/pi-extensions --skill grill-with-docs-mikalv

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions and unresolved decisions. This Skill stress-tests a plan through a relentless question-and-answer session while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Grilling: Runs a /grilling interview session that challenges a plan or design with probing questions. - Documentation as Output: Creates Architecture Decision Records (ADRs) and a glossary as the session progresses. - Domain Modeling Integration: Uses the /domain-modeling skill to structure the discussion around domain concepts. - Use Case: Before implementing a new feature, run a grilling session on your design proposal to surface weak points and automatically record each decision and term definition. ## Quick Start Ask the agent to grill my current design plan and document the decisions as 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 that interviews you about your plan with relentless questions. Weak assumptions and unresolved decisions surface through the questioning, and each resolved point is captured as documentation.

How to generate ADRs from a design discussion?▼

The skill creates Architecture Decision Records as the interview progresses, so each decision reached during the grilling session is written down immediately rather than reconstructed afterward.

What documents does a design grilling session produce?▼

It produces Architecture Decision Records (ADRs) and a glossary of domain terms. These artifacts are created incrementally during the session as decisions are made and terminology is clarified.

Does this skill work with domain modeling?▼

Yes, the grilling session explicitly uses the domain-modeling skill to structure the discussion. This grounds the interview questions in domain concepts and helps build the glossary.

When should I not use a design grilling session?▼

Avoid it for trivial changes or well-understood tasks where no significant decisions exist. The interview format adds the most value when a plan contains untested assumptions or ambiguous terminology.