New to Claude Skills? Learn how to install them →

Get Claude Skills
Galirezarezvani on GitHub

Grill Me

Free

Stress-test your plans through relentless questioning.

by alirezarezvani24.3k stars on alirezarezvani/claude-skills
4 views
Updated Jul 17, 2026
Get this skill

Free · Opens the source repo

What Grill Me does

Grill Me is a Python-based skill designed to facilitate in-depth discussions about plans or designs, ensuring that all aspects are thoroughly explored until a shared understanding is achieved. This skill is particularly useful for developers and designers who want to rigorously evaluate their ideas or projects by systematically addressing each decision point in their design tree. By employing a structured interview approach, Grill Me helps users uncover dependencies and make informed decisions based on a comprehensive analysis of their plans.

The workflow begins when the user presents a plan or design. The skill utilizes a decision tree extractor to identify branches of decisions that need to be made. It then generates a series of targeted questions, asking one at a time, and providing recommended answers to guide the user through the decision-making process. This methodical approach not only aids in clarifying thoughts but also helps in documenting the conversation, ensuring that all insights are captured for future reference.

Grill Me is ideal for anyone looking to validate their ideas through a critical lens, whether they are working on software development, product design, or any other project that requires careful consideration of multiple factors. By following the rules of engagement, such as exploring the codebase before asking questions and tracking dependencies, users can maximize the effectiveness of their sessions and arrive at well-founded conclusions.

This skill is derived from Matt Pocock's original grill-me concept, with added functionalities that enhance its usability. The combination of extraction, question generation, and session tracking tools makes Grill Me a comprehensive resource for those seeking to refine their plans and designs through rigorous questioning.

When to use it

Use this skill when you want to critically assess a design or plan, ensuring that all decision branches are explored and understood.

When not to use it

This skill may not be suitable for informal brainstorming sessions where a less structured approach is preferred.

What you can build with it

Evaluating a Software Architecture

Use Grill Me to dissect a software architecture plan, ensuring that all dependencies and design decisions are thoroughly considered.

Refining a Product Design

Engage Grill Me to critically assess a product design, walking through each decision point to validate design choices.

Stress-Testing a Business Strategy

Employ Grill Me to rigorously question a business strategy, identifying potential pitfalls and ensuring a comprehensive understanding of the plan.

How to install Grill Me

View source

1. Install with the skills CLI

npx skills add alirezarezvani/claude-skills/grill-me --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by alirezarezvani

Grill Me

Derived from Matt Pocock's grill-me (MIT). Matt's interview discipline preserved verbatim. Additions: extraction + question + session tools + references + cs-* wrapper (see 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. Tools: extractor + generator + tracker. Agent: cs-grill-master. Command: /cs:grill-me.

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

Frequently asked questions about Grill Me

Similar skills

Canva Creator

Streamline your content campaign from brief to HubSpot.

Cowork Plugin Customization

Tailor your Claude Code plugin to fit your organization.

Impediment Prioritization

Rank and prioritize impediments effectively.

Chronicle

Streamline your Copilot session analysis and reporting.

Idea Refine

Transform vague ideas into actionable concepts.

App Store Optimization

Optimize your mobile app's visibility and performance.