paper-slide-deck
Use when the user wants visually striking, shareable slide-deck IMAGES from any content — an article, blog post, topic, or paper — where look-and-feel matters more than editable precision (风格化幻灯/小红书配图/公众号配图/视觉化海报), optimized for reading and social sharing rather than live presentation. Offers 17 T2I
By luwill · 477 installs
npx skills add luwill/research-skills --skill paper-slide-deck
Source repository · Upstream listing
Paper Slide Deck Generator
Transform academic papers and content into professional slide deck images with automatic figure extraction.
Usage
Setup (one time)
The TypeScript scripts ( merge to , detect figures , extract figure ,
apply template ) need Node dependencies. Install them once:
This installs canvas , pdfjs dist , pptxgenjs , and pdf lib (a package lock.json
pins versions). If a script exits with missing Node dependency "<name " , run the
command above. The Python generator ( generate slides.py ) auto installs google genai
on first run.
Also install PyMuPDF ( pip install pymupdf ) — it is the reliable fallback for
extracting figures from pages that embed bitmaps (X rays, CAM heatmaps, photographs),
where the pdfjs + canvas path in extract figure.ts fails with
Error: Image or Canvas expected . For medical imaging papers this is the common case,
not the exception, so treat PyMuPDF as required, not optional.
Image generation & no API key path
Image generation needs either a GOOGLE API KEY / GEMINI API KEY (Gemini API) or the
Gemini Web skill. If no key and no web option is available, the skill still works in
a degraded mode — do not abort:
1. Run with outline only to produce the outline + prompts (no images).
2. For a source PDF, extract real figures/tables with detect figures.ts +
extract figure.ts + apply template.ts (no API key needed — pure rendering).
3. Merge whatever slides exist ( extract sourced pages) into PPTX/PDF, and hand the
prompts/ back to the user to generate images later when a key is available.
Script Directory
Important : All scripts are located in the scripts/ subdirectory of this skill.
Agent Execution Instructions :
1. Determine this SKILL.md file's directory path as SKILL DIR
2. Script path = ${SKILL DIR}/scripts/<script name .ts
3. 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 (heuristic; verify pages)
scripts/extract figure.ts Render a full PDF page to PNG (optional crop ; 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 Academic style visuals, technical handouts (for a faithful editable talk use scholar slides)
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
Academic signal caution : When the content matches academic paper signals (paper/thesis/neurips/cvpr/icml/…), this skill still bakes text into an image, so equations, result tables, and exact numbers may be garbled . Extract real figures/tables from the source PDF ( Source: extract ) rather than letting the model redraw them, and if the deck needs faithful, editable formulas/data, tell the user to use scholar slides instead.
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 stat Single large number as focal point Impact statistics, metrics
split screen Half image, half text Feature highlights, comparisons
icon grid Grid of icons with labels Features, capabilities, benefits
two columns Content in balanced columns Paired information, dual points
three columns Content in three columns Triple comparisons, categories
image caption Full bleed image + text overlay Visual storytelling, emotional
agenda Numbered list with highlights Session overview, roadmap
bullet list Structured bullet points Simple content, lists
Infographic Derived Layouts
Layout Description Best For
linear progression Sequential flow left to right Timelines, step by step
binary comparison Side by side A vs B Before/after, pros cons
comparison matrix Multi factor grid Feature comparisons
hierarchical layers Pyramid or stacked levels Priority, importance
hub spoke Central node with radiating items Concept maps, ecosystems
bento grid Varied size tiles Overview, summary
funnel Narrowing stages Conversion, filtering
dashboard Metrics with charts/numbers KPIs, data display
venn diagram Overlapping circles Relationships, intersections
circular flow Continuous cycle Recurring processes
winding roadmap Curved path with milestones Journey, timeline
tree branching Parent child hierarchy Org charts, taxonomies
iceberg Visible vs hidden layers Surface vs depth
bridge Gap with connection Problem solution
Academic Specific Layouts
Layout Description Best For
paper title Title, authors, affiliations, venue Conference paper cover
outline agenda Numbered section list with highlights Talk structure overview
methods diagram Central architecture/pipeline diagram Methods, system design
results chart Chart area + data annotations Quantitative results
equation focus Centered equation + variable definitions Mathematical derivations
qualitative grid 2x2 or 3x2 image comparison grid Visual results, ablations
references list Numbered citation list Key references slide
contributions Numbered contribution points Contributions summary
Usage : Add Layout: <name in slide's // LAYOUT section to guide visual composition.
Design Philosophy
This deck is designed for reading and sharing , not live presentation:
Each slide must be self explanatory without verbal commentary
Structure content for logical flow when scrolling
Include all necessary context within each slide
Optimize for social media sharing and offline reading
File Management
Output Directory
Each session creates an independent directory named by content slug:
Slug Generation :
1. Extract main topic from content (2 4 words, kebab case)
2. Example: "Introduction to Machine Learning" → intro machine learning
Conflict Resolution
If slide deck/{topic slug}/ already exists:
Append timestamp: {topic slug} YYYYMMDD HHMMSS
Example: intro ml exists → intro ml 20260118 143052
Source Files
Copy all sources with naming source {slug}.{ext} :
source article.md (main text content)
source diagram.png (image from conversation)
source data.xlsx (additional file)
Multiple sources supported: text, images, files from conversation.
Workflow
Step 1: Analyze Content
1. Save source content (if pasted, save as source.md )
2. Follow references/analysis framework.md for deep content analysis
3. Determine style (use style or auto select from signals)
4. Detect languages (source vs. user preference)
5. Plan slide count ( slides or dynamic)
6. For academic papers (PDF with figures) : Run automatic figure detection:
This outputs a JSON file with all detected figures/tables, their page numbers, and captions.
Caption detection is heuristic — verify, especially the first page teaser. The
line anchored Figure N matcher reliably finds captions that sit on their own line
(single column layouts), but misses figures whose caption is interleaved with body
text on a two column first page — which is often the paper's most important
architecture/overview figure. After running detect figures, cross check the source's
Figure 1 explicitly: if the paper's text references a Figure N that is absent from
figures.json , add it manually via an // IMAGE SOURCE block and extract it with the
PyMuPDF fallback. Do not assume figures.json is complete.
Step 2: Generate Outline Variants
1. Generate 3 style variant outlines based on content analysis
2. Follow references/outline template.md for structure
3. Auto populate IMAGE SOURCE for academic papers:
Read figures.json from Step 1
Map figures to slides using rules in references/analysis framework.md Section 8
Automatically add // IMAGE SOURCE blocks to appropriate slides:
Architecture/pipeline figures → Methods slides ( Source: extract )
Results tables → Quantitative results slides ( Source: extract )
Comparison images → Qualitative results slides ( Source: extract )
Conceptual/simple diagrams → Leave for AI generation ( Source: generate or omit)
4. Save as outline {style}.md for each variant
Step 3: User Confirmation
Single AskUserQuestion with all applicable options:
Question When to Ask
Style variant Always (3 options + custom)
Languag