
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.
