Noi1r/beamer-skill

What it solves

Beamer Skill 提供了一个结构化的框架，让 AI 编程助手能够使用 Beamer LaTeX 创建、编译和完善学术演示文稿。它解决了 AI 生成的幻灯片过于密集、缺乏教学结构，或者无法满足严格的学术格式和视觉标准（例如避免溢出并确保色盲友好型对比度）的常见问题。

How it works

该项目提供了一组专门的指令文件（skills）”，可以集成到各种 AI 工具中，如 Claude Code、OpenAI Codex CLI、Cursor 和 GitHub Copilot。这些指令引导 AI 完成一个多阶段的生命周期：

1. Creation: 一个协作过程，从材料分析和结构规划到起草和质量循环。
2. Compilation: 一个带有诊断功能的 3-pass XeLaTeX 和 bibtex 过程。
3. Review & Audit: 用于校对、视觉布局审计（检测框溢出）、教学验证（使用 13 种模式）和 TikZ 图表审查的专门操作。
4. Verification: 一个数值质量评分系统，会针对问题扣分，直到达到阈值（例如 90/100）。

它还集成了 pdf-mcp，以便直接从研究论文中提取图片并包含在幻灯片中。

Who it’s for

使用 LaTeX 进行演示的科研人员、学者和学生，他们希望利用 AI 将研究论文转换为高质量、具有教学意义的 Beamer 幻灯片集。

Highlights

• Pedagogical Guardrails: 强制执行“形式化之前先说明动机”以及严格的内容密度限制（例如，每张幻灯片最多 7 个项目符号）。
• Visual Quality Control: 检测 Beamer 框溢出并强制执行 WCAG AA 对比度，以实现色盲友好的调色板。
• Technical Precision: 强制要求在 TikZ 图表中通过 \pgfmathsetmacro 进行计算，以避免硬编码的近似值。
• Cross-Platform Support: 兼容 Claude Code、Antigravity、Codex CLI 和 VS Code 扩展（Copilot、Cline、Cursor）。
• Figure Extraction: 能够从源 PDF 中提取图片，以便直接在 LaTeX 中使用。
• PowerPoint Hand-off: 一套记录在案的工作流，通过 Codex Presentations 将经过验证的 Beamer 幻灯片集转换为可编辑的 PowerPoint 文件。