If .claude/skills/grill-me/SKILL.md.disabled exists, stop before reading a fallback.
Project configuration: If the current project contains .claude/skills/grill-me/SKILL.md, read and apply it instead of this bundled default. The project copy is the capability source of truth.
Repository context: Read ../setup/references/task-context.md when resolving a task, project commands, named agent roles, or legacy .claude/ resource paths. Use repository evidence and applicable project instructions; a missing local workflow copy does not require setup. Resolve bundled resources from the installed skill, never from the target cwd.
Grill Me
Pressure-test a plan or design until the remaining ambiguity is explicit, bounded, and easy to communicate.
For task work, resolve the reviewed artifact with
../setup/references/task-context.md. Read the linked
entrypoint and relevant sections only; return the compact decision summary to the caller, which
owns any durable task update.
Core Behavior
- First, enumerate every candidate risk you can see across all categories
below (scope, states/flows, assumptions, wording, decision branches) — keep
this internal list so nothing drops silently. A later step filters to what
is worth asking.
- Then surface one focused question at a time, ordered by what most changes
the feature shape if answered wrong — the user must be able to answer
without re-reading the whole thread; batched questions get half-answered
or ignored.
- For each question, provide your recommended answer or default position.
- If a question can be answered from the codebase or docs, explore there
instead of asking the user.
- Prefer exposing hidden assumptions over inventing extra scope — the goal
is to sharpen an existing plan, not to bolt on new features under the
guise of stress-testing.
Adversarial Discipline
- When you offer a recommended answer, first spend one beat trying to disprove it. Confirmation is the failure mode — a default you only defended is weaker than one you tried to break.
- Bound the loop. If two consecutive rounds surface only minor or already-considered points, stop and report — continuing is grill theater (motion without new information), not rigor.
- For a high-stakes or irreversible decision, offer the user a fresh-context adversarial check: a subagent prompted to find what's wrong, given the artifact and its constraints — not your preferred answer. Handing over your conclusion biases the reviewer toward agreement. Never invoke an external CLI for this without explicit user authorization.
When Invoked From Discovery
Scan every section of the discovery document (scope, flows, states,
constraints, out-of-scope, open questions, risks) — not only the first
section or headline. Then prioritize:
- Unclear scope boundaries
- Missing states, flows, or edge cases
- Hidden assumptions
- Ambiguous wording a new reader could misinterpret
- Decision branches that materially change the feature shape
Avoid:
- Deep implementation detail unless it changes scope, user experience, risk, or constraints
- Speculative product expansion that should instead be captured as out of scope
Stop Condition
Stop when:
- The main branches of the decision tree are resolved or explicitly cut
- The remaining ambiguity is minor and non-blocking
- The caller can clearly document flow, scope, constraints, and risks
Return To Caller
When the stop condition is met, finish by returning this compact summary
(so the caller — typically /nf or /ct — can paste it into the doc
without editing):
- Clarifications made
- Scope cuts or out-of-scope decisions
- Hidden assumptions uncovered
- Wording fixes or ambiguity reductions
- Remaining risks or blockers
Return this summary after the stop condition is met. Keep the review read-only unless the
caller explicitly authorizes editing the reviewed artifact; a recommendation or a completed
question round is not itself permission to change the plan.
1---2name: grill-me-43description: Use when a plan, design, or discovery document needs stress-testing for hidden assumptions, scope gaps, unresolved branches, or ambiguous wording; also when the user explicitly says "grill me".4---56<!-- claudops-build: project-config-pointer -->7> If `.claude/skills/grill-me/SKILL.md.disabled` exists, stop before reading a fallback.8> **Project configuration:** If the current project contains `.claude/skills/grill-me/SKILL.md`, read and apply it instead of this bundled default. The project copy is the capability source of truth.9> **Repository context:** Read `../setup/references/task-context.md` when resolving a task, project commands, named agent roles, or legacy `.claude/` resource paths. Use repository evidence and applicable project instructions; a missing local workflow copy does not require setup. Resolve bundled resources from the installed skill, never from the target cwd.1011# Grill Me1213Pressure-test a plan or design until the remaining ambiguity is explicit, bounded, and easy to communicate.1415For task work, resolve the reviewed artifact with16[`../setup/references/task-context.md`](../setup/references/task-context.md). Read the linked17entrypoint and relevant sections only; return the compact decision summary to the caller, which18owns any durable task update.1920## Core Behavior2122- First, enumerate every candidate risk you can see across all categories23 below (scope, states/flows, assumptions, wording, decision branches) — keep24 this internal list so nothing drops silently. A later step filters to what25 is worth asking.26- Then surface one focused question at a time, ordered by what most changes27 the feature shape if answered wrong — the user must be able to answer28 without re-reading the whole thread; batched questions get half-answered29 or ignored.30- For each question, provide your recommended answer or default position.31- If a question can be answered from the codebase or docs, explore there32 instead of asking the user.33- Prefer exposing hidden assumptions over inventing extra scope — the goal34 is to sharpen an existing plan, not to bolt on new features under the35 guise of stress-testing.3637## Adversarial Discipline3839- When you offer a recommended answer, first spend one beat trying to **disprove** it. Confirmation is the failure mode — a default you only defended is weaker than one you tried to break.40- **Bound the loop.** If two consecutive rounds surface only minor or already-considered points, stop and report — continuing is grill theater (motion without new information), not rigor.41- For a high-stakes or irreversible decision, offer the user a **fresh-context adversarial check**: a subagent prompted to *find what's wrong*, given the artifact and its constraints — **not** your preferred answer. Handing over your conclusion biases the reviewer toward agreement. Never invoke an external CLI for this without explicit user authorization.4243## When Invoked From Discovery4445Scan every section of the discovery document (scope, flows, states,46constraints, out-of-scope, open questions, risks) — not only the first47section or headline. Then prioritize:4849- Unclear scope boundaries50- Missing states, flows, or edge cases51- Hidden assumptions52- Ambiguous wording a new reader could misinterpret53- Decision branches that materially change the feature shape5455Avoid:56- Deep implementation detail unless it changes scope, user experience, risk, or constraints57- Speculative product expansion that should instead be captured as out of scope5859## Stop Condition6061Stop when:62- The main branches of the decision tree are resolved or explicitly cut63- The remaining ambiguity is minor and non-blocking64- The caller can clearly document flow, scope, constraints, and risks6566## Return To Caller6768When the stop condition is met, finish by returning this compact summary69(so the caller — typically `/nf` or `/ct` — can paste it into the doc70without editing):7172- Clarifications made73- Scope cuts or out-of-scope decisions74- Hidden assumptions uncovered75- Wording fixes or ambiguity reductions76- Remaining risks or blockers7778Return this summary after the stop condition is met. Keep the review read-only unless the79caller explicitly authorizes editing the reviewed artifact; a recommendation or a completed80question round is not itself permission to change the plan.