skills.rest
silentFellow
silentFellowCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

grill-with-docs

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

1|Updated Sep 13, 2026
Search Tags:#planning#domain modeling#adr#glossary#interview#design review#architecture decision records
One-click install
npx skills add https://github.com/silentFellow/public-dotfiles --skill grill-with-docs-silentfellow
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/silentFellow/public-dotfiles/tree/main/agents/skills/grill-with-docs
Command: npx skills add https://github.com/silentFellow/public-dotfiles --skill grill-with-docs-silentfellow

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 runs a relentless structured interview to stress-test a plan or design 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 as a Byproduct: Produces Architecture Decision Records (ADRs) and a domain glossary during the interview via a domain-modeling workflow. - 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 design document for the new billing service 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 software design before implementation?▼

Run a structured grilling interview on the design that challenges assumptions, edge cases, and trade-offs. This Skill orchestrates that interview and records the outcomes as ADRs and a glossary.

How to generate ADRs from a design discussion?▼

Invoke this Skill on your plan or design; it combines a grilling workflow with domain modeling so Architecture Decision Records and a glossary are written as the interview progresses.

What documents does a design review interview produce?▼

This workflow produces Architecture Decision Records capturing key decisions and a glossary defining domain terms, both generated incrementally during the interrogation of the plan.

Can this Skill be invoked automatically by the AI?▼

No. The Skill sets disable-model-invocation and its policy disallows implicit invocation, so it only runs when explicitly requested by the user.

When should I not use a design grilling workflow?▼

Avoid it for trivial changes or fully settled designs where no open decisions remain. It adds the most value on early-stage plans with unresolved assumptions worth documenting.

Related Skills

Explore More Software Engineering Skills→
baloisebaloise
111

ds-plan

Interview users and generate phased implementation plans for Helvetia Design System components.

Official
Advanced
EpiphyticEpiphytic
7

writing-plans

Create implementation plans from software requirements with structured task breakdowns.

Official
Intermediate
kevinnftkevinnft
13

ubiquitous-language

Extract domain terminology from conversations into a structured glossary file.

Community
Intermediate
dwoolworthdwoolworth
1

Human Communication

Route human communications to Meeting Board, Discord, and Slack via webhooks.

Community
Advanced