grill-with-docs

Conduct structured interviews to refine plans and generate ADRs and glossaries.

1|Updated May 14, 2026
One-click install
npx skills add https://github.com/MarcoAntolini/cursor-sync --skill grill-with-docs-marcoantolini
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grill-with-docs
Source: https://github.com/MarcoAntolini/cursor-sync/tree/main/agents/skills/grill-with-docs
Command: npx skills add https://github.com/MarcoAntolini/cursor-sync --skill grill-with-docs-marcoantolini

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill provides a structured interview process to refine plans and designs, ensuring clarity and completeness while simultaneously generating documentation in the form of ADRs (Architecture Decision Records) and glossaries.

Core Features & Use Cases

  • Interview Process: Conducts in-depth interviews to explore and clarify the intent behind plans and designs.
  • Documentation Generation: Automatically creates ADRs and glossaries based on the interview content.
  • Use Case: Ideal for teams working on complex projects where documentation is crucial but time-consuming to create manually.

Quick Start

Run a /grilling session with the /domain-modeling skill to initiate the process.

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 planning a project?

Architecture Decision Records are generated automatically by conducting a structured interview to refine plans, capturing design intent and decisions as you explore project requirements.

What is the best way to document a design review without interrupting the workflow?

Documenting a design review is handled in-workflow by conducting an in-depth interview that clarifies intent and simultaneously outputs ADRs and glossaries, eliminating manual documentation overhead.

How do I build a project glossary during the design phase?

A project glossary is built during the design phase by running a structured grilling session that explores definitions and domain terms, automatically compiling them into a reference document.

Can I use a structured interview to refine complex project plans?

Yes, a structured interview is the core mechanism for refining complex project plans, ensuring clarity and completeness by relentlessly exploring the intent behind your designs.

Does this approach require any specific dependencies or tools to start?

No specific dependencies are required to start; you simply run a grilling session, optionally pairing with a domain-modeling skill to initiate the interview and documentation process.