paper-slide-deck
Some commonly used research experiences and processes are encapsulated into Agent skills.
114 stars19 forksUpdated Jan 22, 2026
npx skills add https://github.com/luwill/research-skills --skill paper-slide-deckSKILL.md
Paper Slide Deck Generator
Transform academic papers and content into professional slide deck images with automatic figure extraction.
Usage
/paper-slide-deck path/to/paper.pdf
/paper-slide-deck path/to/paper.pdf --style academic-paper
/paper-slide-deck path/to/content.md --style sketch-notes
/paper-slide-deck path/to/content.md --audience executives
/paper-slide-deck path/to/content.md --lang zh
/paper-slide-deck path/to/content.md --slides 10
/paper-slide-deck path/to/content.md --outline-only
/paper-slide-deck # Then paste content
Script Directory
Important: All scripts are located in the scripts/ subdirectory of this skill.
Agent Execution Instructions:
- Determine this SKILL.md file's directory path as
SKILL_DIR - Script path =
${SKILL_DIR}/scripts/<script-name>.ts - Replace all
${SKILL_DIR}in this document with the actual path
Script Reference:
| Script | Purpose |
|---|---|
scripts/generate-slides.py | Generate AI slides via Gemini API (Python) |
scripts/merge-to-pptx.ts | Merge slides into PowerPoint |
scripts/merge-to-pdf.ts | Merge slides into PDF |
scripts/detect-figures.ts | Auto-detect figures/tables in PDF |
scripts/extract-figure.ts | Extract figure from PDF page (uses PyMuPDF fallback) |
scripts/apply-template.ts | Apply figure container template |
Options
| Option | Description |
|---|---|
--style <name> | Visual style (see Style Gallery) |
--audience <type> | Target audience: beginners, intermediate, experts, executives, general |
--lang <code> | Output language (en, zh, ja, etc.) |
--slides <number> | Target slide count |
--outline-only | Generate outline only, skip image generation |
Style Gallery
| Style | Description | Best For |
|---|---|---|
academic-paper | Clean professional, precise charts | Conference talks, thesis defense |
blueprint (Default) | Technical schematics, grid texture | Architecture, system design |
chalkboard | Black chalkboard, colorful chalk | Education, tutorials, classroom |
notion | SaaS dashboard, card-based layouts | Product demos, SaaS, B2B |
bold-editorial | Magazine cover, bold typography, dark | Product launches, keynotes |
corporate | Navy/gold, structured layouts | Investor decks, proposals |
dark-atmospheric | Cinematic dark mode, glowing accents | Entertainment, gaming |
editorial-infographic | Magazine explainers, flat illustrations | Tech explainers, research |
fantasy-animation | Ghibli/Disney style, hand-drawn | Educational, storytelling |
intuition-machine | Technical briefing, bilingual labels | Technical docs, academic |
minimal | Ultra-clean, maximum whitespace | Executive briefings, premium |
pixel-art | Retro 8-bit, chunky pixels | Gaming, developer talks |
scientific | Academic diagrams, precise labeling | Biology, chemistry, medical |
sketch-notes | Hand-drawn, warm & friendly | Educational, tutorials |
vector-illustration | Flat vector, retro & cute | Creative, children's content |
vintage | Aged-paper, historical styling | Historical, heritage, biography |
watercolor | Hand-painted textures, natural warmth | Lifestyle, wellness, travel |
Auto Style Selection
| Content Signals | Selected Style |
|---|---|
| paper, thesis, defense, conference, ieee, acm, icml, neurips, cvpr, acl, aaai, iclr | academic-paper |
| tutorial, learn, education, guide, intro, beginner | sketch-notes |
| classroom, teaching, school, chalkboard, blackboard | chalkboard |
| architecture, system, data, analysis, technical | blueprint |
| creative, children, kids, cute, illustration | vector-illustration |
| briefing, bilingual, infographic, concept | intuition-machine |
| executive, minimal, clean, simple, elegant | minimal |
| saas, product, dashboard, metrics, productivity | notion |
| investor, quarterly, business, corporate, proposal | corporate |
| launch, marketing, keynote, bold, impact, magazine | bold-editorial |
| entertainment, music, gaming, creative, atmospheric | dark-atmospheric |
| explainer, journalism, science communication | editorial-infographic |
| story, fantasy, animation, magical, whimsical | fantasy-animation |
| gaming, retro, pixel, developer, nostalgia | pixel-art |
| biology, chemistry, medical, pathway, scientific | scientific |
| history, heritage, vintage, expedition, historical | vintage |
| lifestyle, wellness, travel, artistic, natural | watercolor |
| Default | blueprint |
Layout Gallery
Optional layout hints for individual slides. Specify in outline's // LAYOUT section.
Slide-Specific Layouts
| Layout | Description | Best For |
|---|---|---|
title-hero | Large centered title + subtitle | Cover slides, section breaks |
quote-callout | Featured quote with attribution | Testimonials, key insights |
| `key-st |
...
Repository
luwill/research-skillsParent repository
Repository Stats
Stars114
Forks19