skills.rest
staticaland
staticalandCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Interviews a plan or design and generates ADRs and glossary documentation.

4|Updated Jan 29, 2026
Search Tags:#architecture#documentation#domain modeling#adr#glossary#interview#design review
One-click install
npx skills add https://github.com/staticaland/skills --skill grill-with-docs-staticaland
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/staticaland/skills/tree/main/plugins/grilling/skills/grill-with-docs
Command: npx skills add https://github.com/staticaland/skills --skill grill-with-docs-staticaland

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague decisions, and undocumented terminology that surface too late. This Skill runs a relentless structured interview to stress-test a plan while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Runs a grilling session that challenges a plan or design with probing questions to expose gaps and weak assumptions. - Documentation as Output: Creates Architecture Decision Records (ADRs) and a glossary incrementally as the interview progresses. - Use Case: Before implementing a new service architecture, run a grilling session on the design proposal so every contested decision is recorded as an ADR and every domain term lands in the glossary. ## Quick Start Ask the agent to grill my current design proposal 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 design proposal with an AI interview?▼

Run a grilling session on the design document, and the skill asks relentless probing questions about assumptions and trade-offs. Each resolved decision is captured as an ADR and each domain term is added to a glossary.

What documentation does a design grilling session produce?▼

The session produces Architecture Decision Records (ADRs) for the decisions made and a glossary for domain terminology. These documents are created incrementally as the interview progresses rather than at the end.

Does grill-with-docs work on its own?▼

No, it orchestrates two other skills: the /grilling skill for the interview itself and the /domain-modeling skill for structuring the domain knowledge. Both must be available for the workflow to function.

When should I use an interview-based design review instead of a written review?▼

Use it when a plan contains untested assumptions or ambiguous terminology that a passive read-through would miss. It is less suitable for finalizing already-validated designs that only need formatting or polish.

Related Skills

Explore More Software Engineering Skills→
quaid-appquaid-app
3

architectural-proposals

Draft structured architectural proposals with problem statements, decisions, and risks.

Official
Advanced
CarbonTailsCarbonTails

grill-with-docs

Guide interactive interviews to refine design documents and generate ADRs and glossary entries.

Official
Intermediate
opensage-agentopensage-agent
113

grill-with-docs

Validate design plans against domain models and architectural decision records.

Official
Advanced
iyakiiyaki

adr-skill

Generate and organize Architecture Decision Records with MADR-compatible templates.

Community
Advanced