About

Imported from shipshitdev/skills (skills/grilling/SKILL.md). Install upstream with npx skills add shipshitdev/skills --skill grilling. Copyright stays with the author (MIT).

Grilling

Name: grilling
Author: shipshitdev

Interview the user relentlessly until every branch of the design tree is resolved. This is the reusable interview primitive. Orchestrators (interview, shape) invoke it; they own grounding, artifacts, and routing.

Contract

Inputs:

A plan, decision, idea, or design question
Optional repo or docs context already loaded by the calling skill

Outputs:

Settled decisions across the design tree
Remaining open questions only when a fact-finding sub-agent is still running

Creates/Modifies:

None. Calling skills persist briefs, glossaries, or issues.

External Side Effects:

Read-only lookups to settle facts. No tracker writes, no code edits.

Confirmation Required:

Before acting on the settled tree. Stop at a shared understanding; do not implement.

Delegates To:

None. Fact-finding may dispatch a read-only exploration sub-agent.

Design tree

Map the topic as a design tree: every decision branches into the decisions that hang off it.

The frontier is every decision whose prerequisites are already settled — the questions that can be asked now without guessing at answers not yet heard.

Work the tree in rounds. Ask the whole frontier in one round. Wait for answers before the next round.

Round format

Number each frontier question. Recommend an answer so the user can accept it in a word.

**Q1 — <question title>**: <question body, including choices when they exist>

Recommended: <recommended answer>

A question whose answer depends on another question still open in this round belongs to a later round, not this one.

Facts vs decisions

Finding facts is the agent's job. When a frontier question needs a fact from the environment (filesystem, tracker, docs), dispatch a sub-agent to find it. Do not ask the user for anything that can be looked up.

Do not block the rest of the frontier on that lookup. A running exploration is an unsettled prerequisite, so only questions downstream of it wait — ask the rest of the frontier now.

Decisions are the user's. Put each to them and wait.

Done when

The frontier is empty: every branch of the design tree visited, nothing left silently assumed.

Do not act on the tree until the user confirms a shared understanding.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/shipshitdev-skills-grilling/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

shipshitdev-skills-grilling.ocm.jsonjson

{
  "ocm": "1",
  "id": "shipshitdev-skills-grilling",
  "kind": "skill",
  "name": "grilling",
  "description": "Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, asks to be grilled, or another skill needs the interview primitive.",
  "publisher": "shipshitdev",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "general"
    ],
    "tags": [
      "skill-md",
      "interview",
      "grilling",
      "discovery",
      "planning",
      "frontier",
      "skills-sh"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, asks to be grilled, or another skill needs the interview primitive."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "skills.sh",
      "repository": "https://github.com/shipshitdev/skills",
      "path": "skills/grilling/SKILL.md",
      "ref": "HEAD",
      "url": "https://github.com/shipshitdev/skills/blob/HEAD/skills/grilling/SKILL.md",
      "key": "shipshitdev/skills/skills/grilling/SKILL.md"
    },
    "license": "MIT"
  },
  "instructions": "# Grilling\n\nInterview the user relentlessly until every branch of the **design tree** is resolved. This is the reusable interview primitive. Orchestrators (`interview`, `shape`) invoke it; they own grounding, artifacts, and routing.\n\n## Contract\n\nInputs:\n\n- A plan, decision, idea, or design question\n- Optional repo or docs context already loaded by the calling skill\n\nOutputs:\n\n- Settled decisions across the design tree\n- Remaining open questions only when a fact-finding sub-agent is still running\n\nCreates/Modifies:\n\n- None. Calling skills persist briefs, glossaries, or issues.\n\nExternal Side E",
  "cost": {
    "context_tokens": 569
  }
}

Fetch it by URL: GET /api/v1/registry/shipshitdev-skills-grilling/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.