skills.rest
mst-software-vn
mst-software-vnOFFICIAL
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

Runs a structured interview session that challenges plans and generates ADRs and glossary documentation.

1|Updated Mar 2, 2026
Search Tags:#planning#domain modeling#adr#glossary#interview#design review#decision records
One-click install
npx skills add https://github.com/mst-software-vn/mst-checkscam --skill grill-with-docs-mst-software-vn
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/mst-software-vn/mst-checkscam/tree/main/.claude/skills/grill-with-docs
Command: npx skills add https://github.com/mst-software-vn/mst-checkscam --skill grill-with-docs-mst-software-vn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, vague terminology, and unexamined trade-offs that only surface during implementation. This Skill stress-tests a plan through a relentless question-and-answer interview while capturing the decisions and terminology it uncovers as durable documentation. ## Core Features & Use Cases - Relentless Interviewing: Runs a grilling session that probes a plan or design with challenging questions to expose gaps and weak assumptions. - Documentation as a Byproduct: Creates Architecture Decision Records (ADRs) and a glossary as the interview progresses, so reasoning is preserved. - Domain Modeling Integration: Delegates to the domain-modeling skill to structure the concepts and vocabulary discovered during the session. - Use Case: Before committing to a new system design, run a grilling session on your proposal; walk away with a hardened plan plus ADRs and a shared glossary for the team. ## Quick Start Ask the assistant to run a grilling session on your current plan or 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 design plan before implementation?▼

Run a grilling session on the plan, which subjects it to relentless probing questions that expose hidden assumptions and gaps. The session also produces ADRs and a glossary documenting the decisions and terminology that emerge.

What documentation does a grilling session produce?▼

A grilling session produces Architecture Decision Records (ADRs) capturing key decisions and their rationale, plus a glossary defining domain terms. These artifacts are created incrementally as the interview progresses.

How does grill-with-docs relate to domain modeling?▼

The skill delegates to the domain-modeling skill during the session, using it to structure the concepts, entities, and vocabulary uncovered by the interview. This keeps the generated glossary consistent with a formal domain model.

When should I use a grilling session instead of a normal design review?▼

Use it when a plan is still forming and you want adversarial questioning to harden it, rather than a passive review. It is most valuable before implementation begins, when changing decisions is still cheap.

Can I invoke grill-with-docs automatically in a workflow?▼

No, the skill sets disable-model-invocation to true, so it must be triggered explicitly by the user rather than invoked automatically by the model.

Related Skills

Explore More Product & Management Skills→
fcsouzafcsouza
17

game-architect

Interview users and research reference games to generate an MVP First Draft Plan.

Community
Advanced
docs-plusdocs-plus
88

grill-with-docs

Validates project plans against CONTEXT.md glossaries and ADRs to catch terminology mismatches.

Official
Intermediate
mgreenlymgreenly

ddd

Standardize domain concepts and glossary across the ikigai project.

Community
Advanced
karithamkaritham
2

grill-me

Conduct adversarial interviews that walk decision trees one question at a time.

Community
Advanced