academic-beamer

Academic Beamer Loop turns papers, research progress, PQE material, and experiment results into claim-led, evidence-grounded LaTeX Beamer presentations.

The loop is:

source inspection -> evidence map -> slide outline -> Beamer generation -> compile -> render -> inspect -> revise

The skill is designed for CVPR, ICCV, ECCV, ACL, EMNLP, NAACL, AAAI, IJCAI, PQE, thesis proposals, lab meetings, and research progress talks.

What makes it different

• One slide communicates one main claim.
• Quantitative and key qualitative claims are traced through EVIDENCE_MAP.md.
• Timing is estimated before final polishing.
• Static validation is separate from visual inspection.
• A supplied LaTeX template takes priority.
• Without a supplied template, the bundled HKUST(GZ)-style fallback is used.
• The default author and affiliation remain placeholders: Author Name and Institution.

Install for Codex

Copy the repository contents into:

%CODEX_HOME%\skills\academic-beamer

Then restart Codex or refresh its skill index.

For a project-local installation, copy the repository to:

.codex/skills/academic-beamer

Typical request

Create a 12-minute Beamer conference talk from main.tex. Use the supplied template if present; otherwise use the fallback template. Ask for the author name and affiliation, build an evidence map and slide outline, compile, render, inspect every page, and write QA_REPORT.md.

一个面向研究汇报的 LaTeX Beamer skill：论文 / research progress / PQE 材料 -> claim-led slides -> PDF -> render -> visual QA。

构建支持系统级 latexmk，也支持项目内隔离的 Tectonic。可通过 TECTONIC_PATH、build.ps1 的 TectonicPath 或 build.sh 的 --tectonic-path 指定实际编译器。

作者姓名和单位由当前用户提供。没有提供时只保留 Author Name / Institution 占位符，并在最终定稿前请求补充；不会自动填入个人身份。没有用户上传 LaTeX 模板时，使用内置 HKUST(GZ)-style fallback template。

四种工作模式

• CREATE：从论文、notes、research progress、PQE 或实验素材创建新 deck。
• REVISE：保留事实、主题和有用图表，优化已有 TeX 或 PDF。
• REVIEW：只检查并输出 QA_REPORT.md，不进行大范围重写。
• POLISH：只做排版、间距、对齐、缩放和视觉层级优化。

CREATE / REVISE 默认生成 SLIDE_OUTLINE.md 和 EVIDENCE_MAP.md；需要讲稿时再生成 SPEAKER_NOTES.md 或 TALK_SCRIPT.md。Backup / Q&A slides 不计入 main talk timing。

使用方式

在 Codex 中可以这样描述任务：

把 main.tex 做成 12 分钟的 Beamer conference talk，保留真实实验结果，使用 academic-beamer 的完整编译、渲染和视觉 QA 流程。

或：

根据这篇论文生成 20 分钟组会 slides，先给出 slide-by-slide outline，再生成 Beamer，并检查表格、图和 overfull boxes。

文件说明

• SKILL.md：触发条件、工作流和硬性质量规则。
• references/：叙事、演讲节奏、版式、图和表格的按需参考。
• assets/template.tex：最小可运行的 16:9 Beamer 起始模板。
• assets/preamble.tex：学术蓝 / 暖红配色和常用宏。
• scripts/build.ps1：Windows 下调用 latexmk 构建。
• scripts/render_slides.py：使用 PyMuPDF 把 PDF 渲染为 PNG。
• scripts/check_overflow.py：检查 overfull boxes、致命 LaTeX 错误、未定义引用和过小字体风险。

全局启用

新增资源包括 build.sh、validate_deck.py、evidence-traceability.md、visual-qa.md、diagram-design.md 和 speaker-notes.md。静态检查不能替代视觉检查，必须执行 compile -> render -> inspect -> revise，并把结果写入 QA_REPORT.md。

评分维度为 narrative /25、evidence /20、readability /20、density /15、timing /10、technical correctness /10；硬性错误优先于总分。

当前副本位于工作区 .codex/skills/academic-beamer/。如果希望在所有项目中使用，把整个 academic-beamer 目录复制到：

%CODEX_HOME%\skills\academic-beamer\

复制后重新打开 Codex 会话，让 skill 索引刷新。