faust-donf/beamer-academic

---

[!TIP] EN — Give it your thesis (PDF / Word / LaTeX), say “make my defense slides”, and get a ready-to-present Beamer PDF. No LaTeX knowledge required.

中文 — 把论文扔进来，说"帮我做答辩PPT"，就能拿到一份可以直接上台答辩的 Beamer 幻灯片。不需要会 LaTeX，不需要手动排版。

✨ What It Does / 这是什么

An AI Skill (plugin) for Claude Code / Codex that turns your thesis into professional Beamer slides through a fully automated pipeline:

一个 Claude Code / Codex 的 AI Skill（插件），通过全自动管道将论文转化为专业 Beamer 幻灯片：

Thesis / 论文  →  Extract / 素材提取  →  Outline / 大纲  →  Generate / 内容生成  →  PDF

You only confirm the outline. Everything else is automatic.
你只需确认大纲，其余全部自动完成。

🖼️ Gallery / 效果展示

Auto-generated from Attention Is All You Need → full source & PDF

以下为从 Attention Is All You Need 自动生成的示例 → 完整源码和 PDF

🎯 Features / 特性

🚀 Quick Start / 快速开始

Installation / 安装

# Claude Code
git clone https://github.com/Faust-Donf/beamer-academic.git ~/.claude/skills/beamer-academic

# Codex
git clone https://github.com/Faust-Donf/beamer-academic.git ~/.codex/skills/beamer-academic

Prerequisites / 前置依赖

[!NOTE] No LaTeX installed? The Skill will guide you through setup.
没装 LaTeX？Skill 会引导你配置环境。

Input Format / 论文输入格式

[!IMPORTANT] If you have the source file (Word / LaTeX), use that instead of PDF.
如果有 Word 或 LaTeX 源文件，请优先使用，不要转成 PDF。

Usage / 使用

mkdir my-defense && cp thesis.docx my-defense/ && cd my-defense

Then say / 然后说:

"Make my defense slides"  or  "帮我做答辩PPT"

Or type / 或输入: /beamer-academic

The Skill asks a few questions (university, name, advisor, color), then runs the full pipeline automatically.
Skill 会问几个基本信息（学校、姓名、导师、配色），然后全自动跑完。

⚙️ How It Works / 工作流程

Thesis / 论文 ──┐
                ▼
     ┌──────────────────┐
     │  Extract / 素材   │  Figures, tables, formulas, structure
     └────────┬─────────┘
              ▼
     ┌──────────────────┐
     │  Outline / 大纲   │  Auto-assigns 13 layout types
     └────────┬─────────┘
              ▼
     ┌──────────────────┐
     │  ★ Confirm / 确认 │  ← Only manual step (say "ok")
     └────────┬─────────┘
              ▼
     ┌──────────────────┐
     │  Generate / 生成  │  Fills layout templates page by page
     └────────┬─────────┘
              ▼
     ┌──────────────────┐
     │  Compile / 编译   │  xelatex × 2
     └────────┬─────────┘
              ▼
     ┌──────────────────┐
     │  Edit Loop / 修改 │  "P7 too dense" → auto-split & recompile
     └──────────────────┘

📐 Layouts / 版式库

13 battle-tested academic layouts / 13 种经过实战验证的学术版式:

See layouts/_registry.yaml for detailed layout definitions.

🎨 Color Schemes / 配色方案

# assets/config.yaml
color_scheme: "blue"   # blue | red | green | purple | teal

🛠️ Customization / 自定义

Your University / 换成自己学校

# assets/config.yaml
institution:
  name: "Your University / 你的大学"
  department: "Your Department / 你的学院"
  logo: "your-logo.png"
  gate_image: "your-gate.png"   # Thanks page (optional / 可选)

color_scheme: "red"

Add New Layouts / 添加新版式

1. Add a layout section in references/layouts.md
2. Register in references/layout-registry.yaml (define when and slots)
3. Done / 完成

🤔 Why Beamer? / 为什么用 Beamer？

Many AI tools generate slides as images. This project uses LaTeX/Beamer — a deliberate choice validated through real defenses.

市面上不少 AI PPT 工具走图片生成路线。本项目选择 LaTeX/Beamer，是经过真实答辩验证的选择。

Best For / 适合谁

📁 Project Structure / 项目结构

beamer-academic/
├── SKILL.md                    # Main skill file (AI reads this)
├── references/
│   ├── layouts.md              # 13 layout LaTeX skeletons
│   ├── layout-registry.yaml   # Layout selection rules
│   └── tex-header.md          # .tex preamble template
├── assets/
│   ├── beamerthemeAcademic.sty # Beamer theme file
│   └── config.yaml            # User config template
├── scripts/
│   ├── compile.sh             # Compilation script
│   └── extract_figures.py     # Figure extraction (PDF/DOCX/LaTeX)
├── examples/
│   └── transformer/           # Full working example (26 pages)
├── docs/                      # Screenshot gallery
└── README.md

📈 Star History

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md.

欢迎贡献！请参阅 CONTRIBUTING.md。

👤 Author / 作者

Faustus · Xiaohongshu / 小红书

📄 License

MIT