grill-with-docs

Interview plans and designs to produce decision records and a glossary.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you pressure-test a plan or design before execution, reducing ambiguity, weak assumptions, and costly rework.

Core Features & Use Cases

  • Rigorous Discovery Interview: Challenges goals, constraints, edge cases, and hidden risks through a relentless question-driven session.
  • Documentation While You Work: Captures key decisions in ADR-style notes and builds a glossary as the discussion unfolds.
  • Use Case: Use it when you have an early product idea, technical design, or implementation approach and need to sharpen it before building.

Quick Start

Ask the Skill to run a grilling session on your plan or design and capture ADRs and a glossary as it goes.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I pressure-test a product design before implementation to reduce rework?

To pressure-test a product design, you can run a structured, relentless interview session that challenges goals, constraints, and hidden risks. This questioning workflow sharpens your early plan and reduces costly ambiguity.

What is the best way to clarify requirements for early product discovery?

The best way to clarify requirements during early product discovery is through a rigorous grilling interview. This process surfaces edge cases and weak assumptions by driving a structured, question-based exploration of your plan.

How do I document architectural decisions while running a discovery interview?

You document architectural decisions during a discovery interview by capturing ADR-style notes and building a glossary as the discussion unfolds. This ensures key choices are recorded without interrupting the guided questioning workflow.

Can I use a structured interview to challenge technical design assumptions?

Yes, you can use a structured interview to challenge technical design assumptions. A relentless grilling session specifically targets weak points in your architectural approach, exposing edge cases and validating constraints before execution.

When do I need to run a grilling session on my plan?

You need to run a grilling session when you have an early product idea, technical design, or implementation approach ready. It is used right before execution to sharpen the plan and eliminate hidden risks through rigorous questioning.