paper-ppt

Generates figure-first academic presentation slides from research paper PDFs using python-pptx.

42|1|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/xiao634zhang/paper-ppt-skill --skill paper-ppt-xiao634zhang
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: paper-ppt
Source: https://github.com/xiao634zhang/paper-ppt-skill
Command: npx skills add https://github.com/xiao634zhang/paper-ppt-skill --skill paper-ppt-xiao634zhang

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires python-pptx, PyMuPDF, python-docx, and includes references (resource) components.

What problem does it solve? Turning a research paper into a clear, well-structured presentation for lab meetings or academic talks is time-consuming, requiring manual figure cropping, layout design, and content summarization. This Skill automates the entire pipeline from PDF to a finished .pptx file. ## Core Features & Use Cases - Paper-to-PPT Conversion: Reads a paper PDF page by page, extracts embedded figures with PyMuPDF, and builds a 6-10 slide deck covering background, method architecture, experiments, contributions, and limitations. - Template Style Matching: Parses a user-provided reference .pptx to extract colors, fonts, and layout, then applies that visual style to the generated slides. - Speaker Notes Alignment: Accepts an outline or speech draft (.docx/.txt/.md) and structures each slide's bullets according to the user's intended narrative. - Use Case: A graduate student needs to present a paper at a weekly group meeting. They provide the paper PDF, a lab-standard PPT template, and their speaking outline, and receive a styled slide deck with cropped figures and complete captions. ## Quick Start Ask the AI to turn your paper PDF into a presentation by providing the PDF path along with an optional reference template and speaking outline.

Frequently Asked Questions about paper-ppt

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a research paper PDF into a PowerPoint presentation?

Provide the paper PDF path and ask for a presentation deck. The workflow renders each PDF page with PyMuPDF, extracts embedded figures, crops them with captions intact, and assembles a 6-10 slide .pptx using python-pptx covering background, method, results, and contributions.

How to extract figures from a PDF paper with Python?

Use PyMuPDF's page.get_images() to extract embedded images via doc.extract_image(xref), or render clipped page regions with get_pixmap at 280 dpi for precise crops. Always verify cropped output visually to confirm figure captions are not truncated.

Can I use my own PPT template for the generated slides?

Yes, provide a reference .pptx file and the workflow parses it with python-pptx to extract background colors, title bar styles, fonts, and layout proportions. All generated slides then follow the template's design instead of default styling.

Does the generated PPT support speaker notes or outline documents?

Yes, it accepts .docx, .txt, .md, or pasted text outlines. The document's page divisions and talking points take priority over the default structure, so each slide's bullets follow your intended narrative.

What are the limitations of automatic figure extraction from papers?

Embedded image extraction may miss vector graphics or multi-panel figures, requiring manual region cropping instead. If no suitable figure can be obtained, the slide uses a text placeholder referencing the original figure number rather than fabricating diagrams.