figure-composer

Figure Composer — narrative → panels → compose → adversarial loop

figure-composer is the outer workflow for one multi-panel figure. Use the figure-style rules while planning and reviewing; every panel worker uses those rules independently. Run paper-narrative first when the paper-level figure sequence is still undecided.

Open Science Notebook call

Every notebook_execute request whose code uses a function named in this skill includes this skill ID:

{ "kernelSkillIds": ["figure-composer"], "code": "print(figure_outline_schema())" }

kernelSkillIds contains the skill ID; function calls belong in code. Call the named functions directly without an import or discovery step.

Inputs

• claim: the one sentence the figure makes true without surrounding prose.
• dataVersionIds: immutable Upload or Artifact Version identities grounding the panels.
• width_mm: venue column width, commonly 85–89 mm single or 174–183 mm double.
• rulesVersionId: immutable Artifact Version containing the design rules used by the composite reviewer.
• delegatePrefix: short branch-unique prefix for panel and reviewer child names.

Run this workflow only in the Main/root agent. Delegated children cannot call host.delegate, so the whole composer cannot itself be delegated.

Entry points

• From a claim: Main writes the outline in step 1 from the claim, data, and figure-style rules.
• From an existing figure: inspect it with host.viewImage, then have Main draft and review the outline directly. Current host.llm calls do not accept images, so do not add a second hidden inference step. Pixels cannot supply Artifact Version identities; fill data_vid from the provided data.

1. Narrative → panel outline

Main produces a panel_outline matching figure_outline_schema():

{
  "claim": "…",
  "width_mm": 180,
  "ncol": 12,
  "row_heights_mm": [40, 60, 46, 52],
  "panels": [
    {
      "letter": "a",
      "role": "schematic",
      "row": 0,
      "col": 0,
      "colspan": 12,
      "chart_family": "schematic overview",
      "message": "…",
      "data_vid": null,
      "ask": "…"
    },
    {
      "letter": "b",
      "role": "primary",
      "row": 1,
      "col": 0,
      "colspan": 7,
      "chart_family": "scatter + trend",
      "message": "…",
      "data_vid": "…",
      "ask": "…"
    }
  ]
}