grill-with-docs

Generates architectural decision records and glossaries from structured team interviews.

Updated Jun 12, 2026

Search Tags:#project planning #interview #documentation generation #design refinement #decision recording

Ready to run

npx skills add https://github.com/flowel/AiSkills --skill grill-with-docs-flowel

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/flowel/AiSkills/tree/main/skills/codex/grill-with-docs
Command: npx skills add https://github.com/flowel/AiSkills --skill grill-with-docs-flowel

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill facilitates the process of refining plans and designs through structured interviews, simultaneously generating documentation (like ADRs and glossary entries) to capture insights and decisions.

Core Features & Use Cases

Interview-Based Refinement: Engage in a grilling session to explore and improve the details of a plan or design.
Documentation Generation: Automatically produce ADRs (Architectural Decision Records) and glossaries from the interview.
Use Case: Ideal for project teams to discuss and document the rationale behind architectural decisions, ensuring a clear and comprehensive knowledge base.

Quick Start

Start a grilling session with the /grilling command using the /domain-modeling skill to refine your project plan.

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 architectural decision records through a structured interview?▼

You can generate architectural decision records by participating in a structured grilling session that interactively questions your design, automatically producing ADRs to document the rationale behind your project decisions.

What is the best way to document project planning decisions and create a glossary?▼

Documenting project planning decisions is best achieved through interview-based refinement, which interactively explores your design while automatically generating a comprehensive glossary and decision records for your team's knowledge base.

How do I refine a project plan using an interactive dialogue?▼

Refining a project plan using interactive dialogue involves starting a grilling session with the /grilling command, which questions your design assumptions and captures the refined details into formal documentation.

Does interview-based design refinement work for documenting architectural decisions?▼

Yes, interview-based design refinement works for documenting architectural decisions by facilitating structured discussions that explore plan details and automatically outputting ADRs to capture the insights gained during the interactive dialogue.

Can I use a structured interview to improve my software design and build a knowledge base?▼

Yes, you can use a structured interview to improve software design and build a knowledge base, as the grilling session refines your plans while simultaneously generating glossaries and decision records for comprehensive project documentation.