grill-with-docs

Refine plans and designs through interviews to produce ADRs and glossaries.

Updated Jul 3, 2026
One-click install
npx skills add https://github.com/Jmarques/orford-sur-le-lac_embarcations --skill grill-with-docs-jmarques
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/Jmarques/orford-sur-le-lac_embarcations/tree/main/.agents/skills/grill-with-docs
Command: npx skills add https://github.com/Jmarques/orford-sur-le-lac_embarcations --skill grill-with-docs-jmarques

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill conducts a thorough interview process to refine plans and designs, simultaneously creating documentation like ADRs and glossaries.

Core Features & Use Cases

  • Plan Refinement: Deep dive into the specifics of a plan or design to identify potential issues and improvements.
  • Documentation Creation: Generate documentation such as ADRs (Architecture Decision Records) and glossaries from the interview process.
  • Use Case: Use this Skill to refine the architecture of a new software project, creating ADRs to document design decisions and ensuring a comprehensive understanding of the project's structure.

Quick Start

Run a /grilling session using the /domain-modeling skill to refine your plan and create associated 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 ADRs and glossaries during software design reviews?

Generate ADRs and glossaries during software design reviews by running a rigorous interview process that refines your plan while simultaneously producing architectural decision records and domain terminology documentation.

What is the best way to refine a software architecture plan before implementation?

The best way to refine a software architecture plan is using a relentless interview process that deep dives into specifics, identifies potential issues, and creates documentation like ADRs to capture design decisions.

Can I use an interview-based approach to improve my project's documentation?

Yes, you can use an interview-based approach to improve project documentation by conducting a thorough questioning session that simultaneously refines designs and outputs structured glossaries and architectural decision records.

Do I need any specific dependencies to run a design review interview for ADR generation?

No specific dependencies are required to run a design review interview for ADR generation. The Skill operates independently using its internal scripts to conduct the interview and produce the documentation.

When should I use an interview process for plan refinement instead of standard documentation?

Use an interview process for plan refinement when you need to deeply analyze a new software project's architecture, identify potential improvements, and comprehensively document design decisions and project structure simultaneously.