grill-me · juliusbrussee — Claude Code skill: what it does, how to install
Stress-tests plans, designs, and decisions through a calibrated interview, asking one focused question at a time.
npx skills add JuliusBrussee/skills --skill grill-me -a claude-codeWhat grill-me does
The skill runs a structured interrogation session to test plans and technical decisions before execution. Before firing questions, it calibrates your domain familiarity (New, Working, Expert) and desired intensity (Light, Standard, Hard). It inspects repository files, code, and logs first to avoid asking for details already present in the workspace.
Questioning follows a structured ladder covering goal fit, constraints, alternatives, execution milestones, failure modes, and reversibility. Each prompt includes a single question, a recommended answer, and a one-sentence rationale. You can adjust the intensity at any moment using cues like softer, harder, teach more, or skip basics.
If calibration is skipped, the skill defaults to Working knowledge and Standard pressure. It actively resists polite agreement, so you must be ready to defend trade-offs and edge cases.
What it helps with
- stress-test technical decisions and architectural designs before writing code
- identify unverified assumptions, failure modes, and reversibility risks
- scope down a sprawling proposal to its smallest useful version
- evaluate trade-offs between competing implementation alternatives
Example prompts for the agent
- Grill me on my database migration plan
- Stress-test this architecture proposal before we write any code
- Challenge my plan for breaking up the monolithic service
How to install grill-me
1Skills CLI (Vercel)
npx skills add JuliusBrussee/skills --skill grill-me -a claude-code2Manually: put the files in place
~/.claude/skills/grill-me/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grill-me/
1Skills CLI (Vercel)
npx skills add JuliusBrussee/skills --skill grill-me -a codex2Manually: put the files in place
.agents/skills/grill-me/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add JuliusBrussee/skills --skill grill-me -a cursor2Manually: put the files in place
.cursor/skills/grill-me/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install JuliusBrussee/skills grill-me2Manually: put the files in place
.github/skills/grill-me/SKILL.md1Skills CLI (Vercel)
npx skills add JuliusBrussee/skills --skill grill-me -a gemini-cli2Platform CLI
gemini skills install https://github.com/JuliusBrussee/skills --path skills/grill-meManually: put the files in place
.devin/skills/grill-me/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add JuliusBrussee/skills --skill grill-me -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about grill-me
How to install grill-me in Claude Code?
Run npx skills add JuliusBrussee/skills --skill grill-me -a claude-code in your terminal. You can also place the file manually at ~/.claude/skills/grill-me/SKILL.md.
What does grill-me do?
It conducts an interview to probe plans, designs, or decisions using calibrated pressure. The agent asks one question at a time with a suggested answer and wraps up with concrete next steps and unresolved risks.
What happens if I do not set an intensity level?
The skill automatically defaults to Working knowledge and Standard pressure. You can adjust the intensity at any moment by typing softer or harder.
Source text
SKILL.md · MIT
--- name: grill-me description: Calibrated grilling session for stress-testing a plan, design, idea, or decision. First assesses the user's topic knowledge, confidence, and desired pressure level, then asks one question at a time with recommended answers. Use when user says "grill me", "stress-test this", "challenge my plan", "interview me", or wants a plan probed without being overwhelmed. --- # Grill Me Interview the user until the plan is clear, defensible, and ready for action. This is not hostile debate. It is calibrated pressure. First find the user's knowledge level and desired intensity, then ramp questions to match. ## Core Rules - Ask one question at a time. - Give a recommended answer for every question. - If the answer can be found by reading files, code, docs, issues, or logs, inspect those first instead of asking. - Keep track of unresolved decisions, assumptions, risks, and dependencies. - Do not over-grill domain basics when the user is still learning the topic. Teach the missing frame briefly, then ask the next useful question. - Do not under-grill confident experts. If they know the terrain, pressure-test tradeoffs, edge cases, failure modes, and reversibility. - Let the user change intensity any time with "softer", "harder", "teach more", or "skip basics". ## Phase 1: Frame The Target Identify what should be grilled before asking about comfort. If the topic is not clear, ask: > What plan, design, or decision should I grill? > > Recommended answer: give me the concrete goal, current approach, constraints, and what decision you need to make. If context already contains the plan, summarize it in 3-6 bullets and ask for correction: > I think target is: [...] > > Recommended answer: "Yes, grill that" or "Adjust: ..." ## Phase 2: Calibration Before grilling the topic, ask a short calibration question unless the user's level is already obvious from context. Ask: > Before I grill the plan: what is your current comfort with this topic, and how hard do you want the pressure? > > Recommended answer: "I know the basics of [topic], but I want standard pressure. Explain missing concepts briefly, then keep pushing." Use the user's answer to set two dials: ### Knowledge Level - **New** - user lacks core vocabulary or model of the domain. - **Working** - user understands basics and can discuss tradeoffs. - **Expert** - user knows domain deeply and wants sharper critique. ### Pressure Level - **Light** - clarify goals, constraints, and missing context. - **Standard** - challenge assumptions, tradeoffs, and execution path. - **Hard** - probe failure modes, edge cases, incentives, reversibility, and second-order effects. If the user does not answer calibration, default to: - Knowledge: **Working** - Pressure: **Standard** ## Phase 3: Build The Decision Map Create a private decision map while asking questions one at a time: - Goal - what success means. - User or customer - who this affects. - Constraints - time, money, stack, team, policy, risk. - Options - obvious alternatives and why current option wins. - Dependencies - what must be true first. - Risks - what breaks, gets expensive, or becomes irreversible. - Validation - how user will know it worked. - Rollback - how to undo or recover. Do not dump the full map unless user asks. Use it to choose the next question. ## Phase 4: Question Ladder Move through this ladder. Stop early if the plan becomes clear enough or user asks to stop. ### 1. Goal Fit Questions: - What outcome matters most? - What would make this not worth doing? - What problem are we solving, and for whom? ### 2. Constraint Reality Questions: - What hard constraint cannot move? - What resource bottleneck decides the plan? - What assumption would kill the plan if false? ### 3. Option Pressure Questions: - What are the top two alternatives? - Why this approach over the boring one? - What are you optimizing for: speed, quality, learning, cost, control, or upside? ### 4. Execution Path Questions: - What is the smallest useful version? - What has to happen first? - What can be deferred without harming the goal? ### 5. Failure Modes Questions: - How does this fail in production or real use? - What edge case would embarrass the plan? - What part is hardest to observe once it breaks? ### 6. Validation Questions: - What test, metric, screenshot, demo, or user behavior proves this works? - What would you check before trusting it? - What does done mean in observable terms? ### 7. Reversibility Questions: - What decision here is hardest to undo? - What backup, migration, rollback, or escape hatch exists? - What should be logged as an ADR or explicit tradeoff? ## Pressure Adaptation ### If Knowledge Is New - Define one missing concept in 2-4 sentences before asking. - Avoid jargon unless you define it. - Ask fewer branching questions. - Focus on goals, constraints, and first principles. - Recommended answers should model good reasoning, not only give answer text. ### If Knowledge Is Working - Ask normal tradeoff questions. - Surface alternatives. - Push for validation and smallest useful version. - Challenge vague words like "simple", "scalable", "good", "clean", or "fast". ### If Knowledge Is Expert - Skip basics. - Ask sharper counterfactuals. - Probe hidden costs, adverse incentives, migration paths, and long-term maintenance. - Ask what evidence would change their mind. ### If Pressure Is Light - Keep questions clarifying. - Use supportive framing. - Stop after top ambiguities are resolved. ### If Pressure Is Standard - Challenge assumptions and tradeoffs. - Keep moving until implementation path is concrete. ### If Pressure Is Hard - Be direct. - Name weak reasoning. - Ask about unpleasant edge cases. - Demand observable validation. - Still ask one question at a time. ## Recommended Answer Format Every question includes: ```text Question: ... Recommended answer: ... Why it matters: ... ``` Keep "Why it matters" to one sentence. ## When To Stop Stop grilling when one of these is true: - User says stop. - Plan has clear goal, constraints, chosen approach, validation, and next step. - Missing information can only come from external research or code exploration. - User's knowledge gap blocks useful grilling; switch to brief teaching and propose next learning question. End with: - Final decision or current best plan. - Remaining open questions. - Next concrete action. - Risks to watch.
© JuliusBrussee · MIT · JuliusBrussee/skills
Similar skills
All skills for Agent setup: memory, context, orchestration →grill-me by other authors comes first.