SkillAgentSearch skills...

paper-slides

Generate conference presentation slides (beamer LaTeX โ†’ PDF + editable PPTX) from a compiled paper, with speaker notes and full talk script

Install / Use

npx skills add wanshuiyin/Auto-claude-code-research-in-sleep --skill paper-slides

Installs into whichever agent you are using.

About this skill
๐Ÿ“„

SKILL.md

Installable skill definition

Quality Score

98/100

Supported Platforms

OpenAI Codex

Our assessment of paper-slides

paper-slides scores 98/100 on our quality scale, 80th of 4,700 Development & Engineering skills we index (top 2%).

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

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

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

Maintenance, license and trust

  • The repository was last updated 2 days ago, so paper-slides is actively maintained.
  • Our last check on 2026-11-14 found the source still online.
  • It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
  • Its trust signals score 100/100, with no cautions. 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-28. 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-slides compared with similar skills

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

SkillScoreStarsUpdatedFormat
paper-slides (this skill)by wanshuiyin9819.2k2d agoSKILL.md
taste-skillby Leonxlnx100116.8k8d agoCLAUDE.md
Agent-Reachby Panniantong100112.3k8d agoCLAUDE.md
rufloby ruvnet10081.9ktodayCLAUDE.md
headroomby headroomlabs-ai10079.8ktodayCLAUDE.md

Frequently asked questions

How do I install paper-slides?
Run npx skills add wanshuiyin/Auto-claude-code-research-in-sleep --skill paper-slides. The install tabs above show the steps for each supported agent.
Which AI agents does paper-slides work with?
It is written for OpenAI Codex, as a SKILL.md file. Other agents that read the same format can often use it too.
Is paper-slides 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 is MIT-licensed and scores 100/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-slides still maintained?
The repository was last updated 2 days ago, so paper-slides is actively maintained.

name: paper-slides description: "Generate conference presentation slides (beamer LaTeX โ†’ PDF + editable PPTX) from a compiled paper, with speaker notes and full talk script. Use when user says "ๅšPPT", "ๅšๅนป็ฏ็‰‡", "make slides", "conference talk", "presentation slides", "็”Ÿๆˆslides", "ๅ†™ๆผ”่ฎฒ็จฟ", or wants beamer slides for a conference talk." argument-hint: "[paper-directory-or-talk-length] [โ€” style-ref: <source>]" allowed-tools: Bash(*), Read, Write, Edit, Grep, Glob, mcp__codex__codex, mcp__codex__codex-reply

Paper Slides: From Paper to Conference Talk

Generate conference presentation slides from: $ARGUMENTS

Context

This skill runs after Workflow 3 (/paper-writing). It takes a compiled paper and generates a presentation slide deck for conference oral talks, spotlight presentations, or poster lightning talks.

Unlike posters (single page, visual-first), slides tell a temporal story: each slide builds on the previous one, with progressive revelation of the research narrative. A good talk makes the audience understand why this matters before showing what was done.

Constants

  • VENUE = NeurIPS โ€” Target venue, determines color scheme. Supported: NeurIPS, ICML, ICLR, AAAI, ACL, EMNLP, CVPR, ECCV, GENERIC. Override via argument.
  • TALK_TYPE = spotlight โ€” Talk format. Options: oral (15-20 min), spotlight (5-8 min), poster-talk (3-5 min), invited (30-45 min). Determines slide count and content depth.
  • TALK_MINUTES = 15 โ€” Talk duration in minutes. Auto-adjusts slide count (~1 slide/minute for oral, ~1.5 slides/minute for spotlight). Override explicitly if needed.
  • ASPECT_RATIO = 16:9 โ€” Slide aspect ratio. Options: 16:9 (default, modern projectors), 4:3 (legacy).
  • SPEAKER_NOTES = true โ€” Generate \note{} blocks in beamer and corresponding PPTX notes. Set false for clean slides without notes.
  • PAPER_DIR = paper/ โ€” Directory containing the compiled paper.
  • OUTPUT_DIR = slides/ โ€” Output directory for all slide files.
  • REVIEWER_MODEL = gpt-6-astra โ€” Model used via Codex MCP for slide review.
  • AUTO_PROCEED = false โ€” At each checkpoint, always wait for explicit user confirmation.
  • COMPILER = latexmk โ€” LaTeX build tool.
  • ENGINE = pdflatex โ€” LaTeX engine. Use xelatex for CJK text.

๐Ÿ’ก Override: /paper-slides "paper/" โ€” talk_type: oral, venue: ICML, minutes: 20, aspect: 4:3

Optional: Style reference (โ€” style-ref: <source>, opt-in)

Lets the user steer the talk's structural rhythm (story beats, theorem density, figure density inherited from the source paper) toward a reference paper. Default OFF โ€” when the user does not pass โ€” style-ref, do nothing differently from before.

Only when โ€” style-ref: <source> appears in $ARGUMENTS, run the helper FIRST:

# Resolve $STYLE_HELPER via the canonical strict-safe chain (see
# shared-references/integration-contract.md ยง2). Policy A โ€” gate:
# unresolved helper means --style-ref cannot be satisfied, so abort.
cd "$(git rev-parse --show-toplevel 2>/dev/null || pwd)" || exit 1
if [ -z "${ARIS_REPO:-}" ] && [ -f .aris/installed-skills.txt ]; then
    ARIS_REPO=$(awk -F'\t' '$1=="repo_root"{print $2; exit}' .aris/installed-skills.txt 2>/dev/null) || true
fi
if [ -z "${ARIS_REPO:-}" ] && [ -f "$HOME/.aris/repo" ]; then
    ARIS_REPO=$(cat "$HOME/.aris/repo" 2>/dev/null) || true
fi
STYLE_HELPER=".aris/tools/extract_paper_style.py"
[ -f "$STYLE_HELPER" ] || STYLE_HELPER="tools/extract_paper_style.py"
[ -f "$STYLE_HELPER" ] || { [ -n "${ARIS_REPO:-}" ] && STYLE_HELPER="$ARIS_REPO/tools/extract_paper_style.py"; }
[ -f "$STYLE_HELPER" ] || {
  echo "ERROR: extract_paper_style.py not resolved at .aris/tools/, tools/, \$ARIS_REPO/tools/, or via ~/.aris/repo." >&2
  echo "       Fix: rerun bash tools/install_aris.sh or smart_update.sh (refreshes ~/.aris/repo), export ARIS_REPO, or copy the helper to tools/." >&2
  echo "       --style-ref cannot be satisfied; aborting." >&2
  exit 1
}
STYLE_STATUS=0
CACHE=$(python3 "$STYLE_HELPER" --source "<source>") || STYLE_STATUS=$?
case "$STYLE_STATUS" in
  0) ;;                                       # use $CACHE/style_profile.md as structural guidance
  2) echo "warning: style-ref skipped (missing optional dep)" >&2 ;;
  3) echo "error: --style-ref source failed; aborting slides" >&2 ; exit 1 ;;
  *) echo "error: helper failed unexpectedly; aborting slides" >&2 ; exit 1 ;;
esac

Sources accepted: local TeX dir / file, local PDF, arXiv id, http(s) URL. Overleaf URLs/IDs are rejected โ€” clone via /overleaf-sync setup <id> first and pass the local clone path.

Strict rules (full contract in tools/extract_paper_style.py docstring):

  • Use style_profile.md to align section-budget tendency and theorem-environment density. Talk-type slide count above still takes precedence.
  • Never copy speaker-note prose, slide titles, or examples from anything reachable through the cache. The talk content is from the user's paper, not the reference.
  • Never pass โ€” style-ref (or the cache contents) to the GPT-6-Astra reviewer sub-agent โ€” the reviewer must judge the talk's clarity on its own merits.

Talk Type โ†’ Slide Count

| Talk Type | Duration | Slides | Content Depth | |-----------|----------|:------:|---------------| | poster-talk | 3-5 min | 5-8 | Problem + 1 method slide + 1 result + conclusion | | spotlight | 5-8 min | 8-12 | Problem + 2 method + 2 results + conclusion | | oral | 15-20 min | 15-22 | Full story with motivation, method detail, experiments, analysis | | invited | 30-45 min | 25-40 | Comprehensive: background, related work, deep method, extensive results, discussion |

Venue Color Schemes

Same as /paper-poster-html:

| Venue | Primary | Accent | Background | Text | |-------|---------|--------|------------|------| | NeurIPS | #8B5CF6 | #2563EB | #FFFFFF | #1E1E1E | | ICML | #DC2626 | #1D4ED8 | #FFFFFF | #1E1E1E | | ICLR | #059669 | #0284C7 | #FFFFFF | #1E1E1E | | CVPR | #2563EB | #7C3AED | #FFFFFF | #1E1E1E | | GENERIC | #334155 | #2563EB | #FFFFFF | #1E1E1E |

State Persistence (Compact Recovery)

Persist state to slides/SLIDES_STATE.json after each phase:

{
  "phase": 3,
  "venue": "NeurIPS",
  "talk_type": "spotlight",
  "slide_count": 10,
  "codex_thread_id": "019cfcf4-...",
  "status": "in_progress",
  "timestamp": "2026-03-18T15:00:00"
}

On startup: if SLIDES_STATE.json exists with "status": "in_progress" and within 24h โ†’ resume. Otherwise โ†’ fresh start.

Workflow

Phase 0: Input Validation & Setup

  1. Check prerequisites:

    which pdflatex && which latexmk
    
  2. Verify paper exists:

    ls $PAPER_DIR/main.tex || ls $PAPER_DIR/main.pdf
    ls $PAPER_DIR/sections/*.tex
    ls $PAPER_DIR/figures/
    
  3. Backup existing slides: if slides/ exists, copy to slides-backup-{timestamp}/

  4. Create output directory: mkdir -p slides/figures

  5. Detect CJK: if paper contains Chinese/Japanese/Korean, set ENGINE to xelatex

  6. Determine slide count: from TALK_TYPE and TALK_MINUTES using the table above

  7. Check for resume: read slides/SLIDES_STATE.json if it exists

State: Write SLIDES_STATE.json with phase: 0.

Phase 1: Content Extraction & Slide Outline

Read paper/sections/*.tex and build a slide-by-slide outline.

Slide template by talk type:

Oral (15-22 slides)

| Slide | Purpose | Content Source | Figure? | |:-----:|---------|----------------|:-------:| | 1 | Title | Paper metadata | No | | 2 | Outline | Section headers | No | | 3-4 | Motivation & Problem | Introduction | Optional | | 5 | Key Insight | Introduction (contribution) | No | | 6-9 | Method | Method section | Yes (hero figure) | | 10-14 | Results | Experiments | Yes (per slide) | | 15-16 | Analysis / Ablations | Experiments | Yes | | 17 | Limitations | Conclusion | No | | 18 | Conclusion / Takeaway | Conclusion | No | | 19 | Thank You + QR | โ€” | QR code |

Spotlight (8-12 slides)

| Slide | Purpose | Content Source | Figure? | |:-----:|---------|----------------|:-------:| | 1 | Title | Paper metadata | No | | 2-3 | Problem + Why It Matters | Introduction | Optional | | 4 | Key Insight | Contribution | No | | 5-6 | Method | Method (condensed) | Yes (hero) | | 7-9 | Results | Key results only | Yes | | 10 | Takeaway | Conclusion | No | | 11 | Thank You + QR | โ€” | QR code |

Poster-talk (5-8 slides)

| Slide | Purpose | Content Source | Figure? | |:-----:|---------|----------------|:-------:| | 1 | Title | Paper metadata | No | | 2 | Problem | Introduction (1 slide) | No | | 3 | Method | Method (1 slide) | Yes | | 4-5 | Results | Key result only | Yes | | 6 | Takeaway + QR | Conclusion | QR |

For each slide, specify:

  • Title (max 8 words)
  • 3-5 bullet points (max 8 words each)
  • Figure reference (if any) from paper/figures/
  • Speaker note (2-3 sentences of what to say)
  • Time allocation (in seconds)

Output: slides/SLIDE_OUTLINE.md

๐Ÿšฆ Checkpoint:

๐Ÿ“Š Slide outline ready:
- Talk type: [TALK_TYPE] ([TALK_MINUTES] min)
- Slide count: [N] slides
- Figures used: [N] from paper/figures/
- Time budget: [breakdown]

Slide-by-slide outline:
1. [Title slide]
2. [Motivation โ€” 1.5 min]
3. [Problem statement โ€” 1 min]
...

Proceed to drafting? Or adjust the outline?

โ›” STOP HERE and wait for user response. This is the most critical checkpoint โ€” the outline determines the entire talk flow.

Options:

  • "go" โ†’ proceed to Phase 2
  • adjustments (e.g., "merge slides 3-4", "add a demo slide", "cut the ablation") โ†’ revise
  • "stop" โ†’ save to slides/SLIDE_OUTLINE.md

State: Write SLIDES_STATE.json with phase: 1.

Phase 2: Slide-by-Slide Content Drafting

For each slide in the outline, draft the actual content.

Presentation rules (enforced strictly):

| Rule | Rationale | |------|-----------| | One message per slide | If a slide has two ideas, split it | | Max 6 lines per slide | More than 6 lines = wall of text | | Max 8 words per line | Audience reads, not listens, if text is long | | Sentence fragments, not sentences | "Improves F1 by 3.2%" not "Our method improves the F1 score by 3.2 percentage points" | | Figure slides: figure โ‰ฅ60% area | The figure IS the content; bullets are annotations | | Bold key numbers | "Achieves 94.3% accuracy" | | Progressive disclosure | Use \pause or \onslide for complex slides | | No Related Work slide | Unless invited talk (30+ min) |

For each slide, produce:

  1. \frametitle{}
  2. Content (itemize or figure + caption)
  3. \note{} with speaker text (if SPEAKER_NOTES=true)

Phase 3: Generate Slides LaTeX

Create slides/main.tex using beamer.

Template structure:

\documentclass[aspectratio=169]{beamer}

% Venue theme
\usepackage{xcolor}
\definecolor{primary}{HTML}{VENUE_PRIMARY}
\definecolor{accent}{HTML}{VENUE_ACCENT}

% Clean theme
\usetheme{default}
\usecolortheme{default}
\setbeamercolor{frametitle}{fg=primary}
\setbeamercolor{title}{fg=primary}
\setbeamercolor{structure}{fg=accent}
\setbeamercolor{itemize item}{fg=primary}
\setbeamercolor{itemize subitem}{fg=accent}
\setbeamertemplate{navigation symbols}{}
\setbeamertemplate{footline}{
  \hfill\insertframenumber/\inserttotalframenumber\hspace{2mm}\vspace{2mm}
}

% Packages
\usepackage{graphicx,amsmath,booktabs}
\graphicspath{{figures/}}

% Speaker notes (if enabled)
% \setbeameroption{show notes on second screen=right}

% Metadata
\title{PAPER TITLE}
\author{Author 1 \and Author 2}
\institute{Affiliation}
\date{VENUE YEAR}

\begin{document}

\begin{frame}
\titlepage
\end{frame}

% Content slides follow...

\begin{frame}{Motivation}
\begin{itemize}
  \item Bullet point 1
  \item Bullet point 2
  \item \textbf{Key insight in bold}
\end{itemize}
\note{Speaker note: explain the motivation...}
\end{fra

Truncated for display โ€” read the full file on GitHub.

Related Skills

View on GitHub
GitHub Stars19.2k
CategoryDevelopment
Updated2d ago
Forks1.5k

Languages

Python

Trust signals

100/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.

No cautions
paper-slides โ€” OpenAI Codex Skill: Install & Safety Check | SkillAgent