中文 | English

---

paper2ppt-skill

Generate academic literature review PPT from paper URL/DOI/PMID

A Claude Code Skill that generates a professional academic literature review PPT from a paper identifier. Slide count adapts to paper content.

Features

• Multiple input formats: DOI, PMID, PMCID, paper URL, local PDF path, title search
• Paper verification: Cross-validates between CrossRef and NCBI to avoid wrong papers
• Auto metadata: title, authors, journal, date, abstract from CrossRef
• Impact Factor & JCR quartile: via WebSearch
• Figure extraction: from publisher HTML or embedded PDF images via PyMuPDF
• Table extraction: pdfplumber structured extraction, screenshot with fallback
• Hybrid mode: online metadata + local PDF content (bypasses paywalls)
• 4 design templates: Navy (default), Teal (medical), Slate (tech), Nature Dark (premium)
• Graceful fallbacks: text-only layout when figures unavailable; never crashes

Installation

cd .claude/skills/
git clone https://github.com/ablikimeli/paper2ppt-skill.git paper2ppt

Dependencies

npm install -g pptxgenjs          # PPT generation
pip install "markitdown[pptx]"    # Content QA (optional)
pip install pymupdf               # PDF fallback (optional)

Usage

Invoke in Claude Code:

# By DOI (default navy template)
/paper2ppt 10.1186/s12913-026-14482-6 please make a literature review PPT

# Select a template
/paper2ppt -t teal 10.1186/s12913-026-14482-6
/paper2ppt --template nature PMID: 13170306
/paper2ppt -t slate "paper title"

# By PMID
/paper2ppt PMID: 13170306

# By PMCID
/paper2ppt PMCID: PMC13170306

# By paper URL
/paper2ppt https://doi.org/10.1186/s12913-026-14482-6

# By title search
/paper2ppt "latent tuberculosis infection cost-effectiveness China"

PPT Structure

Slide count adapts to content. These are the required sections:

Section	Slides	Description
Title Slide	1	Paper info, IF, JCR quartile, DOI
Table of Contents	1	Navigation
Background & Objectives	1-2	Rationale, gap, objectives
Methods & Materials	1-3	Design, population, analysis
Results	1-4	Key findings + figures/tables
Discussion & Conclusion	1-2	Main findings, limitations
Inspirations	1	Implications & future directions
End Page	1	Thank you / Q&A

Each major finding gets its own slide. Simple papers: 8-9 slides. Complex papers: 15+ slides.

Input Sources

Type	Example	Method
DOI	10.1186/s12913-026-14482-6	Direct
PMID	13170306 / PMID: 13170306	NCBI API to DOI
PMCID	PMC13170306 / PMCID: PMC13170306	NCBI API to DOI
URL	https://doi.org/...	Auto-detect
Title	"paper title"	CrossRef / PubMed / Google Scholar

Design Templates

Template	Alias	Style
Academic Navy	navy (default)	Deep navy + gold, decorative circles, serif titles
Academic Teal	teal	Purple + pink, overlapping circles, diamond accents, medical
Slate Modern	slate	Slate + vermillion, triangle corner cuts, chevrons, tech
Nature Dark	nature	Warm ivory + muted blue/gold, geometric dot line art, premium

/paper2ppt -t teal 10.1186/s12913-026-14482-6

File Structure

paper2ppt/
├── SKILL.md                          # Entry point & workflow (890 lines)
├── README.md                         # English readme
├── README.zh.md                      # Chinese readme
├── references/
│   └── publisher_patterns.md         # Publisher-specific extraction patterns (362 lines)
└── templates/
    ├── academic-navy.md              # Navy + orange (color‑blind friendly)
    ├── academic-teal.md              # Teal + pink
    ├── slate-modern.md               # Slate + vermillion, geometric
    ├── nature-dark.md                # Midnight + sky blue/orange, premium
    └── samples/
        ├── generate_all.js           # Sample PPTX generator
        ├── template_navy.pptx
        ├── template_teal.pptx
        ├── template_slate.pptx
        └── template_nature.pptx

Design Standards

All templates use color‑blind friendly palettes (Wong 2011 Nature Methods) — distinguishable by protanopia, deuteranopia, and tritanopia. Each template enriches slides with decorative shapes (circles, diamonds, triangles), accent bars, and card elements.

Rule	Detail
Colors	4 color‑blind friendly palettes, never red‑green alone, shapes reinforce color
Font	Georgia serif (navy/nature) or Arial (teal/slate), body 18pt
Layout	Action title + divider + content, decorative accent elements
Figures	Left-right layout, aspect-ratio preserved
Tables	Colored header, alternating row colors, clean border

Error Recovery

Failure	Recovery
CrossRef unreachable	Fallback to NCBI E-utilities / WebSearch
Figure download fails	Skip figure, use text-only layout
PDF download fails	Text-only PPT
IF/JCR not found	Show "N/A", never fabricate
Script syntax error	Fix per Node.js error, re-run

License

MIT