Skills

Paper Narrative

Judge and reshape the story told by an entire paper figure deck.

Install

npx skills add aipoch/open-science --skill paper-narrative -g -a claude-code -y
Repository
aipoch/open-science5.4k
Category
Writing
Updated
3d ago
License
Apache-2.0
Context cost
Mediumabout 3,000 tokens
Runs scripts
Yes, review before use

What it does

Judge and reshape the story told by an entire paper figure deck. Use when writing or revising a paper to derive a grounded brief from the manuscript and captions, review the full deck as a handling editor, and hand an ordered figure arc to `figure-composer`.

Paper Narrative, manuscript → brief → figure arc → editorial loop

paper-narrative is the outermost figure workflow. It judges the paper-level story before figure-composer designs any one figure. The inputs are the work itself: a manuscript (or abstract), figure captions, and the current full deck.

Open-Science Notebook call

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

{ "kernelSkillIds": ["paper-narrative"], "code": "print(paper_brief_schema())" }

kernelSkillIds contains the skill ID; function calls belong in code. This request is complete as written: call the named functions directly and do not add an import or discovery step.

Required inputs and trust labels

Keep these inputs distinct throughout the workflow:

  • manuscriptVersionId: immutable manuscript Artifact Version (an abstract-only manuscript is allowed) and the reviewed manuscript text read from it.
  • abstractText: reviewed abstract text when available; use it for bounded brief reasoning while retaining the full manuscript Version as source provenance.
  • captionsVersionId: immutable captions Artifact Version and the reviewed per-figure caption or claim text read from it.
  • deckVersionId: immutable deck Artifact Version containing every current figure in review order.
  • rulesVersionId: immutable design-rules Artifact Version, used only as a reference so the editor judges story rather than visual craft.
  • figureDataVersionIds: immutable data Artifact Versions grouped by figure.
  • figureWidthMmByFigure: reviewed positive venue width for each figure; the downstream composer must not invent this physical output constraint.
Read the whole SKILL.md on GitHub

More in Writing