Academic PPT Plugin is an open-source Codex plugin for turning local thesis materials into rigorous, concise, editable academic defense presentations.
It is designed for:
- undergraduate thesis defense
- graduate research presentation
- project progress defense
- academic report or lab presentation
The repository is built to generate:
- editable
.pptx - rebuildable JavaScript authoring source
deck_plan.mddeck_plan.jsonsource_manifest.json- rendered slide previews
- validation outputs for overflow, rendering, and font checks
.doc.docx.pdf.md.pptx- images such as
.png,.jpg,.jpeg,.svg,.webp
Inputs may be:
- a single file
- multiple files
- a mixed folder of thesis materials
- content-aware planning instead of generic template filling
- editable PowerPoint output generated from JavaScript
- emphasis on the student's own work, method, evidence, and innovation points
- preference for thesis-native figures and screenshots when available
- validation before delivery
- explicit traceability back to source files
- first-run local dependency bootstrap for Python, Node, and validation tool packages
If you want:
- project overview: this file
- Chinese project overview: README.zh-CN.md
- deployment guide in English: DEPLOYMENT.md
- deployment guide in Chinese: DEPLOYMENT.zh-CN.md
- plugin behavior and internal workflow: skill/academic-ppt/SKILL.md
- command-level workflow reference: skill/academic-ppt/references/workflow.md
There are two practical deployment targets:
| Mode | What you get | Required tools |
|---|---|---|
| Minimal run | Build the deck without full validation | Python, Node.js |
| Full validation | Build and validate rendering, images, and fonts | Python, Node.js; LibreOffice and Poppler are bootstrapped on demand where supported; fontconfig uses fc-list or Python fallback |
Python and Node dependencies are bootstrapped automatically by the plugin on first run. Full validation also bootstraps desktop validation tools into skill/academic-ppt/.runtime/tools when the platform manifest supports them.
For full setup instructions, use:
academic-ppt-skills/
|- .codex-plugin/
| `- plugin.json
|- README.md
|- README.zh-CN.md
|- DEPLOYMENT.md
|- DEPLOYMENT.zh-CN.md
|- LICENSE
|- THIRD_PARTY_NOTICES.md
|- examples/
| `- twibot20/
`- skill/
`- academic-ppt/
|- SKILL.md
|- package.json
|- requirements.txt
|- assets/
|- references/
`- scripts/
The image below is a public example preview generated from a local research paper (TwiBot-20.pdf). The source paper itself is not redistributed in this repository.
See examples/twibot20/README.md for the example context and validation notes.
- skill/academic-ppt/SKILL.md
- skill/academic-ppt/references/workflow.md
- REPOSITORY_FOOTPRINT.md
- THIRD_PARTY_NOTICES.md
Referenced projects include:
This repository is released under the MIT License. See LICENSE.