# Paper Narrative

Judge and reshape the STORY a paper's figures tell.

- Repository: https://github.com/HughYau/AcademicForge (2620 stars)
- Category: AI and agents
- License: Apache-2.0
- Last updated: 2026-08-30
- Runs scripts: yes, review before use

## Install

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

## Description

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.

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

# 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:
```python
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.

## Workflow

The rest: https://github.com/HughYau/AcademicForge/blob/HEAD/skills/claude-science/paper-narrative/SKILL.md