grilling · trailofbits — Claude Code skill: what it does, how to install
The grilling skill questions a plan or design one decision at a time, surfacing unresolved choices and dependencies. Use it before implementation when the details still need agreement.
MIT ★ 540 updated 2026-07-14
/plugin marketplace add trailofbits/skills-curated
/plugin install productivity@skills-curatedWhat grilling does
grilling walks through a plan, design, or idea by tracing its decision branches. It asks one question at a time and recommends an answer for each. When a fact can be checked in the project environment, it looks for it instead of asking the user.
The skill waits for the user to confirm a shared understanding before acting on the plan. That makes it a poor fit for open-ended brainstorming, which needs divergent options, or for work that is already decided and ready to execute. A simple factual question is better answered directly.
What it helps with
- surface unresolved choices in a feature request
- trace dependencies between decisions in a plan
- challenge a design before implementation
- check project facts before asking the user
Example prompts for the agent
- Question me about this feature plan one decision at a time, and recommend an answer for each.
- Review this design for unresolved choices before I start implementing it.
- Walk through the dependencies in my plan, then wait until we agree before taking action.
How to install grilling
1Plugin marketplace
/plugin marketplace add trailofbits/skills-curated/plugin install productivity@skills-curatedThis installs the whole productivity plugin with all its skills
2Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill grilling -a claude-code3Manually: put the files in place
~/.claude/skills/grilling/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/grilling/
1Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill grilling -a codex2Manually: put the files in place
.agents/skills/grilling/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill grilling -a cursor2Manually: put the files in place
.cursor/skills/grilling/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install trailofbits/skills-curated plugins/productivity/skills/grilling2Manually: put the files in place
.github/skills/grilling/SKILL.md1Skills CLI (Vercel)
npx skills add trailofbits/skills-curated --skill grilling -a gemini-cli2Platform CLI
gemini skills install https://github.com/trailofbits/skills-curated --path plugins/productivity/skills/grillingManually: put the files in place
.devin/skills/grilling/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.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 grilling
How do I install grilling in Claude Code?
Add the marketplace with /plugin marketplace add trailofbits/skills-curated, then install the plugin with /plugin install productivity@skills-curated.
What does the grilling skill do?
It interviews the user about a plan, design, or decision, asking one question at a time and suggesting an answer. It waits for confirmation before acting on the plan.
Can I use grilling for brainstorming?
It is designed to converge on decisions, not produce divergent options. It also adds friction when the user has already decided and wants execution.
Source text
SKILL.md · MIT
--- name: grilling description: >- Interviews the user relentlessly about a plan, decision, or idea until every branch of the decision tree is resolved. Use when the user wants to stress-test their thinking, sharpen a plan or design before acting, or uses any 'grill' trigger phrase (e.g. "grill me on this"). allowed-tools: - Read - Grep - Glob - AskUserQuestion --- # Grilling Interview the user relentlessly about every aspect of the plan, decision, or idea until you reach a shared understanding. Walk down each branch of the decision tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer. Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering. If a *fact* can be found by exploring the environment (filesystem, tools, etc.), look it up rather than asking. The *decisions*, though, are the user's — put each one to them and wait for their answer. Do not act on the plan until the user confirms a shared understanding has been reached. ## When to Use - The user wants to stress-test a plan, design, or decision before committing to it - A feature request or design has unresolved ambiguities that should be surfaced and decided before implementation - The user explicitly asks to be grilled, interviewed, or challenged on their thinking ## When NOT to Use - The user has already made their decisions and wants execution — grilling after the fact is friction, not rigor - The user is brainstorming and needs divergent options generated; grilling converges on decisions rather than generating alternatives - The question is a simple factual one that exploration or a direct answer resolves
© Matt Pocock · MIT · trailofbits/skills-curated
Similar skills
All skills for Notes, tasks and projects →grilling by other authors comes first.