grill-with-docs

Facilitate structured design reviews while generating ADRs and glossary terms.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The 'grill-with-docs' skill helps to refine a plan or design while simultaneously generating documentation, such as Architecture Decision Records (ADR) and glossary terms.

Core Features & Use Cases

  • Design Refinement: Engage in an interview process to challenge and enhance the plan or design.
  • Documentation Creation: Automatically create ADRs and glossary terms during the design review process.
  • Use Case: When working on a complex project, this skill can be used to systematically analyze the architecture, ensuring clarity and comprehensiveness of documentation.

Quick Start

Run a /grilling session to initiate a design grilling session and start generating documentation.

Frequently Asked Questions about grill-with-docs

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate Architecture Decision Records during a design review?▼

You can generate Architecture Decision Records by running a structured design review session, which automatically creates ADRs and glossary terms while challenging and enhancing your plan.

What is the best way to refine an architecture plan while creating documentation?▼

The best way to refine an architecture plan while creating documentation is to use an iterative interview process that systematically analyzes the design and outputs glossary terms and ADRs.

Can I use a design grilling session for iterative project lifecycle management?▼

Yes, you can use a design grilling session for iterative project lifecycle management to systematically analyze architecture, improve design clarity, and produce comprehensive documentation.

Do I need any specific dependencies to start a design grilling session?▼

No, you do not need any specific dependencies to start a design grilling session, as the skill operates independently to facilitate structured design reviews and automated documentation generation.

How does structured documentation improve architecture planning?▼

Structured documentation improves architecture planning by engaging you in an interview process that challenges your design, ensuring clarity and comprehensiveness through automatically generated ADRs and glossary terms.

When do I need an Architecture Decision Record for my design process?▼

You need an Architecture Decision Record for your design process when working on complex projects that require systematic architecture analysis, ensuring clarity and comprehensiveness of your project documentation.