New: 98,000+ skills indexed from GitHub repos with 100+ stars · every skill safety-checkedBrowse top skillsTop skills
Esc to closeBrowse all skills
Submit a skillBrowse skills
Submit a skillBrowse skills

Agent skill

Paper Narrative

by JimLiu in JimLiu/science-skills

Judge and reshape the STORY a paper's figures tell. An agent skill from JimLiu/science-skills.

Apache-2.0Auto-check passed

Install Paper Narrative

skills CLI
$ npx skills add JimLiu/science-skills --skill paper-narrative -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install JimLiu/science-skills paper-narrative --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/JimLiu/science-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/paper-narrative .claude/skills/paper-narrative && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
paper-narrative
GitHub stars
228
Used in
2 other repos
Token cost
~669 tokens
SKILL.md length
274 words
Files
2
Skills in repo
27
Repo updated
First seen
Licence
Apache-2.0

At a glance

Judge and reshape the STORY a paper's figures tell. An agent skill from JimLiu/science-skills.

  • Works in 5 steps: Derive the brief from the work. Read the… → Dispatch the handling editor.… → Act on the output, don't just report it → …
  • SKILL.md covers When to load, Workflow and Minimal invocation
  • Runs Python scripts from its folder

What it does

Paper Narrative is an agent skill from JimLiu/science-skills. Judge and reshape the STORY a paper's figures tell. Input is the work itself — manuscript (or abstract) + figure deck — no hand-written brief. derivepaperbrief(abstract, captions) extracts pitch/vision/per-figure-claims; a handling-editor reviewer on the full deck returns hookverdict (would Fig 1 make me send this for review?), arc (hook→mechanism→evidence→application), figuremoves (panels in the wrong figure), missingpanels (concrete analyses to RUN), killlist, and boldestdefensiblefig1. Hands per-figure claims…

Its SKILL.md is about 670 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `kernel.py`).

The licence is Apache-2.0.

Example prompts

  • “/paper-narrative”

Requirements

  • Python 3

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Derive the brief from the work. Read the manuscript's abstract/intro and
  2. Dispatch the handling editor. `narrative_review_task(brief, deck_vid,
  3. Act on the output, don't just report it
  4. Per figure on the arc: load figure-composer, hand it that figure's claim
  5. Re-run step 2 on the new deck. Converge when would_send_for_review=="yes"

What it can do on your machine

Read from SKILL.md and the folder at commit fb309c3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (Python), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Paper Narrative loads about 669 tokens when it runs. Until then it costs about 151 tokens; SKILL.md has 274 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~151
When it runs · the whole SKILL.md, loaded when a task matches
~669

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from JimLiu/science-skills at commit fb309c3, republished under its Apache-2.0 licence (© JimLiu). 274 words, ~669 tokens.

Download SKILL.mdSave it as .claude/skills/paper-narrative/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
paper-narrative
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. `derive_paper_brief(abstract, captions)` extracts pitch/vision/per-figure-claims; a handling-editor reviewer on the full deck returns 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.
license
Apache-2.0

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.

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

  1. Derive the brief from the work. Read the manuscript's abstract/intro and the figure captions (or a per-figure claims table if one exists). Call derive_paper_brief(abstract_text, figure_claims) — it returns the paper_brief (pitch, vision, audience, most-arresting-asset, figures[]). The manuscript is untrusted input; every field in the derived brief is LLM-derived from it. Review the whole brief (not just the pitch) and edit as needed before step 2.
  2. Dispatch the handling editor. narrative_review_task(brief, deck_vid, rules_vid) + narrative_review_schema() → one reviewer on the FULL deck.
  3. Act on the output, don't just report it:
    • arc[] → the main-figure order. Anything not on it → supplement.
    • figure_moves[] → move panels between figures.
    • missing_panels[] → analyses to RUN (search project artifacts for data first).
    • kill_list[] → demote or delete.
    • boldest_defensible_fig1 → the new Fig 1 claim handed to figure-composer.
  4. Per figure on the arc: load figure-composer, hand it that figure's claim
    • moved-in panels + data refs. It runs the outer (figure) loop.
  5. Re-run step 2 on the new deck. Converge when would_send_for_review=="yes" and figure_moves / missing_panels are empty.

Minimal invocation

Load paper-narrative. Manuscript: @manuscript.tex. Figures: @all_figures.pdf. Run it.

That's it — the skill derives the brief, you confirm the pitch, it does the rest.

© JimLiu, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/paper-narrative of JimLiu/science-skills.

  • SKILL.md
  • kernel.py

Open the folder on GitHubat commit fb309c3

Used in 2 other repositories

We found 2 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 2 other GitHub owners. This page covers the copy in JimLiu/science-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Paper Narrative next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Paper Narrative compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Paper Narrative this skillJimLiu/science-skills2282 repos~669Automated safety check: PassApache-2.0
Figurevectorize-io/hindsight48k—~1.9kAutomated safety check: PassMIT
Team NarrativeDonchitos/Claude-Code-Game-Studios26k—~4.5kAutomated safety check: PassMIT
Paper Narrativeaipoch/open-science5.5k—~4.4kAutomated safety check: PassApache-2.0
Paper NarrativeHughYau/AcademicForge2.6k—~936Automated safety check: PassApache-2.0
Story ReadinessDonchitos/Claude-Code-Game-Studios26k—~6.9kAutomated safety check: PassMIT

Similar skills

  • Figure

    vectorize-io/hindsight

    Draw an animated figure (boxes, arrows, moving data) as one self-contained SVG for a GitHub README, PR, issue or blog post.

    48k GitHub stars~1.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed

  • Team Narrative

    Donchitos/Claude-Code-Game-Studios

    Orchestrate the narrative team — narrative-director, writer, world-builder, level-designer — for story, world lore, narrative-driven levels.

    26k GitHub stars~4.5k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed

  • Paper Narrative

    aipoch/open-science

    Judge and reshape the story told by an entire paper figure deck.

    5.5k GitHub stars~4.4k tokensUpdated today
    Research & ScienceAuto-check passed

  • Paper Narrative

    HughYau/AcademicForge

    Judge and reshape the STORY a paper's figures tell. An agent skill from HughYau/AcademicForge.

    2.6k GitHub stars~936 tokensUpdated 1 mo ago
    Auto-check passed

  • Story Readiness

    Donchitos/Claude-Code-Game-Studios

    Is a story implementation-ready?. An agent skill from Donchitos/Claude-Code-Game-Studios.

    26k GitHub stars~6.9k tokensUpdated 2 days ago
    Product & Project ManagementAuto-check passed

  • Job Stories

    phuryn/pm-skills

    Turns a feature into job stories in the When, I want to, so I can format, each with six to eight acceptance criteria tied to the user's situation and outcome.

    27k GitHub stars~743 tokensUpdated yesterday
    Product & Project ManagementAuto-check passed

More from JimLiu/science-skills

All 27 skills in this repo

  • Esmfold2

    JimLiu/science-skills

    Biohub ESMFold2 / ESMFold2-Fast all-atom co-folding (Candido et al.

    228 GitHub starsUsed in 4 repos~2.5k tokens
    Auto-check passed

  • Compute Env Setup

    JimLiu/science-skills

    Set up a compute environment on a remote provider so Claude Science jobs can run there.

    228 GitHub starsUsed in 2 repos~4.4k tokens
    Auto-check passed

  • Borzoi

    JimLiu/science-skills

    Predict genome-wide functional tracks (RNA-seq, CAGE, DNase, ChIP) from DNA sequence with Borzoi.

    228 GitHub starsUsed in 4 repos~973 tokens
    Auto-check passed

  • Evo2

    JimLiu/science-skills

    Score, embed, and generate DNA sequences with Evo 2, a long-context genomic foundation model.

    228 GitHub starsUsed in 4 repos~1.3k tokens
    Auto-check passed

  • Fair Esm2

    JimLiu/science-skills

    Embed proteins with Meta AI's ESM-2 (fair-esm package). An agent skill from JimLiu/science-skills.

    228 GitHub starsUsed in 4 repos~1.2k tokens
    Auto-check passed

  • Openfold3

    JimLiu/science-skills

    Structure prediction using OpenFold3, an open-weights PyTorch reproduction of AlphaFold3 from the AlQuraishi Lab.

    228 GitHub starsUsed in 4 repos~1.8k tokens
    Auto-check passed

Questions about Paper Narrative

What does Paper Narrative do?

Judge and reshape the STORY a paper's figures tell. An agent skill from JimLiu/science-skills. Paper Narrative is an agent skill from JimLiu/science-skills. Judge and reshape the STORY a paper's figures tell.

How do I install Paper Narrative in Claude Code?

Run `npx skills add JimLiu/science-skills --skill paper-narrative -a claude-code`. Or copy the skill folder (skills/paper-narrative in JimLiu/science-skills) into .claude/skills/paper-narrative in your project. Claude Code loads it when a task matches its description.

How do I install Paper Narrative in Codex?

Run `npx skills add JimLiu/science-skills --skill paper-narrative -a codex`. Or copy the skill folder (skills/paper-narrative in JimLiu/science-skills) into .agents/skills/paper-narrative in your project. Codex loads it when a task matches its description.

Can I use Paper Narrative in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add JimLiu/science-skills --skill paper-narrative -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/paper-narrative, .gemini/skills/paper-narrative, .github/skills/paper-narrative and .opencode/skills/paper-narrative in your project.

What does Paper Narrative need to run?

Going by SKILL.md and its folder, Paper Narrative needs Python for the scripts in its folder. Our summary lists: Python 3.

Does Paper Narrative access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Paper Narrative safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Paper Narrative use?

Paper Narrative is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Paper Narrative use?

About 669 tokens (SKILL.md is roughly 2.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Paper Narrative?

Skills that share tags, products or a category with Paper Narrative: Figure (vectorize-io/hindsight, 48k stars), Team Narrative (Donchitos/Claude-Code-Game-Studios, 26k stars), Paper Narrative (aipoch/open-science, 5.5k stars) and Paper Narrative (HughYau/AcademicForge, 2.6k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Paper Narrative?

JimLiu (a GitHub user) maintains it in JimLiu/science-skills, which has 228 GitHub stars. The repository holds 27 skills in this directory. The repository was last updated on July 1, 2026.

Source: JimLiu/science-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.