Paper Narrative
Judge and reshape the STORY a paper's figures tell.
Install
npx skills add HughYau/AcademicForge --skill paper-narrative -g -a claude-code -y- Repository
- HughYau/AcademicForge2.6k
- Category
- AI and agents
- Updated
- 2mo ago
- License
- Apache-2.0
- Context cost
- Lightabout 759 tokens
- Runs scripts
- Yes, review before use
What it does
Judge and reshape the STORY a paper's figures tell. Input is the work itself, manuscript (or abstract) + figure deck, no hand-written brief. `paper_brief_prompt(abstract, captions)` hands you the prompt to write the brief yourself (pitch/vision/per-figure-claims); then you play a handling editor over the full deck and return hook_verdict (would Fig 1 make me send this for review?), arc (hook→mechanism→evidence→application), figure_moves (panels in the wrong figure), missing_panels (concrete analyses to RUN), kill_list, and boldest_defensible_fig1. Hands per-figure claims to `figure-composer`. Load when writing or revising a paper.
paper-narrative
Outermost tier. Judge and reshape the story a paper's figures tell. Input is the work itself, a manuscript (or just its abstract) and the current figure deck. No hand-written brief required.
Setup (any agent, no API key)
This is a pure skill, kernel.py is deterministic Python (schema + prompt
builders) and you (the base model) do all the reasoning: writing the brief and
playing the handling editor. There is no host runtime and no LLM API. Load the
helpers once per session in a Python cell:
exec(open("paper-narrative/kernel.py").read()) # path to this skill's kernel.py
Nothing auto-loads it outside Claude Science. Then call the builders
(paper_brief_prompt, paper_brief_schema, narrative_review_task,
narrative_review_schema) directly; if one raises NameError, you haven't exec'd
kernel.py.
When to load
Paper writing or revision. You have a draft and a set of figures and you want to
know: is Figure 1 a hook? Is content in the right figure? What's missing? What
should die? Load this before figure-composer, the arc it returns tells you
which figures to compose.
