grill-with-docs

Guide iterative interviews and generate ADRs and glossary documents.

80|21|Updated Dec 2, 2025
One-click install
npx skills add https://github.com/alfredoperez/speckit-companion --skill grill-with-docs-alfredoperez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/alfredoperez/speckit-companion/tree/main/examples/todo-matt-skills/.claude/skills/grill-with-docs
Command: npx skills add https://github.com/alfredoperez/speckit-companion --skill grill-with-docs-alfredoperez

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides an iterative interviewing process that enhances planning and design, while also producing accompanying documentation (e.g., ADRs and glossary entries).

Core Features & Use Cases

  • Iterative Interviews: Facilitate structured interviews to refine ideas and concepts.
  • Documentation Creation: Generate documents like ADRs and glossaries alongside the development process.
  • Use Case: Ideal for teams working on new projects or iterating on existing ones, seeking a systematic approach to ensure thorough consideration and comprehensive documentation.

Quick Start

To begin a grilling session with documentation, use the '/grilling' command, incorporating the '/domain-modeling' skill as a tool in your analysis.

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 project documentation while refining team plans?

You can generate project documentation while refining plans through an iterative, document-centric interviewing process. This approach facilitates structured dialogue to sharpen ideas and produces actionable documents like ADRs and glossary entries in parallel.

What is an iterative interviewing process for project planning?

An iterative interviewing process for project planning is a structured dialogue method that systematically refines ideas and design concepts. It ensures thorough consideration of new projects by guiding teams through cycles of questioning and documentation creation.

How do I start a grilling session to create ADRs and glossary entries?

To start a grilling session for creating ADRs and glossary entries, use the '/grilling' command. You should incorporate the '/domain-modeling' skill as a tool within your analysis to support the structured dialogue and document generation.

Can I use this structured dialogue approach for existing project iterations?

Yes, you can use this structured dialogue approach for existing project iterations. The process is ideal for teams seeking a systematic method to ensure thorough consideration and comprehensive documentation during both new and ongoing development.

Do I need structured dialogue skills to refine design through interviews?

Yes, you need structured dialogue skills to refine design through interviews. The process requires these capabilities to effectively guide the iterative interviewing and generate accompanying documentation alongside the development workflow.

What is the best way to create actionable documents during design refinement?

The best way to create actionable documents during design refinement is to run an iterative, document-centric interviewing process. This method enables teams to generate architecture decision records and glossaries in parallel with their planning discussions.