mcpbeat

Paper Narrative

xuzhougeng/paper-narrative

Judge and reshape the story told by a manuscript and its figure deck. Use when revising paper structure, testing whether Figure 1 is a hook, ordering figures, moving panels, identifying missing analyses, or defining the claim passed to figure-composer.

2k tokens
context cost
the whole folder, loaded on every use
2
files
ships runnable scripts
0
copies elsewhere
how many repositories repackaged it
859
stars on the repo
on the repository, not the skill itself

Install

one command, takes just this skill from the repository
npx skills add https://github.com/xuzhougeng/wisp-science --skill paper-narrative

The instruction itself

3 sections, as written by the author

Paper narrative

Use this skill before figure-composer. The sidecar only builds schemas and

self-contained reviewer instructions. Model reasoning happens in the current

Agent or an explicitly delegated Wisp Agent, never inside Python.

Workflow

  • Read the abstract, introduction, captions, and concrete figure paths.
  • Build an instruction with paper_brief_task(...). Produce a brief matching

paper_brief_schema() in the current Agent. If delegate_tasks is advertised,

the brief may instead be assigned to one reasoning task with a structured

output schema.

  • Review the entire brief. Preserve supplied composite_path values and fix

unsupported claims before continuing.

  • If the deck is a PDF, use pdf-explore to render the relevant pages to local

images. Pass their concrete paths to narrative_review_task(...).

  • Inspect the images with view_image. Optionally delegate one handling-editor

task with the minimum advertised reasoning, project_read, and

image_inspection capabilities and narrative_review_schema().

  • Act on the result:
  • use arc as the main-figure order;
  • apply figure_moves;
  • turn missing_panels into explicit analyses;
  • demote or remove the kill_list;
  • send boldest_defensible_fig1 to figure-composer.
  • Re-review the revised deck. Converge when the hook verdict is yes and no

figure moves or missing panels remain.

Use run_in_context only for deterministic analyses requested by

missing_panels. Narrative reasoning and Agent delegation are not Runs.

Boundaries

  • Do not pass artifact markers where a path is required.
  • Do not call another model from python.
  • Do not claim the deck was inspected unless every relevant page was rendered

and viewed.

How to use it

Copy the folder

Take xuzhougeng/paper-narrative from the repository into ~/.claude/skills for personal use, or into .claude/skills inside a project.

Check the name does not clash

The agent identifies a skill by the name field in its header. Two skills with the same name cannot sit side by side — one of them will be ignored.