Paper Narrative Agent Skill

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

files

ships runnable scripts

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.

Other skills for the same job

different authors, same section of the catalogue

Content Research Writer

by frostant

×10

Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.

4k tokens

Lead Research Assistant

by frostant

×8

Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals.

Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations through document-only responses.

Efficient database search tool for bioRxiv preprint server. Use this skill when searching for life sciences preprints by keywords, authors, date ranges, or categories, retrieving paper metadata, downloading PDFs, or conducting literature reviews.

Query and analyze scholarly literature using the OpenAlex database. This skill should be used when searching for academic papers, analyzing research trends, finding works by authors or institutions, tracking citations, discovering open access publications, or conducting bibliometric analysis across 240M+ scholarly works. Use for literature searches, research output analysis, citation analysis, and academic database queries.

Access USPTO APIs for patent/trademark searches, examination history (PEDS), assignments, citations, office actions, TSDR, for IP analysis and prior art searches.

Multiagent AI system for scientific research assistance that automates research workflows from data analysis to publication. This skill should be used when generating research ideas from datasets, developing research methodologies, executing computational experiments, performing literature searches, or generating publication-ready papers in LaTeX format. Supports end-to-end research pipelines with customizable agent orchestration.

Automated LLM-driven hypothesis generation and testing on tabular datasets. Use when you want to systematically explore hypotheses about patterns in empirical data (e.g., deception detection, content analysis). Combines literature insights with data-driven hypothesis testing. For manual hypothesis formulation use hypothesis-generation; for creative ideation use scientific-brainstorming.

7k tokens

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.