orc-grill

Sharpens vague feature ideas into settled decisions through structured interview rounds.

6|1|Updated Jul 4, 2026
One-click install
npx skills add https://github.com/azure-id/orc --skill orc-grill-azure-id
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: orc-grill
Source: https://github.com/azure-id/orc/tree/main/templates/skills/orc-grill
Command: npx skills add https://github.com/azure-id/orc --skill orc-grill-azure-id

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Vague feature requests like "I want notifications for merchants" cannot be planned or built directly, and asking clarifying questions during code analysis wastes expensive scan tokens. This Skill runs a dedicated pre-planning interview lane that turns one vague sentence into a written, settled idea before any code is touched. ## Core Features & Use Cases - Structured interview rounds: Builds a design tree of open questions and asks the whole ready frontier each round, with numbered questions and recommendations so answers can be given by number. - Self-service fact lookup: Resolves factual questions itself via wiki status, cached patterns, gotcha lists, and read-only recon dispatches instead of making the user recite their own codebase. - Decision tagging and persistence: Tags every settled decision as intent or constraint and writes a grill-context.md document at the project root that later lanes consume. - Multiple exits: Save the idea, hand it directly into /orc-analyze, persist constraints to the pact ledger, write it up as a document, or drop it. - Use Case: You type "something is wrong with our refunds" and, after a few rounds of questions plus automatic fact lookups, receive a grill-context.md recording what you actually want, what was ruled out, and which open questions need which instrument. ## Quick Start Ask the assistant to run /orc-grill with a one-sentence idea such as "I want notifications for merchants" and answer the numbered interview rounds until the idea is confirmed and saved.

Frequently Asked Questions about orc-grill

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

FAQPage Schema
How do I turn a vague feature idea into a clear requirement?▼

Run /orc-grill with a single sentence describing the idea. It asks rounds of numbered questions, looks up codebase facts itself, and stops only when you confirm the idea matches what you meant, then saves the result to grill-context.md.

What is the difference between orc-grill and orc-analyze?▼

orc-grill answers "what do I actually want" through conversation, while orc-analyze checks a requirement against the real code. The intended order is grill first to sharpen the idea, then analyze to verify it against the repository.

Does orc-grill write code or scan the repository?▼

No. It never writes code, never edits project files, and never runs a repo scan. It only asks questions, performs read-only fact lookups, and writes one grill-context.md document at the project root.

When should I use orc-brainstorm instead of orc-grill?▼

Use orc-brainstorm when you have no options at all and need candidates generated for you to judge. Use orc-grill when you already have one idea and need it sharpened through questions. Grill can hand off to brainstorm mid-run and return.

Where does orc-grill save the interview results?▼

It writes a single grill-context.md file under orc-grill/<slug>/ at the project root, never inside .claude/ or a run folder. Re-running with the same slug re-opens and extends the same file rather than replacing it.