grilling

Interrogates plans and designs one question at a time to expose gaps before coding.

Updated May 5, 2026
One-click install
npx skills add https://github.com/josippapez/ai-setup --skill grilling-josippapez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: grilling
Source: https://github.com/josippapez/ai-setup/tree/main/claude/plugins/orchestrate/skills/grilling
Command: npx skills add https://github.com/josippapez/ai-setup --skill grilling-josippapez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Plans and designs often contain hidden assumptions, unresolved dependencies, and unexamined edge cases that only surface after code is written. This Skill pressure-tests a plan through relentless one-at-a-time questioning so flaws are found before implementation begins. ## Core Features & Use Cases - Sequential Interrogation: Asks exactly one question at a time, waiting for your answer before continuing, so the discussion stays focused. - Recommended Answers: Provides a recommended answer with each question, giving you a concrete position to accept or push back on. - Codebase-Grounded Questions: Explores the codebase to answer questions itself when the answer lives in existing code rather than in your head. - Use Case: Before building a new feature, say "grill the plan" and walk through every branch of the design tree—data model, error handling, dependencies—until each decision is resolved. ## Quick Start Ask the assistant to grill the plan for your next feature and answer each question one at a time until the design is fully resolved.

Frequently Asked Questions about grilling

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

FAQPage Schema
How do I stress-test a design plan before writing code?

Invoke the grilling skill with a phrase like "grill the plan" or "poke holes in this". It interviews you one question at a time, offering a recommended answer for each, until every branch of the design tree is resolved.

What triggers the grilling skill in Claude Code?

Phrases like "grill me", "grill this", "stress-test this", "challenge my assumptions", "what am I missing", or "interrogate this design" activate it. It is meant for pressure-testing plans before building.

Does the grilling skill ask multiple questions at once?

No. It deliberately asks one question at a time and waits for your feedback before continuing, because batching questions is bewildering and dilutes the interrogation.

Can the grilling skill answer questions from the codebase itself?

Yes. When a question can be answered by exploring the codebase, it investigates the code directly instead of asking you, keeping the interview focused on decisions only you can make.

When should I use grill-with-docs instead of grilling?

Use grill-with-docs when the decisions made during the interrogation should also be captured as ADRs and a glossary. Plain grilling is for pressure-testing the plan without producing documentation artifacts.