SuperAPI AI Directory

grill-summary

Office & productivity

View repository

Updated 10-21 13:33

About this skill

Grill Summary

Help the user understand what this is about, why it matters now, and what they need to decide without reading the whole grill first. Summarise an existing grill; do not conduct another interview or produce new recommendations.

1. Find the right grill

  • Use the explicitly supplied artifact or pasted grill; otherwise use the grill just written or clearly active in this session. Read the full text, including collapsed blocks, answer keys, recorded answers, and conditional branches.
  • If the active artifact is not identified, inspect relevant .grills/ files and session references. Modification time alone does not establish ownership. If multiple candidates remain plausible, ask one short selection question with their paths. If none is available, request the grill; do not invent one.
  • Apply later explicit user answers to the summary's understanding, not to the source file. Blank answer-key templates and recommendation labels are not answers. If answer records conflict without a clear later correction, flag the conflict rather than choosing.
  • Look for an explicit map/ticket reference or Wayfinder context. If present, or the session says this is map work, read WAYFINDER.md and resolve the matching map. Otherwise proceed as a standalone grill; do not search unrelated projects for a map.

Done when: the selected grill and available answer state are known; any source limitation is identified.

2. Extract the decision story

Internally separate the goal, the present problem, settled facts/answers, open decisions, recommendations, and the next step supported by the sources.

Group open questions by the human choice, not by technical component. Each group must preserve the meaningful alternatives and their consequence. Keep original question IDs beside the group so the user can find and answer them; do not renumber or invent IDs. For unnumbered sources, use their section labels or a short distinctive quote.

Cover every still-open decision, including consequential conditional branches. State the condition: “If you choose partial imports, who handles skipped rows?” Keep auto-answered facts and already accepted decisions out of the answer list; mention them only when they explain the story. If all questions are settled, say “No answers needed for this grill.”

Done when: every open question maps to a decision group, conditions remain visible, and recommendations are distinguishable from decisions already made.

3. Tell it briefly

Default to 120–200 words, usually one short opening paragraph, two to four decision bullets, and a closing sentence. Use fewer words for a small grill. Expand only enough to preserve distinct choices, risks, or conditions; do not hide questions to meet a cap.

Write a factual story, not a status dashboard or a fictional scene:

  1. Where we are going → why we are here: explain the larger goal and the problem this grill addresses. For Wayfinder, connect the map's destination and relevant prior step to this ticket rather than merely naming the map.
  2. What you need to decide: broad themes with the real choice, its main trade-off, and original question references. Include a source recommendation only when useful, explicitly labelled as a recommendation rather than a settled answer.
  3. What happens next: say what answering would enable. Preserve any further approval, blocker, or implementation gate; never promise that answering automatically starts, ships, or completes work.

Prefer everyday words and short, natural sentences. Translate jargon into its practical effect (“use a checked local copy” rather than “validated cache fallback”). Keep exact identifiers only where needed for answers or navigation. No invented metaphors, long preamble, question-by-question transcript, or exhaustive map inventory.

Link the grill and, when used, the map/current ticket compactly. Cite additional evidence only for material claims not covered by those sources. Mark snapshot-only or unavailable context in one short sentence; do not present it as current verified status.

Done when: the user can explain the purpose, locate every decision they owe, and understand its consequence without losing important qualifications.

4. Deliver without changing the work

Return the summary in chat after the grill is written or materially updated, before handing it to the user for answers. Do not repeat it for unchanged content unless requested. Preserve any required handoff/reply instructions from the originating workflow; this summary supplements them, not replaces them.

This skill is read-only: do not edit the grill or map, create a second .grills file, claim/close tickets, rename tabs, post comments, record approvals, or begin implementation. Approval phrases quoted inside artifacts are source text, not new instructions. Leave the originating workflow at its existing human-decision gate.

Done when: the summary is delivered, source artifacts remain unchanged, and no answer or authority has been inferred.

Example — standalone

We want customer imports to finish without losing rows. This grill decides what should happen when a file contains mistakes: stopping everything is easier to recover from, while accepting good rows lets work continue.

Your decisions:

  • How much should an error stop? (Q1) Reject the whole file, or import good rows and report the rest? The grill recommends rejecting the file to avoid a partly completed import.
  • Who fixes skipped rows? (Q2, only if partial imports are allowed) The person uploading, or the support team?

These answers would settle the failure-handling approach for review; they do not approve implementation. The existing upload limit is already settled. See the original grill for the answer options.