academic-ppt-master

Academic PPT Master

Academic PPT Master turns papers into editable PowerPoint decks for paper reading, journal clubs, thesis defense, and group reports.

The two previews above were generated by giving the skill only the paper. No extra design prompt was used. You can also provide your own PPT template when you want the output to follow a lab, company, or course style.

What It Does

• Converts PDF, DOCX, PPTX, URL, Markdown, and pasted text into structured source material.
• Builds academic decks around a five-module research-report structure: background, method, results, conclusion, and outlook.
• Generates slide pages as SVG, checks visual quality, then exports to natively editable PPTX.
• Preserves formulas, figures, tables, diagrams, and paper screenshots as first-class slide material.
• Supports built-in academic templates and user-provided PPT templates.
• Works as a reusable skill for Codex-style and Claude-style agent workflows.

Best Use Cases

• Paper reading slides for group meetings.
• Journal club reports.
• Thesis defense, proposal defense, and midterm progress decks.
• Research project updates.
• Course presentation slides based on one or more papers.

Quick Start

Clone this repository into your local skills folder:

git clone https://github.com/M1n-n9/academic-ppt-master.git ~/.codex/skills/academic-ppt-master

Install Python dependencies:

cd ~/.codex/skills/academic-ppt-master
python -m pip install -r requirements.txt

Then ask your agent:

Use academic-ppt-master to turn this paper into a 12-slide journal-club PPT.

For Claude-style workflows, place the repository in the corresponding skills directory and point the agent to SKILL.md.

Example Prompts

把这篇论文做成课题组文献汇报 PPT，12 页左右，偏学术答辩风。

Use academic-ppt-master to create a paper-reading deck from this PDF. Keep the slides editable and preserve the key formulas and figures.

用这个 PPT 模板作为风格参考，把论文整理成 journal club slides。

Built-In Academic Presets

Preset	Path	Good for
Minimal paper report	templates/decks/academic_paper/	paper reading, journal club, quick group sharing
Dense academic defense	templates/decks/academic_defense/	thesis defense, proposal defense, detailed research reports
Academic blue	templates/brands/academic-blue/	clean paper-report decks
Academic graphite	templates/brands/academic-graphite/	neutral grayscale academic decks
Academic navy	templates/brands/academic-navy/	formal defense decks

Template selection is path-based. Give the full template directory path when you want a specific preset.

Pipeline

source paper
  -> markdown extraction
  -> project initialization
  -> academic structure planning
  -> SVG slide generation
  -> visual quality check
  -> SVG post-processing
  -> editable PPTX export

The workflow keeps content and design separate. The strategist decides the slide logic and evidence structure. The executor writes each SVG page. The exporter converts SVG objects into editable PowerPoint elements.

Repository Contents

• SKILL.md: the main workflow instructions.
• scripts/: conversion, rendering, quality-check, and PPTX export tools.
• references/: academic mode, visual rules, execution standards, and workflow references.
• templates/: academic brands, layouts, decks, charts, and icons.
• workflows/: optional workflows for template filling, visual review, chart verification, audio, and live preview.
• assets/previews/: preview images shown in this README.

Generated projects, exported PPTX files, local caches, API keys, and private source papers are not included.

License

MIT. See ATTRIBUTION.md for engine attribution and project-specific notes.

---

中文说明

Academic PPT Master 是一个面向学术场景的 PPT skill。它可以把论文、PDF、Markdown、网页或已有文档整理成可编辑的 PowerPoint，适合文献汇报、组会、journal club、开题、中期和答辩。

上面的两张预览图只输入了论文，没有额外写设计提示词。你也可以给它自己的 PPT 模板，让输出贴合课题组、课程或机构风格。

核心能力：

• 自动抽取论文内容，整理成适合汇报的结构。
• 按背景、方法、实验、结论、展望组织逻辑。
• 优先保留论文里的公式、图、表和关键实验结果。
• 先生成 SVG 页面，再做视觉检查，最后导出可编辑 PPTX。
• 支持内置学术模板，也支持用户自己的 PPT 模板。

典型用法：

把这篇论文做成 12 页文献汇报 PPT，使用 academic-ppt-master。

用 templates/decks/academic_defense/ 这个模板，把论文做成答辩风格 PPT。

参考我上传的 PPT 模板，把这篇论文整理成组会汇报。

本仓库只放 skill、脚本、参考文档、模板和预览图，不包含私有论文、生成项目、导出 PPTX、API key 或本地缓存。