Skip to content
Back to search

beamer-academic

一键从论文生成高质量学术答辩PPT | AI-powered thesis defense slides generator | Claude Code & Codex Skill

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/faust-donf--beamer-academic/badge.svg)](/listings/faust-donf--beamer-academic)

HTML

<a href="/listings/faust-donf--beamer-academic"><img src="/api/listings/faust-donf--beamer-academic/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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 / 前置依赖

<details> <summary><kbd>LaTeX Installation / LaTeX 安装</kbd> (click to expand / 点击展开)</summary>

<br>

# macOS
brew install --cask mactex-no-gui

# Ubuntu / Debian
sudo apt install texlive-xetex texlive-lang-chinese texlive-fonts-recommended

# Fedora
sudo dnf install texlive-xetex texlive-xecjk

# Windows (WSL)
sudo apt install texlive-xetex texlive-lang-chinese

</details>

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

Input Format / 论文输入格式

| Format | | Notes | |:--|:--:|:--| | `.tex` | ⭐⭐⭐ | **Best / 首选** — figures & formulas reused directly / 图片公式直接复用 | | `.docx` | ⭐⭐⭐ | **Great / 推荐** — full image quality / 图片质量完整 | | `.pdf` | ⚠️ | **Not recommended / 不推荐** — quality loss / 有损耗 |

> [!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 会问几个基本信息(学校、姓名、导师、配色),然后全自动跑完。

<br>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 505 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: beamer-academic
  3. description: >
  4. Generate high-quality academic Beamer slides from a thesis/paper (PDF, Word, or LaTeX source).
  5. Compatible with Claude Code and Codex. Supports thesis defense, proposal presentations, and
  6. conference talks. Built-in layout library with 13 professional page types, 5 color schemes,
  7. and interactive editing loop.
  8. Use when: (1) User asks to create thesis defense slides/PPT, (2) User wants to generate
  9. academic presentation from a paper, (3) User mentions beamer, 答辩PPT, 学术报告, 开题PPT,
  10. 论文幻灯片, or academic slides, (4) User has a PDF/docx/tex thesis and wants presentation output.
  11. ---
  12. # Beamer Academic
  13. Generate publication-quality Beamer slides from an academic paper in one automated pipeline.
  14. ## Pipeline Overview
  15. ```
  16. 论文 → 素材提取 → 大纲生成 → [用户确认] → 内容填充 → 编译 → [交互修改循环]
  17. ```
  18. ## Phase 0: Environment Check & Input Clarification
  19. ### 0.1 Locate Thesis File
  20. Search current directory for thesis in priority order:
  21. 1. `.tex` (LaTeX source — best quality, figures/equations directly reusable)
  22. 2. `.docx` (Word — good for text extraction, figures embedded)
  23. 3. `.pdf` (PDF — acceptable but figure extraction may lose quality)
  24. If multiple candidates found, ask user which one.
  25. If none found, prompt: "请把论文文件放到当前目录(支持 .tex / .docx / .pdf)"
  26. **Recommend .tex or .docx over PDF**: PDF figure extraction can produce low-quality raster images.
  27. If user only has PDF, warn:
  28. > 注意:PDF 提取的图片可能有质量损失。如果你有论文的 Word 或 LaTeX 源文件,建议优先使用。
  29. ### 0.2 Check LaTeX Environment
  30. ```bash
  31. which xelatex
  32. ```
  33. If missing, **recommend user to install** (this is a one-time setup, not optional):
  34. > 你的系统还没有安装 LaTeX 环境。beamer PPT 需要 xelatex 编译,我来帮你装一下:
  35. Then provide the command for user's OS and **offer to run it**:
  36. | OS | Command |
  37. |----|---------|
  38. | macOS | `brew install --cask mactex-no-gui` (推荐,约3.5GB,装一次永久可用) |
  39. | Ubuntu/Debian | `sudo apt install texlive-xetex texlive-lang-chinese texlive-fonts-recommended` |
  40. | Fedora/RHEL | `sudo dnf install texlive-xetex texlive-xecjk` |
  41. | Windows (WSL) | `sudo apt install texlive-xetex texlive-lang-chinese` |
  42. | Arch | `sudo pacman -S texlive-xetex texlive-langchinese` |
  43. Wait for installation to complete, verify with `which xelatex`, then proceed.
  44. If user explicitly refuses to install (rare), fallback: deliver `.tex` + `.sty` + figures, suggest Overleaf.
  45. ### 0.3 Beamer Template (Ask User First)
  46. Ask user about existing school beamer template:
  47. > 你的学校/课题组有现成的 beamer 模板吗?(比如导师或师兄给过的 .sty 文件)
  48. > - 有:请放到当前目录,我直接使用
  49. > - 没有:我来帮你找或用内置通用模板
  50. If user has a template: use it directly, skip the built-in theme.
  51. If user has NO template:
  52. 1. Ask for school name
  53. 2. Search for existing public beamer templates for that school:
  54. - GitHub search: `{school name} beamer template`
  55. - Common sources: Overleaf Gallery, CTAN
  56. 3. If found: download and use (notify user which template)
  57. 4. If not found: use built-in `assets/beamerthemeAcademic.sty` with school logo
  58. - Ask: "你能提供学校 logo 图片吗?(放到当前目录即可)"
  59. - If no logo available: search online for the school's logo, or proceed without logo
  60. ### 0.4 Configuration
  61. Check for `config.yaml` in current directory:
  62. - Exists: read and use.
  63. - Missing: ask user for basic info, then generate from template at `assets/config.yaml`.
  64. Required user info (ask if not in config):
  65. - Institution name and department
  66. - Author name, supervisor, major
  67. - Report type: `defense` | `proposal` | `conference`
  68. - Color preference: `blue` | `red` | `green` | `purple` | `teal`
  69. - Time limit (minutes): affects page count and content density
  70. - Language: thesis language vs. PPT language (e.g., 英文论文 → 中文PPT)
  71. - **Chapnote preference**: "每页要不要显示'对应论文 §X.X'的标注?"(some users find it helpful for committee, others find it cluttered)
  72. ### 0.5 Language Strategy
  73. If thesis language ≠ PPT language, establish rules upfront:
  74. > 你的论文是英文,PPT 要做中文版吗?
  75. > 对于专业术语,我会:
  76. > 1. 首次出现用"中文(English)"格式
  77. > 2. 之后统一用中文
  78. > 3. 公式/变量名保持英文不翻译
  79. >
  80. > 这样处理可以吗?
  81. Build a **terminology mapping table** (stored in `materials/terms.md`):
  82. ```
  83. | English | 中文 | 首次出现页 |
  84. |---------|------|-----------|
  85. | disparity | 形态多样性 | P4 |
  86. | diversity | 分类丰富度 | P4 |
  87. | Ornstein-Uhlenbeck | OU 过程 | P8 |
  88. ```
  89. Ensure **术语一致性**: same concept uses same translation across all pages.
  90. ## Phase 1: Material Extraction
  91. Create `materials/` directory. Extraction strategy depends on input format:
  92. ### From .tex source (best)
  93. 1. **Figures**: locate `\includegraphics` paths, copy originals → `materials/figures/`
  94. 2. **Tables**: extract `tabular`/`table` environments → `materials/tables/`
  95. 3. **Equations**: extract `equation`/`align`/`$$` blocks → `materials/equations.md`
  96. 4. **Structure**: parse `\chapter`/`\section` hierarchy → `materials/structure.md`
  97. ### From .docx
  98. 1. **Figures**: extract embedded images (python-docx or unzip) → `materials/figures/`
  99. 2. **Tables**: extract table contents → `materials/tables/`
  100. 3. **Equations**: extract OMML/LaTeX equations → `materials/equations.md`
  101. 4. **Structure**: parse heading hierarchy → `materials/structure.md`
  102. ### From .pdf (fallback)
  103. 1. **Figures**: use `pdfimages` or read PDF for embedded images → `materials/figures/`
  104. - ⚠️ Quality may degrade. Prefer vector (PDF/SVG) extraction when possible.
  105. 2. **Tables**: read and reconstruct → `materials/tables/`
  106. 3. **Equations**: read and convert to LaTeX → `materials/equations.md`
  107. 4. **Structure**: parse chapter/section from text → `materials/structure.md`
  108. ### 1.2 Material Confirmation (In-Conversation)
  109. After extraction, present a **figure catalog** to user in conversation:
  110. > ## 🖼️ 素材库(共提取 12 张图)
  111. >
  112. > | # | 文件名 | 来源 | 内容描述 |
  113. > |---|--------|------|----------|
  114. > | 1 | fig_001.png | 论文图1 | 地质年代柱状图 |
  115. > | 2 | fig_002.png | 论文图4 | PCoA 碎石图 |
  116. > | 3 | fig_003.png | 论文图8 | 形态空间散点图 |
  117. > | ... | | | |
  118. >
  119. > **哪些图是你答辩必须展示的?** 可以说:
  120. > - "1, 3, 5, 8 必须用"
  121. > - "图7 不用了,跟图5 重复"
  122. > - "全部都可能用到"
  123. This ensures:
  124. - Key figures won't be missed in layout assignment
  125. - User has a mental model of available materials before the outline phase
  126. - Low-quality or duplicate figures can be flagged early
  127. ## Phase 2: Brainstorm Outline (Interactive, In-Conversation)
  128. **This phase determines the entire presentation structure through conversation with the user. All confirmation happens IN THE CHAT — never ask user to open a file.**
  129. ### 2.0 Chapter Structure Principle
  130. **Follow the thesis's own structure as the PRIMARY basis for PPT chapters.**
  131. - If thesis has explicit chapters (第一章...第四章): map directly to PPT chapters
  132. - If thesis has no chapters (like a conference paper with sections): group related sections into 3-5 logical chapters for the PPT
  133. - Do NOT invent arbitrary chapter divisions that don't match the thesis logic
  134. - The PPT chapter structure should feel natural to someone who has read the thesis
  135. ### 2.1 First Pass: Structure Proposal
  136. After reading the thesis, propose the high-level structure directly in conversation:
  137. > ## 📐 PPT 结构提案
  138. >
  139. > 根据你的论文结构,我建议这样安排:
  140. >
  141. > **总页数**:42 页(约 20 分钟答辩)
  142. >
  143. > | 章 | 标题 | 页数 | 对应论文 | 说明 |
  144. > |---|------|------|---------|------|
  145. > | 一 | 研究背景与科学问题 | 8页 | 第1章 | 背景+命题+假设+创新点 |
  146. > | 二 | 数据构建与描述性分析 | 7页 | 第2章 | 数据来源+特征工程+时序总览 |
  147. > | 三 | 演化模式与驱动机制 | 15页 | 第3章 | H1+H2+H3 三个假设检验 |
  148. > | 四 | 结论与展望 | 5页 | 第4章 | 主要结论+局限+展望+成果 |
  149. >
  150. > **你觉得这个结构可以吗?** 可以告诉我:
  151. > - "第三章太长了,拆成两章"
  152. > - "加一章文献综述"
  153. > - "总页数控制在35页以内"
  154. Wait for user to confirm or adjust. Loop until structure is approved.
  155. ### 2.2 Second Pass: Per-Section Detail
  156. Once chapter structure is approved, expand each chapter **in conversation** (not in a file):
  157. > ## 📋 第一章 详细安排(8页)
  158. >
  159. > | 页码 | 版式 | 标题 | 内容要点 |
  160. > |------|------|------|----------|
  161. > | P3 | 章节分隔 | 一、研究背景与科学问题 | — |
  162. > | P4 | 左文右图 | 寒武纪辐射与软体动物的演化窗口 | 演化窗口介绍 + 地质年代图 |
  163. > | P5 | 纯文段 | 经典命题:Disparity vs. Diversity | 形态多样性与丰富度争论 |
  164. > | P6 | 纯文段 | 驱动机制之一:外源突变 | Sinsk 事件背景 |
  165. > | P7 | 纯文段 | 驱动机制之二:系统发育约束 | OU 过程假说 |
  166. > | P8 | 列表 | 现有研究的四点不足 | 4个gap |
  167. > | P9 | 表格 | 研究目标与三个核心假设 | H1/H2/H3 表格 |
  168. > | P10 | 列表 | 论文的主要创新 | 5个创新点 |
  169. >
  170. > **这章的安排可以吗?** 可以说:
  171. > - "P5和P6合并成一页"
  172. > - "P9加一列'若成立则说明'"
  173. > - "ok,继续下一章"
  174. Present **one chapter at a time**. Wait for approval before showing the next chapter.
  175. ### 2.3 Third Pass: Final Confirmation
  176. After all chapters are individually approved, show a **complete summary** in conversation:
  177. > ## ✅ 最终大纲确认
  178. >
  179. > | 章 | 页码范围 | 页数 | 版式分布 |
  180. > |---|---------|------|----------|
  181. > | 封面+目录 | P1–P2 | 2 | cover, toc |
  182. > | 一 研究背景 | P3–P10 | 8 | 分隔×1, 左文右图×1, 纯文段×3, 列表×1, 表格×1, 列表×1 |
  183. > | 二 数据构建 | P11–P17 | 7 | 分隔×1, ... |
  184. > | 三 演化机制 | P18–P32 | 15 | 分隔×1, ... |
  185. > | 四 结论展望 | P33–P37 | 5 | 分隔×1, ... |
  186. > | 致谢 | P38 | 1 | thanks |
  187. > | **合计** | | **38页** | |
  188. >
  189. > **确认后我将开始生成 beamer LaTeX 代码。确认吗?**
  190. **HARD GATE: Do NOT proceed to Phase 3 until user explicitly confirms the final summary.**
  191. ### 2.4 Save to outline.md
  192. Only after final confirmation, save the approved structure to `outline.md` for Phase 3 reference. This file is for the AI's internal use — user has already approved everything in conversation.
  193. ### Why In-Conversation Instead of File
  194. - Users who don't know markdown can follow along naturally in chat
  195. - Iterative refinement is faster (no "go check that file" round-trip)
  196. - Each chapter gets individual attention
  197. ### Layout Selection Rules (used in 2.2 per-page assignment)
  198. 1. Each chapter start → `section-divider`
  199. 2. Core formula/model definition → `formula`
  200. 3. Multi-row data comparison → `table`
  201. 4. High-information figure (multi-panel, heatmap) → `full-image`
  202. 5. Text-primary with supporting figure → `text-left-image-right`
  203. 6. Figure-primary with interpretation → `image-left-text-right`
  204. 7. Pure concept/background → `text-only`
  205. 8. Chapter-end with clear conclusion → `conclusion-box`
  206. 9. Between chapters → `transition`
  207. 10. Parallel bullet points → `list`
  208. ### Rhythm Constraints
  209. - No 3 consecutive pages with same layout
  210. - Each chapter uses at least 3 different layouts
  211. - Total: 35–50 pages (defense), 25–35 (proposal), 15–25 (conference)
  212. ## Phase 3: Content Generation
  213. 1. Copy `assets/beamerthemeAcademic.sty` to current directory.
  214. 2. Generate `defense.tex` file header. Read `references/tex-header.md` for template.
  215. 3. For each page in `outline.md`:
  216. - Load layout skeleton from `references/layouts.md` (find section by layout id)
  217. - Fill slots with thesis content + extracted materials
  218. 4. Close with `\end{document}`.
  219. ### Critical: Section Divider = 满版色 + 圆圈序号
  220. 每章开头用 `\sectiondivider{1}{章标题}`(圆圈里用阿拉伯数字,中文「一」在圆里像减号)。目录只在第 2 页出现一次。
  221. ### Critical: TOC Page Format
  222. The TOC page (P2) must use Chinese numbering with em-dash subtitles:
  223. ```latex
  224. \begin{frame}
  225. \frametitle{汇报提纲}
  226. \vskip0.3cm
  227. {\footnotesize
  228. \begin{tabbing}
  229. \hspace{0.4cm}\=\hspace{0.6cm}\=\kill
  230. \textbf{\color{accentcolor}一}\>\textbf{研究动机}\,——\,为什么需要新的序列建模方案\\[8pt]
  231. \textbf{\color{accentcolor}二}\>\textbf{模型架构}\,——\,Transformer 的核心设计\\[8pt]
  232. \textbf{\color{accentcolor}三}\>\textbf{实验结果}\,——\,翻译质量与消融分析\\[8pt]
  233. \textbf{\color{accentcolor}四}\>\textbf{总结与展望}\,——\,贡献与未来方向\\
  234. \end{tabbing}
  235. }
  236. \end{frame}
  237. ```
  238. ### Critical: Figure Extraction from PDF
  239. **NEVER use full-page PDF screenshots as figures.** When source is PDF:
  240. 1. Use `pdfimages -all paper.pdf materials/figures/` to extract embedded vector/raster images
  241. 2. If `pdfimages` not available, use `mutool extract` or Python `PyMuPDF`
  242. 3. If only `pdftoppm` is available, crop the figure region ONLY:
  243. - First identify figure bounding box coordinates
  244. - Use Python PIL to crop the figure out of the page image
  245. - Remove surrounding text, page numbers, captions
  246. 4. **Quality check**: if extracted figure contains visible paper text around it, it's WRONG — re-crop
  247. 5. For well-known papers (Transformer, ResNet, etc.), consider re-drawing key diagrams with tikz
  248. ### Critical: Anti-AI Writing Style (NO Bullet List Abuse)
  249. **The #1 sign of AI-generated slides is overuse of `\begin{itemize}` and uniform page structure.**
  250. Core rules:
  251. 1. Each page COMBINES multiple elements (段落+keybox, 段落+公式+段落, 段落+表格+结论)
  252. 2. Adjacent pages MUST use different composition patterns
  253. 3. `\begin{itemize}` is BANNED. Only `\enumerate` with intro paragraph allowed
  254. 4. 80% of pages use paragraph-style writing, not bullet points
  255. 5. Use inline patterns: `$\bullet$ \textbf{term}`, `\alert{keyword}`, `\textbf{title}\,——\,explanation`
  256. **Read `references/writing-style.md` for 6 concrete composition patterns with LaTeX code examples.**
  257. ### Content Quality Rules
  258. | Constraint | Value |
  259. |-----------|-------|
  260. | Text per page (text-only) | 150–200 chars |
  261. | Text per page (with figure) | 100–150 chars |
  262. | Equations per page | max 2 |
  263. | Table rows | 3–8 |
  264. | `\alert{}` keywords per page | 1–2 |
  265. | Page structure | COMBINE multiple elements (see writing-style.md) |
  266. | `\itemize` | BANNED |
  267. ### Section Divider (Enforced)
  268. Every chapter boundary MUST use `\sectiondivider{1}{章标题}`(圆圈用 1/2/3)。
  269. ### Anti-AI Title & Content Check
  270. Before finalizing, check all titles and content. **Read `references/writing-style.md`** for the full red-flag list.
  271. Quick check: "这个标题/段落像答辩学生写的还是 AI 写的?" 如果像 AI,改到像人。
  272. ### Figure & Table Numbering
  273. All figures and tables in the presentation MUST be numbered sequentially:
  274. - Figures: `图 1`, `图 2`, `图 3`... (using `\figcap{图 1\;描述文字}`)
  275. - Tables: in frame title or above table, mark as `表 1`, `表 2`...
  276. Example:
  277. ```latex
  278. \figcap{图 1\;Transformer 编码器--解码器架构}
  279. \figcap{图 2\;多头注意力并行投影机制}
  280. ```
  281. Table title pattern:
  282. ```latex
  283. \frametitle{机器翻译 BLEU 对比(表 2)}
  284. % or inside the frame:
  285. {\small\textbf{表 1}\;不同层类型的复杂度对比}
  286. ```
  287. Numbering must be consistent throughout — do not skip or repeat numbers.
  288. ## Phase 4: Compilation & Layout Verification
  289. ### 4.1 Compile
  290. ```bash
  291. xelatex -interaction=nonstopmode defense.tex && xelatex -interaction=nonstopmode defense.tex
  292. ```
  293. On failure: read `defense.log`, fix common issues (missing image, font, overfull hbox), retry up to 3 times.
  294. If user has no LaTeX environment, skip compilation and deliver `.tex` + `.sty` + `materials/figures/`.
  295. ### 4.2 Layout Bug Detection
  296. After compilation, check `defense.log` for these common layout issues:
  297. | Symptom | Cause | Fix |
  298. |---------|-------|-----|
  299. | `Overfull \vbox` on frame | Content exceeds page height | Reduce text, split into 2 pages, or shrink font |
  300. | `Overfull \hbox` with image | Image too wide for column | Add `keepaspectratio`, reduce `width` |
  301. | Image overlaps text in columns | `\column` width sum > `\textwidth` | Ensure left + right column ≤ 1.0 |
  302. | tikz overlay covers text | `[remember picture, overlay]` node position wrong | Adjust `yshift`/`xshift` values |
  303. | Text runs below frame | Too many paragraphs | Cut to 150-200 chars or split page |
  304. **Proactive overlap prevention** (apply during Phase 3 content generation):
  305. - For `text-left-image-right`: left text ≤ 150 chars, image height ≤ `3.4cm` per image
  306. - For `image-left-text-right`: right text ≤ 120 chars, image height ≤ `0.60\textheight`
  307. - For `full-image`: use **only** tikz overlay positioning, no surrounding text except `\figcap`
  308. - For `formula`: max 2 equations, with `\vskip0.1cm` spacing between
  309. - Never put more than 3 `\vskip` commands in one frame (sign of overstuffing)
  310. **If overlap detected in compiled PDF** (user reports "P7图文重叠了"):
  311. 1. Identify the frame in `.tex`
  312. 2. Check: is text too long? Is image too tall? Are column widths correct?
  313. 3. Apply fix: reduce text / shrink image / split into 2 pages
  314. 4. Recompile and verify
  315. ## Phase 5: Interactive Editing (Guided Choices)
  316. Present result:
  317. > ✅ PDF 已生成:./defense.pdf(共 XX 页,预计答辩时长 XX 分钟)
  318. > 说修改意见,或说"满意"结束。
  319. ### 5.1 Guided Modification (Never Let User Struggle to Express)
  320. When user gives vague feedback, **offer concrete choices** instead of asking them to describe:
  321. | User says | Respond with choices |
  322. |-----------|---------------------|
  323. | "这页不好看" | "你觉得是:A. 文字太密想拆成两页?B. 图太小想换成满版图?C. 想换个版式?" |
  324. | "这里有点奇怪" | "我看到可能的问题:A. 图文重叠了 B. 文字太学术想简化 C. 想加个过渡说明?" |
  325. | "第三章不太行" | "第三章目前15页。你想:A. 整体缩减(砍到10页)?B. 某几页太密拆开?C. 补一页总结?" |
  326. | "改好看点" | "我可以:A. 加几页满版图让节奏更松 B. 关键结论用高亮框突出 C. 换个配色?" |
  327. **Principle**: Always give 2–3 concrete options with preview of effect. User picks, not describes.
  328. ### 5.2 Modification Execution
  329. | Type | Action |
  330. |------|--------|
  331. | Single page content edit | Edit corresponding `\begin{frame}...\end{frame}` |
  332. | Add/remove page | Update outline.md, regenerate affected section |
  333. | Global style change | Modify .sty or header |
  334. | Layout switch | Replace frame with different layout skeleton |
  335. After each edit, recompile and present again. Loop until user says done.
  336. ## Phase 6: Speaker Notes & Rehearsal Support (Optional)
  337. After user confirms the slides are satisfactory, offer:
  338. > 需要我帮你生成讲稿和配速建议吗?可以帮助你控制答辩节奏。
  339. If user accepts, generate `notes.md`:
  340. ### 6.1 Per-Page Speaker Notes
  341. ```markdown
  342. ## P4 — 寒武纪辐射与软体动物的演化窗口
  343. ⏱️ 建议时长: 45秒
  344. ### 要点提词
  345. - 演化窗口: 5.41亿年前,持续4000万年
  346. - 软体动物门: 现代海洋第二大门类
  347. - 272个属: 本文研究对象
  348. ### 讲稿参考
  349. "首先介绍一下研究背景。寒武纪是海洋生态系统大规模重组的关键时期……"
  350. ```
  351. ### 6.2 Time Pacing Table
  352. Present pacing summary in conversation:
  353. > ## ⏱️ 时间配速建议(总计 20 分钟)
  354. >
  355. > | 章 | 页数 | 建议时长 | 每页均速 |
  356. > |---|------|---------|---------|
  357. > | 一 研究背景 | 8页 | 4分钟 | 30秒/页 |
  358. > | 二 数据构建 | 7页 | 3.5分钟 | 30秒/页 |
  359. > | 三 演化机制 | 15页 | 9分钟 | 36秒/页(重点章节,可以慢一些) |
  360. > | 四 结论展望 | 5页 | 2.5分钟 | 30秒/页 |
  361. > | 致谢+缓冲 | 1页 | 1分钟 | — |
  362. >
  363. > ⚠️ 第三章是重点,建议对关键结果页多花时间讲解。
  364. ### 6.3 Beamer Notes Integration (Optional)
  365. If user wants notes embedded in PDF (for dual-screen presentation mode):
  366. ```latex
  367. \setbeameroption{show notes on second screen=right}
  368. ```
  369. Add `\note{}` blocks to each frame in `.tex` with the speaker notes content.
  370. ## Reference Files
  371. - `references/layouts.md` — All 13 layout skeletons with slot definitions and LaTeX code
  372. - `references/tex-header.md` — Standard .tex file preamble template
  373. - `references/layout-registry.yaml` — Layout selection rules in structured format
  374. ## Assets
  375. - `assets/beamerthemeAcademic.sty` — Beamer theme file (copied to user project)
  376. - `assets/config.yaml` — Configuration template (copied to user project)
README.md · README · 360 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. <div align="center">
  2. <img src="docs/cover.png" width="560" alt="Beamer Academic">
  3. <br><br>
  4. # Beamer Academic
  5. **Drop your thesis in, get defense slides out.**<br>
  6. **论文丢进来,答辩 PPT 自动生成。**
  7. AI Skill for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) / [Codex](https://openai.com/index/codex/) · 13 Layouts · 5 Color Schemes · Works Out of the Box
  8. <br>
  9. [![Version](https://img.shields.io/github/v/release/Faust-Donf/beamer-academic?style=for-the-badge&color=0066cc&label=VERSION)](https://github.com/Faust-Donf/beamer-academic/releases)
  10. [![Stars](https://img.shields.io/github/stars/Faust-Donf/beamer-academic?style=for-the-badge&color=f5a623&label=STARS)](https://github.com/Faust-Donf/beamer-academic/stargazers)
  11. [![License](https://img.shields.io/badge/LICENSE-MIT-green?style=for-the-badge)](LICENSE)
  12. [![Try beamer-academic on Socialistic](https://socialistic.ai/api/embed/beamer-academic-ace6dc?lang=zh)](https://socialistic.ai/zh/skill/beamer-academic-ace6dc?utm_source=github&utm_medium=readme&utm_campaign=20260604-ai-deck-report-toolsmiths&utm_content=badge)
  13. <br>
  14. [Quick Start](#-quick-start) · [Gallery](#-gallery) · [Layouts](#-layouts) · [Example](examples/transformer/) · [Customization](#-customization)
  15. <br>
  16. </div>
  17. ---
  18. > [!TIP]
  19. > **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.
  20. >
  21. > **中文** — 把论文扔进来,说"帮我做答辩PPT",就能拿到一份可以直接上台答辩的 Beamer 幻灯片。不需要会 LaTeX,不需要手动排版。
  22. <br>
  23. ## ✨ What It Does / 这是什么
  24. An AI Skill (plugin) for Claude Code / Codex that turns your thesis into professional Beamer slides through a fully automated pipeline:
  25. 一个 Claude Code / Codex 的 AI Skill(插件),通过全自动管道将论文转化为专业 Beamer 幻灯片:
  26. ```
  27. Thesis / 论文 → Extract / 素材提取 → Outline / 大纲 → Generate / 内容生成 → PDF
  28. ```
  29. You only confirm the outline. Everything else is automatic.
  30. 你只需确认大纲,其余全部自动完成。
  31. <br>
  32. ## 🖼️ Gallery / 效果展示
  33. Auto-generated from *Attention Is All You Need* → [full source & PDF](examples/transformer/)
  34. 以下为从 *Attention Is All You Need* 自动生成的示例 → [完整源码和 PDF](examples/transformer/)
  35. <table>
  36. <tr>
  37. <td align="center"><strong>Cover / 封面</strong></td>
  38. <td align="center"><strong>TOC / 目录</strong></td>
  39. </tr>
  40. <tr>
  41. <td><img src="docs/cover.png" width="380"></td>
  42. <td><img src="docs/toc.png" width="380"></td>
  43. </tr>
  44. <tr>
  45. <td align="center"><strong>TikZ Architecture / TikZ 架构图</strong></td>
  46. <td align="center"><strong>TikZ Multi-Head Attention / 多头注意力</strong></td>
  47. </tr>
  48. <tr>
  49. <td><img src="docs/tikz-architecture.png" width="380"></td>
  50. <td><img src="docs/tikz-attention.png" width="380"></td>
  51. </tr>
  52. <tr>
  53. <td align="center"><strong>Text + Formula / 段落+公式</strong></td>
  54. <td align="center"><strong>Table + Conclusion / 表格+结论</strong></td>
  55. </tr>
  56. <tr>
  57. <td><img src="docs/text-image.png" width="380"></td>
  58. <td><img src="docs/table.png" width="380"></td>
  59. </tr>
  60. <tr>
  61. <td align="center"><strong>Full-page Figure / 满版图</strong></td>
  62. <td align="center"><strong>Acknowledgement / 致谢</strong></td>
  63. </tr>
  64. <tr>
  65. <td><img src="docs/full-image.png" width="380"></td>
  66. <td><img src="docs/thanks.png" width="380"></td>
  67. </tr>
  68. </table>
  69. <br>
  70. ## 🎯 Features / 特性
  71. <table>
  72. <tr>
  73. <td width="60" align="center">🚀</td>
  74. <td><strong>One-command generation / 一键生成</strong><br>Provide thesis (.tex/.docx/.pdf), everything auto<br>提供论文,全流程自动</td>
  75. </tr>
  76. <tr>
  77. <td align="center">📐</td>
  78. <td><strong>13 page layouts / 13 种版式</strong><br>Cover, TOC, section divider, text-only, text+image, formula, table, full-image, conclusion, transition, list, thanks<br>封面、目录、分隔页、纯文段、左文右图、公式、表格、满版图、结论框、过渡、列表、致谢</td>
  79. </tr>
  80. <tr>
  81. <td align="center">✏️</td>
  82. <td><strong>Interactive editing / 交互修改</strong><br>Modify by page number after generation, no LaTeX needed<br>按页码精准修改,无需懂 LaTeX</td>
  83. </tr>
  84. <tr>
  85. <td align="center">🎨</td>
  86. <td><strong>5 color schemes / 5 种配色</strong><br>Blue / Red / Green / Purple / Teal — one-line config change<br>蓝/红/绿/紫/青,一行配置切换</td>
  87. </tr>
  88. <tr>
  89. <td align="center">🎓</td>
  90. <td><strong>Multi-scenario / 多场景</strong><br>Thesis defense, proposal, academic conference<br>毕业答辩、开题报告、学术会议</td>
  91. </tr>
  92. <tr>
  93. <td align="center">🔧</td>
  94. <td><strong>Auto error-fix / 自动纠错</strong><br>Detects and fixes overflow, overlap, and layout issues<br>自动检测图文重叠、溢出等排版问题并修复</td>
  95. </tr>
  96. </table>
  97. <br>
  98. ## 🚀 Quick Start / 快速开始
  99. ### Installation / 安装
  100. ```bash
  101. # Claude Code
  102. git clone https://github.com/Faust-Donf/beamer-academic.git ~/.claude/skills/beamer-academic
  103. # Codex
  104. git clone https://github.com/Faust-Donf/beamer-academic.git ~/.codex/skills/beamer-academic
  105. ```
  106. ### Prerequisites / 前置依赖
  107. <details>
  108. <summary><kbd>LaTeX Installation / LaTeX 安装</kbd> (click to expand / 点击展开)</summary>
  109. <br>
  110. ```bash
  111. # macOS
  112. brew install --cask mactex-no-gui
  113. # Ubuntu / Debian
  114. sudo apt install texlive-xetex texlive-lang-chinese texlive-fonts-recommended
  115. # Fedora
  116. sudo dnf install texlive-xetex texlive-xecjk
  117. # Windows (WSL)
  118. sudo apt install texlive-xetex texlive-lang-chinese
  119. ```
  120. </details>
  121. > [!NOTE]
  122. > No LaTeX installed? The Skill will guide you through setup.
  123. > 没装 LaTeX?Skill 会引导你配置环境。
  124. ### Input Format / 论文输入格式
  125. | Format | | Notes |
  126. |:--|:--:|:--|
  127. | `.tex` | ⭐⭐⭐ | **Best / 首选** — figures & formulas reused directly / 图片公式直接复用 |
  128. | `.docx` | ⭐⭐⭐ | **Great / 推荐** — full image quality / 图片质量完整 |
  129. | `.pdf` | ⚠️ | **Not recommended / 不推荐** — quality loss / 有损耗 |
  130. > [!IMPORTANT]
  131. > If you have the source file (Word / LaTeX), **use that instead of PDF**.
  132. > 如果有 Word 或 LaTeX 源文件,**请优先使用**,不要转成 PDF。
  133. ### Usage / 使用
  134. ```bash
  135. mkdir my-defense && cp thesis.docx my-defense/ && cd my-defense
  136. ```
  137. Then say / 然后说:
  138. ```
  139. "Make my defense slides" or "帮我做答辩PPT"
  140. ```
  141. Or type / 或输入: `/beamer-academic`
  142. The Skill asks a few questions (university, name, advisor, color), then runs the full pipeline automatically.
  143. Skill 会问几个基本信息(学校、姓名、导师、配色),然后全自动跑完。
  144. <br>
  145. ## ⚙️ How It Works / 工作流程
  146. ```
  147. Thesis / 论文 ──┐
  148. ▼
  149. ┌──────────────────┐
  150. │ Extract / 素材 │ Figures, tables, formulas, structure
  151. └────────┬─────────┘
  152. ▼
  153. ┌──────────────────┐
  154. │ Outline / 大纲 │ Auto-assigns 13 layout types
  155. └────────┬─────────┘
  156. ▼
  157. ┌──────────────────┐
  158. │ ★ Confirm / 确认 │ ← Only manual step (say "ok")
  159. └────────┬─────────┘
  160. ▼
  161. ┌──────────────────┐
  162. │ Generate / 生成 │ Fills layout templates page by page
  163. └────────┬─────────┘
  164. ▼
  165. ┌──────────────────┐
  166. │ Compile / 编译 │ xelatex × 2
  167. └────────┬─────────┘
  168. ▼
  169. ┌──────────────────┐
  170. │ Edit Loop / 修改 │ "P7 too dense" → auto-split & recompile
  171. └──────────────────┘
  172. ```
  173. <br>
  174. ## 📐 Layouts / 版式库
  175. 13 battle-tested academic layouts / 13 种经过实战验证的学术版式:
  176. | Layout / 版式 | File | When / 何时用 |
  177. |:--|:--|:--|
  178. | Cover / 封面 | `cover.tex` | First page / 第一页 |
  179. | TOC / 目录 | `toc.tex` | Second page / 第二页 |
  180. | Section Divider / 章节分隔 | `section-divider.tex` | Chapter start / 每章开头 |
  181. | Text Only / 纯文段 | `text-only.tex` | Background, motivation / 背景、动机 |
  182. | Text + Image Right / 左文右图 | `text-left-image-right.tex` | Text-driven / 文字为主 |
  183. | Image + Text Right / 左图右文 | `image-left-text-right.tex` | Image-driven / 图为主 |
  184. | Formula / 公式 | `formula.tex` | Equations / 模型定义 |
  185. | Table / 表格 | `table.tex` | Results / 实验结果 |
  186. | Full Image / 满版图 | `full-image.tex` | Large diagrams / 大图 |
  187. | Conclusion / 结论框 | `conclusion-box.tex` | Key findings / 核心结论 |
  188. | Transition / 过渡 | `transition.tex` | Bridge / 承上启下 |
  189. | List / 列表 | `list.tex` | Contributions / 创新点 |
  190. | Thanks / 致谢 | `thanks.tex` | Final page / 最后一页 |
  191. See [`layouts/_registry.yaml`](layouts/_registry.yaml) for detailed layout definitions.
  192. <br>
  193. ## 🎨 Color Schemes / 配色方案
  194. ```yaml
  195. # assets/config.yaml
  196. color_scheme: "blue" # blue | red | green | purple | teal
  197. ```
  198. | Scheme / 方案 | Color / 色值 | For / 推荐 |
  199. |:--|:--|:--|
  200. | 🔵 Blue / 蓝 | `rgb(26, 58, 92)` | STEM / 理工科 (default) |
  201. | 🔴 Red / 红 | `rgb(139, 0, 0)` | Humanities / 人文社科 |
  202. | 🟢 Green / 绿 | `rgb(0, 100, 60)` | Agriculture, Env / 农林环境 |
  203. | 🟣 Purple / 紫 | `rgb(75, 0, 110)` | Arts / 文科艺术 |
  204. | 🔷 Teal / 青 | `rgb(0, 80, 100)` | Medicine / 医学海洋 |
  205. <br>
  206. ## 🛠️ Customization / 自定义
  207. ### Your University / 换成自己学校
  208. ```yaml
  209. # assets/config.yaml
  210. institution:
  211. name: "Your University / 你的大学"
  212. department: "Your Department / 你的学院"
  213. logo: "your-logo.png"
  214. gate_image: "your-gate.png" # Thanks page (optional / 可选)
  215. color_scheme: "red"
  216. ```
  217. ### Add New Layouts / 添加新版式
  218. 1. Add a layout section in `references/layouts.md`
  219. 2. Register in `references/layout-registry.yaml` (define `when` and `slots`)
  220. 3. Done / 完成
  221. <br>
  222. ## 🤔 Why Beamer? / 为什么用 Beamer?
  223. Many AI tools generate slides as images. This project uses LaTeX/Beamer — a deliberate choice validated through real defenses.
  224. 市面上不少 AI PPT 工具走图片生成路线。本项目选择 LaTeX/Beamer,是经过真实答辩验证的选择。
  225. | Dimension / 维度 | Beamer Academic | Image-based / 图片生成 |
  226. |:--|:--|:--|
  227. | **Academic safety / 学术安全** | Template-constrained, advisor-approved style<br>模板约束,不会"一看就是AI" | Unpredictable style<br>视觉不确定 |
  228. | **Accuracy / 准确性** | Extracts original figures & formulas<br>原图原公式 | May contain errors<br>可能有误 |
  229. | **Editability / 可编辑** | Full `.tex` source control<br>源码完全可控 | Hard to modify locally<br>改动困难 |
  230. | **Reproducibility / 可复现** | Same `.tex` = same PDF<br>永远一致 | Different each time<br>每次不同 |
  231. ### Best For / 适合谁
  232. | ✅ | ❌ |
  233. |:--|:--|
  234. | Thesis defense / 毕业答辩 | Business pitches / 商业路演 |
  235. | Proposal defense / 开题报告 | Product launches / 产品发布 |
  236. | Conference talks / 学术会议 | Creative presentations / 创意设计 |
  237. | Lab meetings / 组会汇报 | |
  238. <br>
  239. ## 📁 Project Structure / 项目结构
  240. ```
  241. beamer-academic/
  242. ├── SKILL.md # Main skill file (AI reads this)
  243. ├── references/
  244. │ ├── layouts.md # 13 layout LaTeX skeletons
  245. │ ├── layout-registry.yaml # Layout selection rules
  246. │ └── tex-header.md # .tex preamble template
  247. ├── assets/
  248. │ ├── beamerthemeAcademic.sty # Beamer theme file
  249. │ └── config.yaml # User config template
  250. ├── scripts/
  251. │ ├── compile.sh # Compilation script
  252. │ └── extract_figures.py # Figure extraction (PDF/DOCX/LaTeX)
  253. ├── examples/
  254. │ └── transformer/ # Full working example (26 pages)
  255. ├── docs/ # Screenshot gallery
  256. └── README.md
  257. ```
  258. <br>
  259. ## 📈 Star History
  260. <p align="center">
  261. <a href="https://star-history.com/#Faust-Donf/beamer-academic&Date">
  262. <img src="https://api.star-history.com/svg?repos=Faust-Donf/beamer-academic&type=Date" alt="Star History Chart" width="600">
  263. </a>
  264. </p>
  265. <br>
  266. ## 🤝 Contributing
  267. Contributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md).
  268. 欢迎贡献!请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
  269. ## 👤 Author / 作者
  270. **Faustus** · [Xiaohongshu / 小红书](https://xhslink.com/m/2JQ3fmTu6dz)
  271. ## 📄 License
  272. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.