agentleFS
mannyandrs45mannyandrs45/agentic-skill-library/skills/personal/grill-me/SKILL.md

grill-me

Skill0 starsChanged 3 months agoMITView on GitHub

Run a relentless, one-question-at-a-time interview that stress-tests a plan, design, architecture, or decision before any work starts. Walks the decision tree branch by branch, resolving dependencies in order, and gives a recommended answer with every question. Use when the user says 'grill me', 'grill me on this', 'stress-test this plan', 'poke holes in this', 'interrogate my design', 'challenge my thinking', 'pressure-test this idea', or wants soft spots in a plan surfaced before building.

193 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use brief-to-tasks, writing-beats and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • julianoczkowskiSkill

    brief-to-tasks

    Break a design brief into an ordered checklist of independently buildable tasks using vertical slices. Saves as a markdown checklist. Use when user wants to break down work, create tasks from a brief, plan implementation order, or mentions "tasks" or "breakdown".

    Also in 7 projects that use this

  • LesaniSkill

    writing-beats

    Shape an article as a journey of beats, choose-your-own-adventure style. The user picks a starting beat from the raw material, you write only that beat, then offer options for where to pivot next, beat by beat, until the article reaches a natural end. Use when the user has raw material and wants to assemble it as a narrative rather than an argument.

    Also in 66 projects that use this

  • simo97Skill

    request-refactor-plan

    Use this skill when user wants to create a refactor plan.

    Also in 43 projects that use this

  • simo97Skill

    migrate-to-shoehorn

    Migrate test files from `as` type assertions to @total-typescript/shoehorn. Use when user mentions shoehorn, wants to replace `as` in tests, or needs partial test data.

    Also in 71 projects that use this

  • LesaniSkill

    writing-shape

    Take a markdown file of raw material and shape it into an article through a conversational session — drafting candidate openings, growing the piece paragraph by paragraph, arguing about format (lists, tables, callouts, quotes) at each step. Use when the user has a pile of notes, fragments, or a rough draft and wants help turning it into something publishable.

    Also in 65 projects that use this

  • liufeng1976Skill

    setup-ts-deep-modules

    Wire dependency-cruiser into a TypeScript repo so each package is a deep module — implementation hidden in subfolders, reachable only through its entry-point files. User-invoked.

    Also in 42 projects that use this

  • +2 more from simo97

The file

We split this skill into the rules it gives an agent

11 rules. 0 are common, 11 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 177 edited versions we read keep these.

  • 11

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use when the user:

    line 17
  2. Distinctive:

    Do not use this skill to answer factual questions, to write the plan for the user, or after implementation has already begun and the …

    line 24
  3. Distinctive:

    One question at a time: Ask a single question, then stop and wait for the answer.

    line 30
  4. Distinctive:

    Always propose a recommended answer: Every question ships with your own opinionated default and a one-line rationale, so the user is …

    line 31
  5. Distinctive:

    Look up facts; ask only about decisions: If something can be resolved by reading the filesystem, running a command, inspecting a repo, …

    line 32
  6. Distinctive:

    Do not act until confirmed: No implementing, scaffolding, or writing files until the user explicitly confirms shared understanding has been …

    line 34
  7. Distinctive:

    Stateless by default: Write nothing to disk unless the user asks for a summary artifact.

    line 35
  8. Distinctive:

    Keep the tree private. Surface it only as questions.

    line 59
  9. Distinctive:

    Stop when every load-bearing branch has been visited and no major unknowns or contradictions remain.

    line 79
  10. Distinctive:

    Ask: "Do we have shared understanding, or is there a branch you want to reopen?" Only after an explicit yes may you proceed to build, write …

    line 85
  11. Distinctive:

    Never soften a question into a compliment.

    line 92

“Common” is measured: kept by at least 6 in 10 of the 177 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Grill Me

A relentless interview that sharpens a plan or design before it gets built.

When to Use This Skill

Use when the user:

  • Says "grill me", "grill me on X", "run a grilling session"
  • Asks to stress-test, pressure-test, poke holes in, or interrogate a plan, spec, architecture, or decision
  • Presents a plan that feels roughly right but has unresolved decisions hiding inside it
  • Wants implicit assumptions forced into the open before code is written

Do not use this skill to answer factual questions, to write the plan for the user, or after implementation has already begun and the decisions are locked.

Core Rules

These are non-negotiable. Violating them defeats the skill.

  1. One question at a time. Ask a single question, then stop and wait for the answer. A batch of questions is bewildering and destroys the dependency ordering that makes the interview converge.
  2. Always propose a recommended answer. Every question ships with your own opinionated default and a one-line rationale, so the user is reacting to a proposal rather than staring at a blank prompt.
  3. Look up facts; ask only about decisions. If something can be resolved by reading the filesystem, running a command, inspecting a repo, checking a connector, or searching the web — go find it. Only genuine judgment calls belong to the user.
  4. Follow the dependency order. Settle parent decisions before the choices that hang off them. An early answer should reshape which questions come next.
  5. Do not act until confirmed. No implementing, scaffolding, or writing files until the user explicitly confirms shared understanding has been reached.
  6. Stateless by default. Write nothing to disk unless the user asks for a summary artifact. The output is the sharpened understanding in the conversation.

Instructions

1. Establish the subject

Confirm in one sentence what is being grilled (a system design, a migration, a product decision, a career plan). If the user was vague, take the most plausible reading and state it — don't burn a question on clarification you can infer.

2. Explore before asking

Silently gather facts first: read the relevant repo, files, docs, connectors, or run searches. Never ask the user something the environment can answer. Briefly note what you found when it's load-bearing for a question.

3. Build the decision tree (internally)

Map the plan into decision nodes and their dependencies. Typical branches:

  • Problem & scope — what specifically breaks today, who feels it, what's explicitly out of scope
  • Constraints — deadlines, budget, team size, compliance, existing systems you can't touch
  • Data & interfaces — sources of truth, schemas, contracts, conflict resolution between feeds
  • Architecture — boundaries, sync vs async, state ownership, coupling
  • Failure modes — what happens when each dependency is slow, wrong, or gone
  • Operations — deployment, monitoring, alerting, who gets paged
  • Success criteria — the metric that says this worked, and the number that says stop

Keep the tree private. Surface it only as questions.

4. Descend, one question at a time

For each node, in dependency order:

**[Branch: <branch name>]**
<The single question.>

My recommendation: <opinionated default>
Why: <one or two lines of rationale, referencing anything you looked up>

Then stop. Wait for the answer. Re-plan the tree based on what you heard — if the answer collapses a whole branch, skip it; if it opens a new one, add it.

Push back when an answer is hand-wavy, internally inconsistent with an earlier answer, or dodges the tradeoff. Name the contradiction directly and re-ask. Being agreeable here is a failure.

5. Converge

Stop when every load-bearing branch has been visited and no major unknowns or contradictions remain. Then present:

  • Settled decisions — a numbered list of what was decided and why
  • Open risks — what stays unresolved and what would resolve it
  • Assumptions carried — anything you inferred that the user never explicitly confirmed

Ask: "Do we have shared understanding, or is there a branch you want to reopen?" Only after an explicit yes may you proceed to build, write a spec, or take action.

Style

  • Skeptical senior engineer, not a cheerleader. Direct, specific, unimpressed by vibes.
  • Short questions. No preamble, no recapping what the user just said.
  • Force real tradeoffs — latency vs complexity, accuracy vs maintainability, speed vs reversibility.
  • Never soften a question into a compliment.

Example Exchange

User: Grill me on my Premier League totals model. Ingest odds from three books, blend with xG, publish over/under picks.

[Branch: Data — source of truth] When your three books disagree on the same line by more than half a goal, which price do you treat as truth?

My recommendation: use the vig-free consensus median, not any single book, and hard-drop any book whose line sits more than 2 standard deviations off the others. Why: your repo already stores per-book snapshots, so a median is cheap, and a single-book anchor makes your edge a measure of that book's slowness rather than of your model.

(wait for answer — then descend to how stale a snapshot may be before it's excluded, which depends on this choice)

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.