KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

academic-ppt-master

★ 133 Open GitHub ↗

Turn papers into editable academic PPTX decks

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Academic PPT Master

![Attention paper deck preview, slides 1 to 6](https://raw.githubusercontent.com/M1n-n9/academic-ppt-master/main/assets/previews/attention_demo_01_06.png)

![Attention paper deck preview, slides 7 to 12](https://raw.githubusercontent.com/M1n-n9/academic-ppt-master/main/assets/previews/attention_demo_07_12.png)

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:

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

Install Python dependencies:

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

Then ask your agent:

```text
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

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

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

```text
用这个 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

```text
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 模板。

典型用法：

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

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

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

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

academic-ppt-master

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README