How stagsz/paper-explainer works
Paper Explainer is a Claude skill for turning a research paper into decision-ready materials: an interactive page and a verdict-first brief. Its documented workflow reads the paper, evaluates evidence, translates findings into operational implications, creates the appropriate interactive explanation, then checks claims against extracted numbers. The README describes the skill process, but SKILL.md was not sampled, so detailed step-to-step implementation links are omitted. The PDF extractor’s outputs and fallback backends are supported by source.
Main entry points: SKILL.md Explainer skill · extract_paper.py PDF extractor · extraction-sheet.md Extraction sheet · evaluation-rubric.md Evaluation rubric
Components 18
Paper analysis
- Explainer skill
SKILL.md - Full paper
- Read evidence
SKILL.md - Appraise evidence
SKILL.md - Translate findings
SKILL.md - Number cross-check
SKILL.md
Reference guidance
- Extraction sheet
references/extraction-sheet.md - Evaluation rubric
references/evaluation-rubric.md - Visualization patterns
references/visualization-patterns.md - Brief template
references/brief-template.md
PDF extraction
- PDF extractor
scripts/extract_paper.py - Full-text dump
- Page index
- Numbers table
Decision materials
- Interactive page
SKILL.md - Two-page brief
SKILL.md
Other components
- Paper provider
- Decision-maker
Connections 20
- Paper provider → Explainer skill: provides paper
- Explainer skill → Read evidence: guides reading
- Read evidence → Full paper: reads fully
- Explainer skill → Appraise evidence: guides appraisal
- Appraise evidence → Evaluation rubric: uses criteria
- Read evidence → Extraction sheet: records evidence
- Explainer skill → Translate findings: guides translation
- Translate findings → Interactive page: informs page
- Interactive page → Visualization patterns: uses patterns
- Explainer skill → Two-page brief: produces brief
- Two-page brief → Brief template: uses structure
- Explainer skill → Number cross-check: guides checking
- Number cross-check → Extraction sheet: checks figures
- Decision-maker → Two-page brief: uses decision brief
- Decision-maker → Interactive page: operates page
- Paper provider → PDF extractor: supplies PDF
- PDF extractor → Full-text dump: writes text
- PDF extractor → Page index: writes index
- PDF extractor → Numbers table: writes numbers
- Numbers table → Number cross-check: supports cross-check