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.