pavilio-grill

Interviews users one question at a time to harden ideas into OpenSpec change artifacts.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/gmotyl/pavilio --skill pavilio-grill-gmotyl
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: pavilio-grill
Source: https://github.com/gmotyl/pavilio/tree/main/skills/pavilio-grill
Command: npx skills add https://github.com/gmotyl/pavilio --skill pavilio-grill-gmotyl

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It prevents premature or vague implementation by stress-testing a raw idea or existing plan through a structured interview before any code is written, producing a complete, reviewable design contract. ## Core Features & Use Cases - Grill-forward interview: Asks one question per message with a recommended answer, challenges fuzzy terminology against the project glossary (CONTEXT.md), and cross-references the codebase instead of asking what code can answer. - OpenSpec change artifacts: Writes proposal.md, design.md (with mermaid diagrams), delta specs with WHEN/THEN scenarios, and tasks.md into an openspec/changes/<change-id>/ directory, committed to git. - Inline domain docs: Updates CONTEXT.md glossaries and offers ADRs (only when decisions are hard to reverse, surprising, and real trade-offs) as decisions crystallize. - Use Case: Before building a new billing feature, run the grill to resolve domain terms like Invoice vs Bill, present a design for approval, and end with a committed change dir ready for plan execution. ## Quick Start Invoke /pavilio-grill with your feature idea or draft plan and answer the interview questions until the design is approved and the change artifacts are written.

Frequently Asked Questions about pavilio-grill

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

FAQPage Schema
How do I validate a feature design before writing code?▼

Run /pavilio-grill with your idea or draft plan. It interviews you one question at a time with recommended answers, cross-references the codebase, and produces an approved design before any implementation code is written.

What artifacts does a design review produce with OpenSpec?▼

The skill writes four committed artifacts into openspec/changes/<change-id>/: proposal.md, design.md with mermaid diagrams, delta specs per capability with WHEN/THEN scenarios, and tasks.md generated by the pavilio-writing-plans skill.

Can pavilio-grill write implementation code during the interview?▼

No. A hard gate prohibits writing or editing implementation code until a design is presented and the user approves it. The only exception is pavilio-writing-plans, which writes markdown tasks, not code.

When should an architecture decision record be created?▼

An ADR is offered only when all three conditions hold: the decision is hard to reverse, surprising without context, and the result of a real trade-off. ADRs are stored in projects/<project>/adr/ with sequential numbering.

Does the skill handle multi-repository changes?▼

Yes. A coordinated multi-repository change reuses one shared change-id across each repository's independently resolved OpenSpec backend, and the panel's Plans tab groups these change directories together.