GitHub 39
Skip to content

Report

The answer and the decisions first, the numbers in charts, and the detail folded underneath.

The skill shapes research, a ranked shortlist, a comparison, or a plan into one page with a fixed shape:

  • the answer in two sentences, with the decisions you have to make as yes/no questions
  • one picture per section, picked by the shape of what it answers: a bubble chart, a bar chart, a flowchart of the order, or a short table
  • the detail folded in accordions, the same parts in every item
  • what the agent didn't verify, kept open at the end

Every fact lives in one section, so the page never says the same number twice.

Ask once the research is done, such as "Write up which modules we should migrate first" or "Turn this plan into a report I can approve." Your agent loads it when you have to choose between options or approve a plan. To be sure, say "Use the report skill."

Choose by what you have:

  • Options to compare, or a plan to approve: this skill.
  • Findings about code, a design, or a system that already exists: Review document.
  • A question about how something works: Visual explanation.
  • Data you explore and filter yourself: Data explorer.
  • Reading only the answer and its callout tells you what the agent recommends and what you have to decide.
  • Each section opens with one sentence that says what to look at, then its picture.
  • The numbers the answer rests on are in a chart or a table column, and table cells stay a line or two long.
  • Nothing you decide on is folded, and everything you would only check is.
  • The page ends with what the agent didn't verify and where its numbers came from.