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