Skip to main content
affpapa.org
RU EN
skill Claude Code

grill-me · alirezarezvani — Claude Code skill: what it does, how to install

Stress-tests project plans and design docs through a disciplined question-and-answer interview to resolve decisions before coding.

Install into Claude Code · Plugin marketplace All methods and platforms ↓ 
/plugin marketplace add alirezarezvani/claude-skills
/plugin install grill-me@claude-code-skills
Open on GitHub

What grill-me does

This skill runs an in-depth interview to test a proposed plan or design. It breaks the document into branches using scripts/decision_tree_extractor.py, prepares questions with recommended answers via scripts/question_generator.py, and logs choices with scripts/grill_session_tracker.py. If a question can be answered from the codebase, the agent checks the repository first using file reads or grep.

The interview enforces strict constraints: one question at a time, depth-first branch resolution, and tracked dependencies. It also includes the cs-grill-master agent and the /cs-grill-me command. This skill is worth running before major refactors or new features when you need all architectural choices locked in early.

What it helps with

  • stress-test design documents before writing code
  • resolve decision branches depth-first without skipped dependencies
  • avoid unnecessary questions by checking the codebase first
  • log and lock in final architecture choices

Example prompts for the agent

  • grill me on this design proposal
  • /cs-grill-me docs/auth-plan.md
  • Stress-test my migration plan in plan.md

How to install grill-me

1Plugin marketplace

/plugin marketplace add alirezarezvani/claude-skills
/plugin install grill-me@claude-code-skills

This installs the whole grill-me plugin with all its skills

2Skills CLI (Vercel)

npx skills add alirezarezvani/claude-skills --skill grill-me -a claude-code

3Manually: put the files in place

~/.claude/skills/grill-me/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/grill-me/

From the same set349

The whole set →
engineering-skills Alireza Rezvani An engineering skill index for Claude Code that helps you select one specialist SKILL.md for the task at hand. It covers architecture, testing, DevOps, and data work. Claude Code 2,387installs finance-skills Alireza Rezvani Routes ambiguous finance prompts to the right bundled skill: financial-analyst, saas-metrics-coach, or month-end-close. Claude Code 2,312installs marketing-skills Alireza Rezvani A directory and router for marketing skills in Claude Code. It picks the right specialist skill for SEO, content, CRO, channels, and related tasks. Claude Code 2,264installs business-growth-skills Alireza Rezvani Routes growth and revenue prompts to the right specialized skill across customer success, sales engineering, RevOps, and proposals in Claude Code. Claude Code 2,189installs engineering-advanced-skills Alireza Rezvani An index of 37 engineering skills for architecture, automation, reliability, and platform work. Use it when a project needs task-specific engineering workflows. Claude Code 2,019installs product-skills Alireza Rezvani Product work orchestrator for Claude Code. Routes queries across 16 domain lanes and validates discovery trees with deterministic scripts. Claude Code 1,994installs pm-skills Alireza Rezvani Routes project-delivery requests across 8 PM sub-skills for Jira, Confluence, sprints, reporting, and team communication. Useful for controlled delivery work. Claude Code 1,975installs senior-backend Alireza Rezvani Scaffolds backend APIs, detects database bottlenecks, and runs load tests. Useful when designing Express routes, optimizing PostgreSQL, or preparing for production. Claude Code 1,674installs

Other versions of grill-me

grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs

Similar

ai-team-orchestration official github Bootstraps a lightweight multi-agent team inside your editor. It helps plan features, coordinate code changes, and preserve context across chat sessions. GitHub Copilot 381installs find-skills vercel-labs Discovers and installs agent skills from skills.sh directly inside your coding assistant. Handy when you need domain-specific workflows for a project. Claude Code CX Codex Cursor +1 4,000,000installs grill-me Matt Pocock grill-me interviews you about a plan or design to expose gaps and sharpen decisions. Use it before implementation starts. Claude Code 1,424,476installs grill-with-docs Matt Pocock This skill interviews you about a plan or design and creates ADRs and a glossary along the way. Use it when decisions need sharper definition. Claude Code 1,219,756installs handoff Matt Pocock Creates a handoff document from the current conversation so another agent can continue the work. Use it when a task moves to a new session or agent. Claude Code 1,038,491installs grilling Matt Pocock Stress-test a plan, decision, or idea through structured rounds of questions. Use it when you need to expose assumptions before acting. Claude Code 979,543installs teach Matt Pocock Turns the current directory into a learning workspace and keeps progress across sessions. Use it when learning needs to support a concrete goal in your project. Claude Code 862,247installs

Questions about grill-me

How do I install grill-me in Claude Code?

Run /plugin install grill-me@claude-code-skills or install it with npx skills add alirezarezvani/claude-skills --skill grill-me -a claude-code.

What does the grill-me skill do?

It interviews you about a plan one question at a time, provides recommended answers, and walks down decision branches until shared understanding is reached.

How does grill-me handle information already in the repo?

The skill searches the codebase first using tools like grep or file inspection. It only asks the developer if the answer cannot be determined from existing code.

Source text

SKILL.md · MIT 
---
name: grill-me
description: Interview the user relentlessly about a plan or design until reaching shared understanding, resolving each branch of the decision tree. Use when user wants to stress-test a plan, get grilled on their design, or mentions "grill me".
license: MIT
metadata:
  derived_from: "https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me"
  original_author: "Matt Pocock (@mattpocock)"
  original_license: MIT
  voice: "Matt Pocock — relentless, one-at-a-time, explores-codebase-first"
  version: 1.0.0
---

# Grill Me

> Derived from [Matt Pocock's grill-me](https://github.com/mattpocock/skills/tree/main/skills/productivity/grill-me) (MIT). Matt's interview discipline preserved verbatim. Additions: extraction + question + session tools + references + cs-* wrapper (see [references/companion_tooling.md](references/companion_tooling.md)).

Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.

Ask the questions one at a time.

If a question can be answered by exploring the codebase, explore the codebase instead.

## Rules (preserved + amplified)

1. **One question per turn.** Never bundle.
2. **Provide a recommended answer with each question.** Defaulting to "what do you think?" is lazy.
3. **Explore the codebase before asking.** If `grep` / `Read` resolves it, do that first. Saves a turn.
4. **Walk the tree depth-first.** Finish a branch before opening another.
5. **Track dependencies.** If decision B depends on decision A, ask A first.

## Workflow

1. User provides a plan or design (or path to one).
2. Run `scripts/decision_tree_extractor.py` to extract branches.
3. Run `scripts/question_generator.py` to produce the question list with recommendations.
4. Start a session: `scripts/grill_session_tracker.py --action start`.
5. Walk the tree, one question at a time, recording answers in the session.
6. When all branches resolved: report "shared understanding reached" + the locked-in decisions.

## Output Pattern

Per question turn:

```
Q[i]/[total]: [question]
Recommended answer: [your call + 1-sentence rationale]

(Or: I explored the codebase and found [evidence]. Confirm?)
```

## Tooling

See [references/companion_tooling.md](references/companion_tooling.md). Tools: extractor + generator + tracker. Agent: `cs-grill-master`. Command: `/cs-grill-me`.

---

**Version:** 1.0.0
**Derived:** Matt Pocock (MIT) + this repo's wrapper

© Alireza Rezvani · MIT · alirezarezvani/claude-skills

See also

Project sponsors

Companies that keep this analytics open
Gold sponsor
Nutra.Club

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor