grill-with-docs

Conduct structured interviews to refine plans and generate ADRs and glossary terms.

Updated Mar 11, 2025
One-click install
npx skills add https://github.com/MohammedSaudAlsahli/dotfiles --skill grill-with-docs-mohammedsaudalsahli
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/MohammedSaudAlsahli/dotfiles/tree/main/ai/agents-skills/grill-with-docs
Command: npx skills add https://github.com/MohammedSaudAlsahli/dotfiles --skill grill-with-docs-mohammedsaudalsahli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

The grill-with-docs skill aids in refining plans and designs through a structured interview process, simultaneously generating documentation such as ADRs (Architecture Decision Records) and glossary terms.

Core Features & Use Cases

  • Plan Sharpening: Facilitates detailed discussions to improve plans or designs.
  • Documentation Generation: Outputs ADRs and glossary entries as discussions progress.
  • Use Case: When finalizing a new feature in your software, this skill can help in shaping the architecture, and document critical decisions alongside.

Quick Start

To begin the interview process for a feature, run grill-with-docs /feature-name.

Frequently Asked Questions about grill-with-docs

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

FAQPage Schema
How do I create Architecture Decision Records while refining a project plan?▼

You can create Architecture Decision Records while refining a project plan by using a conversational interface that conducts structured interviews. This process outputs ADRs and glossary terms in real-time as your design discussion progresses.

What is an interview-based approach for project plan refinement?▼

Interview-based project plan refinement uses a conversational interface to systematically question and sharpen design specifications. It simultaneously generates structured documentation like ADRs and glossary terms during the interactive discussion process.

How do I generate ADRs and glossary terms from a design specification?▼

You generate ADRs and glossary terms from a design specification by conducting a structured interview using a conversational interface. The tool outputs documentation in real-time, capturing decisions in markdown or structured data formats.

Can I use a conversational interface to document architecture decisions in markdown?▼

Yes, you can use a conversational interface to document architecture decisions in markdown. The tool requires a text processor capable of outputting structured data formats and generates ADRs directly during the interview dialogue.

What is the best way to sharpen software feature designs before finalizing architecture?▼

The best way to sharpen software feature designs before finalizing architecture is through a structured interview process. This method facilitates detailed discussions to improve plans while simultaneously generating ADRs and glossary entries alongside the design.