# Paper Narrative

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

- Repository: https://github.com/aipoch/open-science (5414 stars)
- Category: Writing
- License: Apache-2.0
- Last updated: 2026-11-01
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add aipoch/open-science --skill paper-narrative -g -a claude-code -y`
Codex: `npx skills add aipoch/open-science --skill paper-narrative -g -a codex -y`
Cursor: `npx skills add aipoch/open-science --skill paper-narrative -g -a cursor -y`
Gemini CLI: `npx skills add aipoch/open-science --skill paper-narrative -g -a gemini-cli -y`

## Description

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`.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 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:

```json
{ "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.

The rest: https://github.com/aipoch/open-science/blob/HEAD/resources/skills/paper-narrative/SKILL.md