paper2ppt

name	paper2ppt
description	Turn research papers into concise, editable PPT decks with a restrained discussion-class whiteboard style. Use when Codex needs to read a paper PDF or paper notes, optionally borrow Paper2Slides for content planning, and then create a simple editable PPTX for paper reading, discussion sessions, group meetings, or seminar reports.

Paper2PPT

Create editable paper-reading decks in a restrained whiteboard style. This skill is for discussion slides, not marketing decks.

Default Style

• White background.
• One large title near the top.
• Left side or top area uses grouped unordered bullets.
• Group headers are larger and usually red.
• Body bullets are smaller and black.
• Use figures and tables from the paper as evidence, not decoration.
• Remove meaningless cards or floating boxes unless the user explicitly asks for them.

Core Workflow

1. Read the paper PDF or notes first.
2. Extract a small narrative arc instead of copying the paper section by section.
3. If useful, use Paper2Slides as an upstream planning/reference stage only.
4. Reorganize the content into the requested slide outline.
5. Build an editable .pptx, not screenshots.
6. Keep titles and bullets editable text; keep paper figures/tables as evidence images.

Default Seven-Slide Arc

Use this when the user wants a standard paper-reading deck:

1. Research Problem + Challenges
2. Prior Work + Observation
3. Insight + Architecture Overview
4. Detailed Design I
5. Detailed Design II
6. Evaluation I
7. Evaluation II

Layout Rules

• Keep each slide to 2-3 bullet groups.
• Prefer unordered bullets over paragraphs.
• Make group headers visibly larger than body text.
• Keep one main visual area per slide.
• Do not put meaningless summary cards in the middle-upper area.
• On evaluation slides, put the headline metric or conclusion in red.

Paper2Slides Integration

When the user explicitly wants Paper2Slides or when it helps:

• Use Paper2Slides for paper parsing, summary extraction, or slide-plan inspiration.
• Do not rely on Paper2Slides image-only output as the final deliverable when the user wants editable PPT.
• Treat Paper2Slides as the planning/source-extraction stage, then rebuild the final deck as editable PPTX.

Read references/workflow.md for the full hybrid workflow and packaging notes.

Bundled Source

This skill includes a full example project under assets/example-boosting-resource-leak-7slides/:

• build/build_deck.mjs: editable PPTX builder source
• narrative_plan.md: slide narrative
• assets/: paper figure/table screenshots
• preview/: rendered slide previews
• verification/summary.json: export summary
• boosting-resource-leak-paper2slides-7slides.pptx: final example deck

It also includes a vendored upstream copy of Paper2Slides under vendor/Paper2Slides/.

Use this example as a reference implementation when creating similar discussion-style decks.

Publish / Repo Notes

If the user asks to package or publish this skill, include:

• SKILL.md
• agents/openai.yaml
• references/
• scripts/
• assets/example-boosting-resource-leak-7slides/
• vendor/Paper2Slides/
• README.md
• LICENSE

Read references/publish-notes.md before handing the folder off for GitHub publication.