grill-with-docs

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

2|Updated Jun 21, 2026
One-click install
npx skills add https://github.com/IsKenKenYa/skills --skill grill-with-docs-iskenkenya
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/IsKenKenYa/skills/tree/main/skills/engineering/grill-with-docs
Command: npx skills add https://github.com/IsKenKenYa/skills --skill grill-with-docs-iskenkenya

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions and vague terminology that only surface during implementation. This Skill stress-tests a plan or design through a rigorous question-and-answer interview and captures the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Runs a relentless grilling session that challenges assumptions, edge cases, and trade-offs in your plan or design. - Automatic Documentation: Produces Architecture Decision Records (ADRs) and a project glossary as a byproduct of the interview, by delegating to the domain-modeling workflow. - Use Case: Before implementing a new module, invoke this Skill to have your design challenged question by question, ending with a written ADR and shared vocabulary the whole team can reference. ## Quick Start Ask the agent to grill my current design proposal and write up the resulting ADR and 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?▼

Invoke this Skill to run a grilling interview that challenges your design's assumptions, edge cases, and trade-offs one question at a time. The session ends with documented decisions rather than just verbal feedback.

What documentation does a design grilling session produce?▼

The session produces Architecture Decision Records (ADRs) capturing key decisions and a glossary defining shared project terminology. These artifacts are generated through the domain-modeling workflow as the interview progresses.

Can this Skill be triggered automatically by the AI?▼

No, it is marked as user-invoked only with disable-model-invocation set to true. You must trigger it explicitly, typically via a slash command, when you want a design reviewed.

When should I use a design grilling interview instead of a code review?▼

Use it before implementation, when a plan or design exists but code does not. Code review examines finished changes against standards, while grilling challenges the design decisions themselves before they become expensive to change.