agentleFS
luizomfluizomf/omskills/skills/productivity/grill-me/SKILL.md

grill-me

Skill3 starsChanged 2 months agoMITView on GitHub

Stress-test any plan, idea, or design through bounded rounds of independent decision Questions.

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

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

  • 0

    Common

    Most of the 177 edited versions we read keep these.

  • 4

    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:

    Before the first round and after every user response:

    line 10
  2. Distinctive:

    Update the tree from settled decisions and known constraints.

    line 12
  3. Distinctive:

    Use this shape for every visible Question:

    line 18
  4. Distinctive:

    Keep each identifier unchanged and unambiguous while its round is visible.

    line 28

“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

Stress-test the plan by maintaining an internal decision tree of unresolved decisions, their prerequisites, and relevant facts. Keep the tree internal: do not render or persist it.

Before the first round and after every user response:

  1. Update the tree from settled decisions and known constraints. Validate every answer the user actually provided against available evidence, earlier answers, stated constraints, boundary cases, and missing assumptions. Surface conflicts before treating an answer as settled.
  2. Settle only the Questions the user answered. Never infer an answer for an omitted Question; keep it eligible for a later recomputed frontier.
  3. Investigate discoverable facts when they are needed using whatever workspace tools, authoritative sources, or isolated assistance the active harness provides. Do not ask the user to discover them or require a particular skill invocation, command spelling, or harness-specific worker API. If a fact remains unresolved, defer only the Questions that depend on it.
  4. Recompute the current frontier. A Question is eligible only when all its decision and fact prerequisites are settled. Select no more than three mutually independent eligible Questions; answering one must not determine, invalidate, or change the options of another.
  5. Present only that frontier and wait for the user's response.

Use this shape for every visible Question:

### Q<number> — <short title>

<question text or options>

**Recommendation:** <concise recommended answer, with supporting evidence or trade-off>

Keep each identifier unchanged and unambiguous while its round is visible; identifiers need not be global across rounds. The recommendation informs the user's decision and does not settle it.

Question assumptions, undefined or multiply defined terms, contradictions, boundary cases, and missing constraints when they could change the outcome or scope. Keep project sources unchanged and the decision tree internal. Disposable evidence or decision notes are allowed under Working files; read that policy before using them. Resolve this link from the physical directory printed by cd '<loaded-skill-directory>' && pwd -P, following the source symlink first. Working notes do not invoke a publication workflow or execute the resulting plan.

Complete the grill

Begin completion only when the recomputed Question frontier is genuinely empty because no unresolved Question or unresolved fact could change the outcome or scope. An empty frontier caused by an unresolved prerequisite is not completion. Completion never starts implementation.

For implementation-bound work, include known dependencies, conflicts, shared resources outside Git, exclusive candidates for every Ticket, and delivery/integration decisions in the shared understanding. Distinguish parallel branch artifacts from combined-target delivery, durable exact predecessor inputs and retention through all consumers. Leave complete phases and a preplanned ordinary integration Ticket blocked by every parallel member to to-tickets during breakdown approval.

Resolve these two decisions in order, reusing explicit choices already supplied:

  1. Confirm the shared understanding. Consolidate the established decisions, constraints, exclusions, relevant evidence, and any unresolved Questions, including why the unresolved Questions do not block completion. Ask the user to confirm or correct that complete understanding, then wait. Do not recommend a destination yet. If the user corrects it, update the decision tree, resume grilling when needed, and repeat this gate until the user explicitly confirms the revised understanding.
  2. Resolve the destination. After the shared understanding is confirmed, use an explicitly authorized destination if it still fits that understanding; no second confirmation is needed. Otherwise recommend exactly one destination from the criteria below, explain why, and ask for confirmation. Mention alternatives only when materially relevant. A destination chosen earlier or in the same response as the understanding confirmation counts; if changed scope makes it unsuitable or ambiguous, resolve that difference before completion.

Choose the recommendation by these criteria:

  • Conversation only: nothing needs to survive beyond the current conversation.
  • Scratchpad: temporary, clean-context continuation is needed, but the result does not yet warrant durable planning authority.
  • New Spec: durable behavior or workflow planning is needed and no existing Spec or Ticket already governs the result.
  • Existing Spec or Ticket update: an existing tracked item already governs the result; update it instead of recommending a duplicate.
  • Domain language or ADR: shared domain meaning belongs in CONTEXT.md, or a durable decision belongs in an ADR, only when the destination satisfies that artifact's existing recording gate.

After the shared understanding is confirmed and the destination is authorized, report the chosen destination and a concise continuation summary in the conversation only. grill-me does not carry out the selected destination route: delivering a Scratchpad, publishing a Spec or tracked-item update, or changing domain documents and ADRs belongs to the authorized continuation. Its disposable working notes remain permitted and are not those deliverables. It never starts implementation, resolves the later Delivery mode gate, or bypasses the implementation, proportionate review, repository delivery, or route-specific readiness, Prompt Audit, and authorization rules.

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.