MCPInstall

grill-me

Interview the user relentlessly about a plan or design until every branch of the decision tree has an explicit recorded decision and no open questions remain. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

Installs
107
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/paulrberg/agent-skills --skill grill-me
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads grill-me automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Grill Me

This skill is coordination-exempt: skip the ai-coord gate for its declared work.

Stress-test the plan in question rounds until every material branch is resolved and the user confirms shared understanding. User instructions take precedence over this skill.

Workflow

  1. Extract the current objective, constraints, assumptions, and already-made decisions. Map the design tree: each decision branches into dependent decisions. Investigate facts discoverable from the codebase, environment, or supplied evidence instead of asking the user. Put decisions to the user and wait for their answers.
  2. Maintain a running decision record with: decision, chosen option, rationale, dependencies, and consequences. Update it after every answer. Reopen a recorded decision only when new evidence conflicts with it or the user corrects it.
  3. When fact-finding benefits from delegation and subagents are available, delegate the investigation. Otherwise, investigate directly. Treat pending fact-finding as an unsettled prerequisite. Defer only dependent questions while asking the rest of the currently answerable questions.
  4. Work in rounds. The frontier contains every unresolved decision whose prerequisites are settled. Ask the entire frontier in each round. A question that depends on another open question belongs in a later round. Number each question as ### 🔥 Decision <N> — <topic>, then give Recommended, Why, Tradeoff, and Question. Separate question cards with a horizontal rule. Word each Question so "yes" accepts its Recommended choice. Wait for the user's answers before the next round.
  5. After each answer, acknowledge ✅ Recorded: <choice> — <consequence>. Recompute the frontier after each round. When useful, show settled and currently open counts. Never show a percentage because the decision tree can grow.
  6. Continue through scope, users, interfaces, data/state, failure modes, security, operations, migration, testing, rollout, ownership, and stopping criteria only where they are material to this design.
  7. When no material open branches or required investigations remain, return ### ✅ Decision record with a decision/choice/rationale/consequence table. Then give ### ⚠️ Risks, accepted unknowns with owner/resolution point, rejected alternatives that matter, and ### 🏁 Completion criteria. Ask the user to explicitly confirm that the report reflects shared understanding. Wait for that confirmation before acting on the plan. If the user corrects the report, reopen the affected branches and continue the interview.

Completion requires every material branch to have a recorded decision or an explicitly accepted unknown with an owner and resolution point, followed by the user's explicit confirmation of shared understanding. The final report alone does not complete the workflow. After confirmation, act only within the user's authorized scope.

FAQ

What does the grill-me skill do?

Interview the user relentlessly about a plan or design until every branch of the decision tree has an explicit recorded decision and no open questions remain. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".

How do I install grill-me?

Run npx skills add https://github.com/paulrberg/agent-skills --skill grill-me in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/grill-me/ (personal) or .claude/skills/grill-me/ (project).

Which AI agents can use grill-me?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is grill-me safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains grill-me?

It is published by paulrberg in paulrberg/agent-skills. It has 107 recorded installs.

More from paulrberg/agent-skills

View all →

effect-ts

paulrberg/agent-skills

Use for nontrivial Effect 4 work including services/layers, typed errors, Schema/JsonSchema, Config, runtime/concurrency, @effect/vitest, effect/ai and @effect/ai-, effect/sql and @effect/sql-, Effect Atom (@effect/atom-), or @prb/effect-next.

Data & Databases3.1K installs

tailwind-css

paulrberg/agent-skills

Use for Tailwind v4 styling: add/fix classes, configure or migrate Tailwind, use tailwind-variants, or tw-animate-css.

cli-gh

paulrberg/agent-skills

Use for GitHub CLI automation: repository reads, workflow runs, search, codespaces, releases, configuration, or gh command syntax. Use yeet for contribution writes to PRs, issues, comments, or discussions.

code-polish

paulrberg/agent-skills

Polish changed code when the user explicitly asks, or when an active workflow requests post-implementation simplification and risk-profiled review over a fixed file scope.

AI & Agents2.8K installs

yeet

paulrberg/agent-skills

Use for GitHub PR/issue/discussion workflows: create/update PRs, issues, or discussions and post issue or discussion comments; triggers include yeet.

AI & Agents2.6K installs

bump-release

paulrberg/agent-skills

Cut a release: bump versions, write changelogs, commit, tag.

AI & Agents2.4K installs

Popular code quality & workflow skills

View category →

grill-me

mattpocock/skills

A relentless interview to sharpen a plan or design.

Scan a codebase for deepening opportunities, present them as a visual HTML report, then grill through whichever one you pick.

handoff

mattpocock/skills

Compact the current conversation into a handoff document for another agent to pick up.

domain-modeling

mattpocock/skills

Build and sharpen a project's domain model. Use when discussing codebase terminology, writing or editing a GLOSSARY.md, or recording or editing an ADR.

codebase-design

mattpocock/skills

Shared vocabulary for designing deep modules. Use when the user wants to design or improve a module's interface, find deepening opportunities, decide where a seam goes, make code more testable or AI-navigable, or when another skill needs the deep-module vocabulary.

diagnosing-bugs

mattpocock/skills

Diagnosis loop for hard bugs and performance regressions. Use when the user says "diagnose"/"debug this", or reports something broken/throwing/failing/slow.