skills.rest
dulltackle
dulltackleCOMMUNITY
Explore all skills by this author →
GitHub

grill-with-docs

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

Updated Jun 26, 2026
Search Tags:#domain modeling#adr#glossary#interview#design review#plan validation#architecture decision records
One-click install
npx skills add https://github.com/dulltackle/kangkang-skills --skill grill-with-docs-dulltackle
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/dulltackle/kangkang-skills/tree/main/grill-with-docs
Command: npx skills add https://github.com/dulltackle/kangkang-skills --skill grill-with-docs-dulltackle

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Designs and plans often contain hidden assumptions, vague terminology, and unexamined trade-offs that surface too late. This Skill stress-tests a plan through relentless questioning while capturing the outcomes as durable documentation. ## Core Features & Use Cases - Design Interrogation: Invokes a grilling workflow that challenges assumptions, edge cases, and decisions 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, run this Skill on your design proposal to expose weak points and walk away with ADRs and a shared vocabulary for the team. ## Quick Start Grill my attached design document and produce ADRs and a glossary for the decisions we settle.

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 this Skill on your design document to receive relentless probing questions about assumptions, trade-offs, and edge cases. It invokes dedicated grilling and domain-modeling skills to structure the interrogation.

How to generate ADRs from a design discussion?▼

This Skill creates Architecture Decision Records automatically as the design interview progresses. Each settled decision is captured as an ADR alongside a glossary of domain terms.

What documents does a design review produce?▼

The review produces two artifacts: Architecture Decision Records documenting key choices and their rationale, and a glossary defining the domain vocabulary used across the design.

Can I invoke this Skill automatically in a workflow?▼

No, the Skill sets disable-model-invocation to true and its agent policy disallows implicit invocation. It must be triggered explicitly by the user.

What are the limitations of automated design grilling?▼

The Skill depends on two other skills, grilling and domain-modeling, being available in the environment. It also only documents what emerges from the conversation, so unexplored topics remain undocumented.

Related Skills

Explore More Software Engineering Skills→
gjallagjalla
1

write-design-doc

Draft structured software design documents with required sections before implementation.

Official
Advanced
docs-plusdocs-plus
88

grill-with-docs

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

Official
Intermediate
merileymeriley

technical-spec-reviewing

Review technical specifications for completeness, feasibility, and production readiness.

Community
Advanced
chichexchichex
2

grill-with-domain-modeling

Conduct structured interviews to synchronize architectural decision records with domain modeling.

Community
Advanced