aipoch/open-science / resources/skills/paper-narrative
paper-narrative
VerifiedJudge 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`.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 17.2 KB |
| kernel.py | script | 3.3 KB |
| open-science.json | config | 301 B |
kernel.py
View on GitHub"""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."""
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |
| 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: 115k | Updated | Claude CodeCodex | Verified | Install |