paper-narrative

Generate a narrative brief and feedback from a paper's abstract, captions, and figures.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/guanxiaol/open-science --skill paper-narrative
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-narrative
Source: https://github.com/guanxiaol/open-science/tree/main/runtime/skills/paper-narrative
Command: npx skills add https://github.com/guanxiaol/open-science --skill paper-narrative

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill helps authors assess and improve the story their paper's figures tell, by providing insights into the figure content, structure, and impact.

Core Features & Use Cases

  • Brief Derivation: Automatically generate a narrative brief from the paper's abstract and figure captions.
  • Review and Recommendations: Offers structured feedback on the paper's narrative, including the hook, arc, figure moves, missing panels, and suggestions for the most defensible figure.
  • Use Case: Ideal for authors during the writing or revision phase of a paper, aiming to ensure that the figures effectively convey the paper's story and contribute to its overall impact.

Quick Start

Load the paper-narrative skill. Provide the manuscript as @manuscript.tex and the figure deck as @all_figures.pdf.

Frequently Asked Questions about paper-narrative

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze the narrative arc of a scientific paper's figures?

To analyze a paper's narrative, you can generate a structured brief from the manuscript abstract and figure captions. This process evaluates figure content, structure, and impact to map the narrative arc and figure moves.

What's the best way to identify missing panels in a research manuscript figure deck?

Identifying missing panels in a figure deck involves assessing the narrative arc against the paper's claims. An automated review can suggest the most defensible figure structure by highlighting gaps in the story and recommending missing panels.

Can I review figure impact and structure using just the abstract and captions?

Yes, you can derive a narrative brief using only the manuscript abstract and figure captions. This brief provides feedback on the hook, figure moves, and overall impact, though processing the full figure deck yields deeper structural recommendations.

How to reshape a paper's figure narrative for better scientific writing flow?

To reshape a paper's figure narrative, process the manuscript and full figure deck to generate feedback on the hook, arc, and figure moves. This feedback guides revisions to ensure figures effectively convey the story and strengthen impact.

Do I need to provide the full manuscript to assess a paper's figure narrative?

You need to provide the manuscript file and the full figure deck to perform a complete narrative assessment. Processing both the manuscript text and figure deck allows the tool to generate narrative arcs, missing panels, and defensible figure suggestions.