Skip to content

aipoch/open-science / resources/skills/paper-narrative

paper-narrative

Verified

Judge and reshape the story told by an entire paper figure deck. Use when writing or revising a paper to derive a grounded brief from the manuscript and captions, review the full deck as a handling editor, and hand an ordered figure arc to `figure-composer`.

FileKindSize
SKILL.mdskill md17.2 KB
kernel.pyscript3.3 KB
open-science.jsonconfig301 B
"""Deterministic public helpers for the paper-narrative Skill."""


def paper_brief_schema():
    return {"type":"object","properties":{
        "pitch":{"type":"string"},"vision":{"type":"string"},
        "audience":{"type":"string"},"most_arresting_asset":{"type":"string"},
        "figures":{"type":"array","items":{"type":"object","properties":{
            "key":{"type":"string"},"claim":{"type":"string"},
            "composite_vid":{"type":"string"}},"required":["key","claim"]}}},
        "required":["pitch","vision","figures"]}


def narrative_review_schema():
    return {"type":"object","properties":{
        "hook_verdict":{"type":"object","properties":{
            "would_send_for_review":{"type":"string","enum":["yes","weak","no"]},
            "why":{"type":"string"},"fig1_is":{"type":"string"},
            "fig1_should_be":{"type":"string"}},
            "required":["would_send_for_review","why","fig1_is","fig1_should_be"]},
        "figure_moves":{"type":"array","items":{"type":"object","properties":{
            "what":{"type":"string"},"from_fig":{"type":"string"},
            "to_fig":{"type":"string"},"why":{"type":"string"}},
            "required":["what","from_fig","to_fig","why"]}},
        "missing_panels":{"type":"array","items":{"type":"object","properties":{
            "target_fig":{"type":"string"},"what_to_show":{"type":"string"},
            "analysis_needed":{"type":"string"},"data_hint":{"type":"string"}},
            "required":["target_fig","what_to_show","analysis_needed","data_hint"]}},
        "kill_list":{"type":"array","items":{"type":"object","properties":{
            "what":{"type":"string"},"why":{"type":"string"},
            "demote_to":{"type":"string","enum":["supplement","caption","delete"]}},
            "required":["what","why","demote_to"]}},
        "arc":{"type":"array","items":{"type":"object","properties":{
            "fig":{"type":"string"},"role":{"type":"string",
                "enum":["hook","mechanism","evidence","application","supplement"]},
            "one_line":{"type":"string"}},"required":["fig","role","one_line"]}},
        "boldest_defensible_fig1":{"type":"string"}},
        "required":["hook_verdict","figure_moves","missing_panels","kill_list","arc",
                    "boldest_defensible_fig1"]}


def narrative_review_task(brief, deck_vid, rules_vid):
    fig_tbl = "\n".join(f"  {f.get('key','?')}: {f.get('claim') or f.get('caption','')}"
                        for f in brief.get("figures", []))
    return f"""You are the HANDLING EDITOR for this submission. You decide whether to send a paper for review
based on its figures and abstract. Judge STORY, not craft.

## Paper brief
**Pitch:** {brief.get('pitch','—')}
**Vision:** {brief.get('vision','—')}
**Audience:** {brief.get('audience','general scientist')}
**Most arresting asset:** {brief.get('most_arresting_asset','—')}

## All figures (one PDF)
`{{{{artifact:{deck_vid}}}}}`

## Per-figure claims
{fig_tbl}

## Design rules (reference only; do NOT grade craft)
`{{{{artifact:{rules_vid}}}}}`

## Your job (§7.5)
Hook test (would Fig 1 alone make you send this out?); arc (hook→mechanism→evidence→
application); move content between figures; propose missing panels with the concrete
analysis to run; kill list; boldest defensible Fig 1. Be opinionated — the author wants
a partner, not a grader. Return ONLY structured output."""
add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks.Stars: 115kUpdated Claude CodeCodexVerifiedInstall