paper-narrative

1# Paper Narrative — manuscript → brief → figure arc → editorial loop
2 
3`paper-narrative` is the outermost figure workflow. It judges the paper-level
4story before `figure-composer` designs any one figure. The inputs are the work
5itself: a manuscript (or abstract), figure captions, and the current full deck.
6 
7## Open-Science Notebook call
8 
9Every `notebook_execute` request whose `code` uses a function named in this skill
10includes this skill ID:
11 
12```json
13{ "kernelSkillIds": ["paper-narrative"], "code": "print(paper_brief_schema())" }
14```
15 
16`kernelSkillIds` contains the skill ID; function calls belong in `code`. This
17request is complete as written: call the named functions directly and do not add
18an import or discovery step.
19 
20## Required inputs and trust labels
21 
22Keep these inputs distinct throughout the workflow:
23 
24- `manuscriptVersionId`: immutable manuscript Artifact Version (an abstract-only
25  manuscript is allowed) and the reviewed manuscript text read from it.
26- `abstractText`: reviewed abstract text when available; use it for bounded brief
27  reasoning while retaining the full manuscript Version as source provenance.
28- `captionsVersionId`: immutable captions Artifact Version and the reviewed
29  per-figure caption or claim text read from it.
30- `deckVersionId`: immutable deck Artifact Version containing every current
31  figure in review order.
32- `rulesVersionId`: immutable design-rules Artifact Version, used only as a
33  reference so the editor judges story rather than visual craft.
34…