SkillAgentSearch skills...

paper-slide-deck

Generate professional slide deck images from academic papers and content. Creates comprehensive outlines with style instructions, auto-detects figures from PDFs, then generates individual slide images

Install / Use

npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill paper-slide-deck

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

95/100

Supported Platforms

Universal

Our assessment of paper-slide-deck

paper-slide-deck scores 95/100 on our quality scale, 46th of 421 Education & Research skills we index (top 11%).

Its SKILL.md is 19 KB long, well organised into 37 sections with 5 code examples: a thorough specification that gives an agent plenty to work with.

With 4,360 GitHub stars, it is one of the more widely adopted skills in the catalogue.

Substance
30/30
Structure
20/20
Description
15/15
Adoption
15/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so paper-slide-deck is actively maintained.
  • Our last check on 2026-11-15 found the source still online.
  • No license is declared. By default that means all rights are reserved: you can read it, but reusing or redistributing it is not clearly permitted. Ask the author before building on it commercially.
  • Its trust signals score 88/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-09-29. Automated pattern scan on 2026-09-28. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

paper-slide-deck compared with similar skills

All 4 of these similar skills score higher than paper-slide-deck; compare them before choosing.

SkillScoreStarsUpdatedFormat
paper-slide-deck (this skill)by brycewang-stanford954.4k54d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
last30days-skillby mvanhorn10068.0ktodayCLAUDE.md
LocalAIby mudler10050.4ktodayMCP Server
x402by browser-use100121.0k3d agoSKILL.md

Frequently asked questions

How do I install paper-slide-deck?
Run npx skills add brycewang-stanford/Auto-Empirical-Research-Skills --skill paper-slide-deck. The install tabs above show the steps for each supported agent.
Which AI agents does paper-slide-deck work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is paper-slide-deck safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It declares no license and scores 88/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is paper-slide-deck still maintained?
The repository was last updated about 2 months ago, so paper-slide-deck is actively maintained.

name: paper-slide-deck description: Generate professional slide deck images from academic papers and content. Creates comprehensive outlines with style instructions, auto-detects figures from PDFs, then generates individual slide images. Use when user asks to "create slides", "make a presentation", "generate deck", or "slide deck" for papers.

<!-- ╔══════════════════════════════════════════════════════════════╗ ║ 本文件为开源 Skill 原始文档,收录仅供学习与研究参考 ║ ║ CoPaper.AI 收集整理 | https://copaper.ai ║ ╚══════════════════════════════════════════════════════════════╝ 来源仓库: https://github.com/luwill/research-skills 项目名称: research-skills 开源协议: MIT License 收录日期: 2026-04-02 声明: 本文件版权归原作者所有。此处收录旨在为社会科学实证研究者 提供 AI Agent Skills 的集中参考。如有侵权,请联系删除。 -->

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:

  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 | | 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-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:

slide-deck/{topic-slug}/
├── source-{slug}.{ext}    # Source files (text, images, etc.)
├── outline.md
├── outline-{style}.md     # Style variant outlines
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

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:
    npx -y bun ${SKILL_DIR}/scripts/detect-figures.ts --pdf source-paper.pdf --output figures.json
    
    This outputs a JSON file with all detected figures/tables, their page numbers, and captions.

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) | | Language | Only if source ≠ user language |

After selection:

  • Copy selected outline-{style}.md to outline.md
  • Regenerate in different language if requested
  • User may edit outline.md for fine-tuning

If --outline-only, stop here.

Step 4: Generate Prompts

  1. Read references/base-prompt.md
  2. Combine with style instructions from outline
  3. Add slide-specific content
  4. If Layout: specified in outline, include layout guidance in prompt:
    • Reference layout characteristics for image composition
    • Example: Layout: hub-spoke → "Central concept in middle with related items radiating outward"
  5. Save to prompts/ directory

Step 5: Image Generation Method Selection

Before generating images, ask use

Truncated for display — read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars4.4k
CategoryEducation
Updated1mo ago
Forks527

Languages

Stata

Trust signals

88/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

1 medium