Source profileQuality 72/100

xuzhougeng/wisp-science/skills/paper-narrative/SKILL.md

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.

Source repository stars
560
Declared platforms
0
Static risk flags
0
Last source update
2026-07-28
Source checked
2026-07-28

Decision brief

What it does—and where it fits

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.

Best for

  • 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.

Not for

  • Tasks that require unconfirmed production actions or broad system permissions.
  • Environments where the pinned source and install steps cannot be inspected.

Compatibility matrix

Platform support, with evidence labels

PlatformStatusEvidenceWhat to check
CodexNot declaredNo explicit evidencePortability before use
Claude CodeNot declaredNo explicit evidencePortability before use
CursorNot declaredNo explicit evidencePortability before use
Gemini CLINot declaredNo explicit evidencePortability before use
Open the compatibility checker

Installation

Inspect first. Install second.

The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.

Source-detected install commandSource
npx skills add https://github.com/xuzhougeng/wisp-science --skill "skills/paper-narrative"
Safe inspection promptEditorial

Inspect the Agent Skill "paper-narrative" from https://github.com/xuzhougeng/wisp-science/blob/95d2c13d1665d46a388b5bdc998dcce0d5ec2eee/skills/paper-narrative/SKILL.md at commit 95d2c13d1665d46a388b5bdc998dcce0d5ec2eee. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.

Workflow

What the source asks the agent to do

  1. 01

    Workflow

    1. Read the abstract, introduction, captions, and concrete figure paths. 2. Build an instruction with paperbrieftask(...). Produce a brief matching paperbriefschema() in the current Agent. If delegatetasks is advertised, the brief may instead be assigned to one reasoning task wi…

    Read the abstract, introduction, captions, and concrete figure paths.Build an instruction with paperbrieftask(...). Produce a brief matchingReview the entire brief. Preserve supplied compositepath values and fix
  2. 02

    Boundaries

    Do not pass artifact markers where a path is required.

    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

Permission review

Static risk signals and limitations

No configured static risk pattern was detected

This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.

Evidence record

Why each signal appears

EvidenceSourceComputedTestedEditorial
SignalValueEvidence typeMeaning
Quality score72/100ComputedDocumentation, specificity, maintenance, and trust rules
Repository stars560SourceRepository attention, not individual Skill quality
Compatibility0 platformsSourceDeclared in the catalog source record
Usage guideautomated source guideEditorialGenerated or reviewed according to the visible evidence level

Pinned source

Provenance and original SKILL.md

Repository
xuzhougeng/wisp-science
Skill path
skills/paper-narrative/SKILL.md
Commit
95d2c13d1665d46a388b5bdc998dcce0d5ec2eee
License
AGPL-3.0
Collected
2026-07-28
Default branch
main
View the original SKILL.md

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

  1. Read the abstract, introduction, captions, and concrete figure paths.
  2. 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.
  3. Review the entire brief. Preserve supplied composite_path values and fix unsupported claims before continuing.
  4. 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(...).
  5. 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().
  6. 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.
  7. 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.

Alternatives

Compare before choosing