Paper narrative

SkillDev tools

Judge and reshape the story told by a manuscript and its figure deck. Use when revising paper structure, testing whether Figure 1 is a hook, ordering figures, moving panels, identifying missing analyses, or defining the claim passed to figure-composer.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Paper narrative skill

What this skill tells your AI

The instructions your AI receives, as published by xuzhougeng/wisp-science in skills/paper-narrative/SKILL.md and read by ahel’s review.

Use this skill before figure-composer. The sidecar only builds schemas and self-contained reviewer instructions. Model reasoning happens in the current Agent or an explicitly delegated Wisp Agent, never inside Python.

Workflow

  1. Read the abstract, introduction, captions, and concrete figure paths.
  2. Build an instruction with paper_brief_task(...). Produce a brief matching paper_brief_schema() in the current Agent. If delegate_tasks is advertised, the brief may instead be assigned to one reasoning task with a structured output schema.
  3. Review the entire brief. Preserve supplied composite_path values and fix unsupported claims before continuing. The brief and review instructions include JSON figure records so each path stays associated with its claim; keep those records when delegating, including paths with spaces or Unicode.
  4. If the deck is a PDF, use pdf-explore to render the relevant pages to local images. Pass their concrete paths to narrative_review_task(...).
  5. Inspect the images with view_image. Optionally delegate one handling-editor task with the minimum advertised reasoning, project_read, and image_inspection capabilities and narrative_review_schema().
  6. Act on the result:
    • use arc as the main-figure order;
    • apply figure_moves;
    • turn missing_panels into explicit analyses;
    • demote or remove the kill_list;
    • send boldest_defensible_fig1 to figure-composer.
  7. Re-review the revised deck. Converge when the hook verdict is yes and no figure moves or missing panels remain.

Use run_in_context only for deterministic analyses requested by missing_panels. Narrative reasoning and Agent delegation are not Runs.

Boundaries

  • Do not pass artifact markers where a path is required.
  • Do not call another model from python.
  • Do not claim the deck was inspected unless every relevant page was rendered and viewed.

Signals

GitHub stars
1k
Forks
117
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
paper-narrative-xuzhougeng
Source
github.com/xuzhougeng/wisp-science