paper-narrative

Restructures manuscript arguments by analyzing claims, evidence chains, and figure order.

Updated Sep 11, 2026
One-click install
npx skills add https://github.com/cameronbracken/waterology-research --skill paper-narrative-cameronbracken
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: paper-narrative
Source: https://github.com/cameronbracken/waterology-research/tree/main/skills/paper-narrative
Command: npx skills add https://github.com/cameronbracken/waterology-research --skill paper-narrative-cameronbracken

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Scientific manuscripts often suffer from weak argument flow: figures that overclaim beyond the data, missing analyses, or poorly sequenced evidence. This Skill diagnoses and fixes the structural narrative of a paper rather than polishing surface prose. ## Core Features & Use Cases - Evidence Arc Extraction: Identifies the central claim, target audience, evidence chain, figure order, and the decision each figure must support. - Gap Detection: Finds figures claiming more than the data proves, missing analyses, and weak evidence sequences. - Structural Revision: Reorders, merges, splits, or cuts sections and panels based on argument logic, then saves a revision plan with provenance notes. - Use Case: Before submitting a manuscript, ask for a narrative review to discover that Figure 3 overstates a correlation and that a controls analysis is missing, then receive a concrete reordering plan. ## Quick Start Review the narrative structure of my manuscript draft and propose a revision plan for the argument and figure order.

Frequently Asked Questions about paper-narrative

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

FAQPage Schema
How do I improve the argument structure of a scientific paper?▼

Extract the central claim, audience, evidence chain, and figure order, then identify gaps where figures overclaim or analyses are missing. Reorder, merge, split, or cut sections based on the argument rather than surface polish.

How to decide the right figure order for a manuscript?▼

Determine the decision each figure must support in the evidence chain, then sequence figures so each one builds the argument toward the central claim. Weak or redundant panels should be merged, split, or cut.

What is the difference between paper-narrative and paper-writing?▼

paper-narrative shapes the evidence arc and revision strategy of a manuscript, while paper-writing produces the draft text itself. Use research-review for a hard critique and writing-style for prose-level scientific style.

When should figure work be delegated instead of done in a narrative review?▼

Figure-level composition goes to the figure-composer skill and single-panel plot work goes to figure-style. The narrative skill only decides what each figure must prove and where it sits in the argument.

What are the limitations of narrative-level manuscript review?▼

It addresses argument structure, not prose quality or statistical correctness. Drafting text requires paper-writing, and verifying that analyses actually support claims requires domain review of the underlying data and methods.