Skip to content
Back to search

beamer-skill

SkillWorks with Claude CodeGitHub

A Claude Code skill for creating, compiling, reviewing, and polishing academic Beamer LaTeX presentations. Full lifecycle workflow with quality scoring, pedagogical review, TikZ audit, and more.

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/noi1r-beamer-skill/badge.svg)](/listings/noi1r-beamer-skill)

HTML

<a href="/listings/noi1r-beamer-skill"><img src="/api/listings/noi1r-beamer-skill/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.

Clone the repo first:

git clone https://github.com/Noi1r/beamer-skill.git

Claude Code

Copy the skill directory into your Claude Code skills folder:

mkdir -p ~/.claude/skills
cp -r beamer-skill/beamer ~/.claude/skills/

Restart Claude Code. The skill will be automatically detected and triggered when you mention beamer, slides, lecture, tikz, or related keywords.

OpenAI Codex CLI

Copy `AGENTS.md` and `references/` into your project root:

cp beamer-skill/beamer/AGENTS.md your-project/AGENTS.md
cp -r beamer-skill/beamer/references your-project/references

Codex CLI automatically reads `AGENTS.md` from the working directory. The main file contains core rules and action summaries; detailed workflows are in `references/` and referenced as needed.

Google Antigravity

Antigravity is compatible with the `SKILL.md` format. Copy the skill directory:

mkdir -p ~/.claude/skills
cp -r beamer-skill/beamer ~/.claude/skills/

The same `SKILL.md` used by Claude Code works with Antigravity without modification.

VS Code — GitHub Copilot

Copy the Copilot instructions file into your project:

mkdir -p your-project/.github
cp beamer-skill/.github/copilot-instructions.md your-project/.github/

Copilot Chat automatically reads `.github/copilot-instructions.md` and applies the rules during conversations.

VS Code — Cline

Copy the Cline rules file into your project:

mkdir -p your-project/.clinerules
cp beamer-skill/.clinerules/beamer.md your-project/.clinerules/

Cline automatically loads all files in `.clinerules/` as custom instructions.

VS Code — Cursor

Copy the Cursor rules file into your project:

mkdir -p your-project/.cursor/rules
cp beamer-skill/.cursor/rules/beamer.mdc your-project/.cursor/rules/

Cursor automatically loads `.mdc` files from `.cursor/rules/`. The `globs` field in the frontmatter ensures the rules activate for `.tex`, `.bib`, and `.sty` files.

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.

README.md · README · 403 lines

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

  1. # Beamer Skill
  2. An AI coding assistant skill for creating, compiling, reviewing, and polishing academic **Beamer LaTeX** presentations.
  3. Supports **Claude Code**, **OpenAI Codex CLI**, **Google Antigravity**, and **VS Code** AI extensions (Copilot, Cline, Cursor).
  4. Full lifecycle: **create → compile → review → polish → verify.**
  5. Need an editable PowerPoint at the end? Use the optional **Beamer-first, PowerPoint-second** workflow below: establish the argument, technical depth, and visual structure in Beamer, then hand the verified `.tex` and `.pdf` to Codex Presentations for an editable `.pptx` rebuild.
  6. ## Features
  7. | Action | Description |
  8. |--------|-------------|
  9. | `create [topic]` | Collaborative, iterative lecture creation with phase gates (material analysis → needs interview → structure plan → draft → quality loop) |
  10. | `compile [file]` | 3-pass XeLaTeX + bibtex with post-compile diagnostics |
  11. | `review [file]` | Read-only proofreading report (grammar, typos, overflow, consistency, academic quality) |
  12. | `audit [file]` | Visual layout audit (overflow, fonts, boxes, spacing) |
  13. | `pedagogy [file]` | Holistic pedagogical review with 13 validation patterns |
  14. | `tikz [file]` | TikZ diagram review and SVG extraction |
  15. | `excellence [file]` | Comprehensive multi-dimensional quality review |
  16. | `devils-advocate [file]` | Challenge slide design with pedagogical questions |
  17. | `visual-check [file]` | PDF-based visual verification of compiled slides |
  18. | `validate [file]` | Structural validation against skill constraints |
  19. | `extract-figures [pdf]` | Extract figures from paper PDFs for direct inclusion in slides |
  20. ### Highlights
  21. - **Quality scoring system** — automated rubric (start at 100, deduct per issue) with Excellent/Good/Needs Work/Poor thresholds
  22. - **No overlays** — no `\pause`, `\onslide`, `\only`. Uses multiple slides and color emphasis instead
  23. - **Content density guards** — upper bounds (7 bullets, 2 equations, 5 symbols per slide) and lower bounds (every slide earns its place)
  24. - **Box overflow detection** — Beamer suppresses overflow warnings inside blocks; the skill catches them via visual audit
  25. - **Motivation before formalism** — every concept starts with "Why?" before "What?"
  26. - **TikZ precision** — mathematical accuracy enforced via `\pgfmathsetmacro` (no hardcoded approximations)
  27. - **Semantic color system** — colorblind-safe palette (`\pos{}`, `\con{}`, `\HL{}`) with WCAG AA contrast (≥ 4.5:1)
  28. - **Figure extraction** — pull figures directly from paper PDFs via `pdf-mcp`, ready for `\includegraphics`
  29. - **Markdown paper input** — use `.md` as a clean intermediate when PDF parsing loses structure; keep the PDF available for figures
  30. - **Timing allocation** — built-in slide-count heuristics for 5min lightning talks through 90min lectures
  31. - **Columns & layout rules** — enforced `columns[T]` patterns with gap/width constraints
  32. - **Backup slides** — automatic appendix section for anticipated Q&A
  33. - **Algorithm & code support** — `algorithm2e`, `listings`, `pgfplots` integration with per-slide line limits
  34. - **XeLaTeX only** — modern font handling, 16:9 aspect ratio, 10pt default
  35. - **Editable PPTX hand-off** — a documented workflow for rebuilding a verified Beamer deck with Codex Presentations without asking this skill to become a PowerPoint generator
  36. ## Prerequisites
  37. ### TeX Distribution
  38. A full TeX distribution with XeLaTeX is required:
  39. ```bash
  40. # macOS
  41. brew install --cask mactex
  42. # Ubuntu/Debian
  43. sudo apt install texlive-full
  44. # Arch
  45. sudo pacman -S texlive
  46. ```
  47. ### pdf-mcp (Recommended)
  48. Install [pdf-mcp](https://github.com/Noi1r/pdf-mcp) (fork with file-based image extraction — avoids base64 token bloat) so Claude Code can read large PDFs (papers, references) and extract figures directly:
  49. ```bash
  50. pip install git+https://github.com/Noi1r/pdf-mcp.git
  51. claude mcp add pdf-mcp --scope user pdf-mcp
  52. ```
  53. If you use a SOCKS proxy, also install `socksio` (required by `httpx` for SOCKS support):
  54. ```bash
  55. pip install socksio
  56. ```
  57. This enables the `create` action to analyze research papers and `extract-figures` to pull figures for slide inclusion.
  58. ## Installation
  59. Clone the repo first:
  60. ```bash
  61. git clone https://github.com/Noi1r/beamer-skill.git
  62. ```
  63. ### Claude Code
  64. Copy the skill directory into your Claude Code skills folder:
  65. ```bash
  66. mkdir -p ~/.claude/skills
  67. cp -r beamer-skill/beamer ~/.claude/skills/
  68. ```
  69. Restart Claude Code. The skill will be automatically detected and triggered when you mention beamer, slides, lecture, tikz, or related keywords.
  70. ### OpenAI Codex CLI
  71. Copy `AGENTS.md` and `references/` into your project root:
  72. ```bash
  73. cp beamer-skill/beamer/AGENTS.md your-project/AGENTS.md
  74. cp -r beamer-skill/beamer/references your-project/references
  75. ```
  76. Codex CLI automatically reads `AGENTS.md` from the working directory. The main file contains core rules and action summaries; detailed workflows are in `references/` and referenced as needed.
  77. ### Google Antigravity
  78. Antigravity is compatible with the `SKILL.md` format. Copy the skill directory:
  79. ```bash
  80. mkdir -p ~/.claude/skills
  81. cp -r beamer-skill/beamer ~/.claude/skills/
  82. ```
  83. The same `SKILL.md` used by Claude Code works with Antigravity without modification.
  84. ### VS Code — GitHub Copilot
  85. Copy the Copilot instructions file into your project:
  86. ```bash
  87. mkdir -p your-project/.github
  88. cp beamer-skill/.github/copilot-instructions.md your-project/.github/
  89. ```
  90. Copilot Chat automatically reads `.github/copilot-instructions.md` and applies the rules during conversations.
  91. ### VS Code — Cline
  92. Copy the Cline rules file into your project:
  93. ```bash
  94. mkdir -p your-project/.clinerules
  95. cp beamer-skill/.clinerules/beamer.md your-project/.clinerules/
  96. ```
  97. Cline automatically loads all files in `.clinerules/` as custom instructions.
  98. ### VS Code — Cursor
  99. Copy the Cursor rules file into your project:
  100. ```bash
  101. mkdir -p your-project/.cursor/rules
  102. cp beamer-skill/.cursor/rules/beamer.mdc your-project/.cursor/rules/
  103. ```
  104. Cursor automatically loads `.mdc` files from `.cursor/rules/`. The `globs` field in the frontmatter ensures the rules activate for `.tex`, `.bib`, and `.sty` files.
  105. ## Platform Comparison
  106. | Platform | Instruction file | Content level | Auto-trigger |
  107. |----------|-----------------|---------------|-------------|
  108. | Claude Code | `SKILL.md` | Full (~55KB) | Yes (keyword matching) |
  109. | Antigravity | `SKILL.md` | Full (~55KB) | Yes (keyword matching) |
  110. | Codex CLI | `AGENTS.md` + `references/` | Medium (~30KB total) | Yes (auto-reads AGENTS.md) |
  111. | VS Code Copilot | `.github/copilot-instructions.md` | Compact (~5KB) | Yes (auto-reads) |
  112. | VS Code Cline | `.clinerules/beamer.md` | Compact (~5KB) | Yes (auto-reads) |
  113. | VS Code Cursor | `.cursor/rules/beamer.mdc` | Compact (~5KB) | Yes (glob-triggered on .tex) |
  114. ## Usage
  115. Once installed, the skill is triggered automatically when you mention beamer, slides, lecture, tikz, or related keywords.
  116. **Create a lecture from a paper:**
  117. ```
  118. Help me create a beamer presentation based on this paper: /path/to/paper.pdf
  119. ```
  120. **Create from converted Markdown (recommended when PDF parsing is weak):**
  121. ```
  122. Help me create a beamer presentation based on this paper markdown: /path/to/paper.md
  123. ```
  124. Markdown often preserves section hierarchy, equations, captions, and references better than direct PDF reading. If PDF parsing loses structure, first convert the paper to Markdown with MinerU or another PDF-to-Markdown tool, then pass the `.md` file to `create`. This is optional; MinerU is not a required dependency. Keep the original PDF available when you need figure extraction or page-level visual reference.
  125. **Extract figures from a paper:**
  126. ```
  127. Extract figures from /path/to/paper.pdf for my slides
  128. ```
  129. **Compile slides:**
  130. ```
  131. Compile my slides: /path/to/slides.tex
  132. ```
  133. **Full quality check:**
  134. ```
  135. Run excellence review on /path/to/slides.tex
  136. ```
  137. **Proofread only:**
  138. ```
  139. Proofread /path/to/slides.tex
  140. ```
  141. ## Recommended Workflow: Beamer First, Editable PowerPoint Second
  142. Beamer and PowerPoint are good at different parts of the job. This workflow deliberately separates **editorial reasoning** from **delivery-format production**:
  143. - The **Beamer skill** reads the source material, adapts the talk to its audience and duration, gates the outline for approval, fixes notation, develops protocol diagrams, and validates the resulting PDF.
  144. - **Codex Presentations** rebuilds that approved deck as an editable PowerPoint, using native text, tables, and simple diagram objects where practical, then performs format-specific rendering and layout QA.
  145. Starting from the paper in Beamer gives the talk a strong thesis and technical spine before PowerPoint layout decisions begin. Starting the PowerPoint stage from an approved deck reduces the risk that a visually clean rebuild silently changes the slide order, drops assumptions, or flattens the main contribution.
  146. > This is a controlled hand-off, not a one-click LaTeX-to-PowerPoint conversion. The Beamer deck remains the authority for content and reasoning; the PPTX is the editable delivery artifact.
  147. ```mermaid
  148. flowchart LR
  149. A["Paper / source material"] --> B["Beamer skill"]
  150. B --> C["Approved outline"]
  151. C --> D["deck.tex"]
  152. D --> E["Compiled + visually checked deck.pdf"]
  153. I["Figures, data, .bib, styles, source log"] --> F
  154. D -->|"content, notation, slide order"| F["Codex Presentations"]
  155. E -->|"visual reference"| F
  156. F --> G["Editable deck.pptx"]
  157. G --> H["Render + overflow + semantic QA"]
  158. H -->|"layout or semantic mismatch"| F
  159. H -->|"approved content change"| D
  160. H -->|"pass"| J["Verified deck.pptx"]
  161. ```
  162. ### Stage 1 — Author and validate in Beamer
  163. 1. Give the Beamer skill the paper or source material, presentation duration, audience, and desired emphasis.
  164. 2. Approve the structure plan before slide drafting begins.
  165. 3. Treat `deck.tex` as the source of truth for claims, notation, formulas, diagrams, citations, and slide order.
  166. 4. Complete the Phase 5 quality loop: compile, review, fix, and recompile. Use `visual-check` or `excellence` as read-only evidence, address every critical and major finding, and independently rescore with the Phase 5 numeric rubric until the deck reaches at least 90. (`visual-check` and `excellence` do not themselves produce this numeric score.)
  167. 5. Prepare a self-contained hand-off bundle:
  168. - `deck.tex` — semantic source: exact content, formulas, hierarchy, and ordering
  169. - `deck.pdf` — visual source: composition, emphasis, spacing, and diagram appearance
  170. - referenced figures and vector assets — original files, not screenshots from the PDF
  171. - `.bib`, CSV/data files, custom `.sty`/theme files, and any plotting scripts needed to interpret the deck
  172. - font information and a compact source/provenance log when these are not already explicit in the deck
  173. Do not begin the PowerPoint rebuild while the narrative, technical claims, or protocol-flow semantics are still unsettled.
  174. ### Stage 2 — Rebuild and verify with Codex Presentations
  175. In a Codex environment with the Presentations skill available, ask it to:
  176. 1. Use `deck.tex` for content fidelity, `deck.pdf` for visual reference, and the rest of the hand-off bundle for original assets, data, citations, and styling context.
  177. 2. Recreate text, tables, diagrams, connectors, and charts as native editable PowerPoint objects where practical.
  178. 3. Preserve the approved section order, technical claims, notation, and takeaway hierarchy. Do not add or remove substantive content without explicit approval.
  179. 4. Carry slide-level provenance from the `.bib`, figure captions, and source log into `[Sources]` blocks in PowerPoint speaker notes. These blocks are source metadata, not a speaking script.
  180. 5. Render the generated PPTX, inspect every slide, and check overflow, font substitution, connector direction, table readability, and diagram semantics.
  181. The goal is not pixel-for-pixel imitation. It is a faithful, editable PowerPoint adaptation with the same argument and technical meaning.
  182. ### Keep the two versions from drifting
  183. | Change | Where to make it first |
  184. |--------|-------------------------|
  185. | Thesis, narrative, slide order, technical claim | `deck.tex` |
  186. | Formula, notation, protocol edge, diagram semantics | `deck.tex` |
  187. | Citation or reported result | `deck.tex` |
  188. | Office-specific alignment, non-semantic animation, delivery-time polish | `deck.pptx` |
  189. | Reveals or animation that change reasoning order | `deck.tex` as separate frames |
  190. If a PowerPoint edit changes meaning rather than presentation, back-port it to `deck.tex`, recompile the PDF, and refresh the affected PPTX slides. This preserves one authoritative argument instead of two slowly diverging decks.
  191. ### Copy-paste prompts
  192. Use three separate turns so the Beamer structure gate and the final format hand-off remain real approval points.
  193. **Turn 1 — analyze and propose the structure:**
  194. ```text
  195. Use the beamer skill to create a [DURATION]-minute academic talk from
  196. /path/to/paper.pdf for [AUDIENCE]. Emphasize [TOPICS]. Analyze the source and
  197. stop after the detailed structure plan. Do not draft slides until I approve it.
  198. ```
  199. **Turn 2 — after approving the structure:**
  200. ```text
  201. The structure is approved. Continue with the Beamer draft, compile it with
  202. XeLaTeX, and complete the Phase 5 quality loop. Use visual-check or excellence
  203. as read-only review evidence, fix every critical and major finding, and then
  204. rescore separately with the Phase 5 numeric rubric until the deck reaches 90.
  205. Deliver deck.tex, deck.pdf, and a self-contained hand-off bundle containing
  206. the referenced figures, data, bibliography, custom styles, fonts, and source log.
  207. ```
  208. **Turn 3 — after approving the Beamer deck:**
  209. ```text
  210. Use the Presentations skill to rebuild the approved Beamer deck as an
  211. editable 16:9 PowerPoint. Use deck.tex as the authority for content, notation,
  212. formulas, and slide order; use deck.pdf as the visual reference; use the hand-off
  213. bundle for original assets, data, citations, and style context. Preserve the
  214. technical claims and hierarchy. Recreate text, tables, and simple diagrams as
  215. editable native objects where practical. Add slide-level [Sources] metadata in
  216. speaker notes, render every slide, and fix all overflow, font, connector, semantic,
  217. and readability issues before delivering the verified deck.pptx.
  218. ```
  219. The PowerPoint stage is optional and requires a Codex environment with the Presentations skill. This repository itself creates and validates Beamer artifacts; it does not bundle a PPTX converter.
  220. ## Customization
  221. ### Default Presenter
  222. The skill defaults to:
  223. ```latex
  224. \author{Presenter: [name]}
  225. \institute{Shanghai Jiao Tong University}
  226. ```
  227. To change this, either:
  228. - Tell the AI assistant your name/affiliation when creating slides, or
  229. - Edit the preamble section in the corresponding instruction file (`SKILL.md`, `AGENTS.md`, or the VS Code config)
  230. ### Custom Templates
  231. If you have a custom beamer preamble, header file, or theme, simply provide it. The skill will use yours instead of the built-in default.
  232. ## Examples
  233. The `example/` directory contains real-world examples generated entirely by this skill:
  234. | Example | Topic | Type |
  235. |---------|-------|------|
  236. | `zkagent_slides` | zkAgent — zero-knowledge proof agents | Theoretical CS / cryptography |
  237. | `slides` | TWIST1⁺ FAP⁺ fibroblasts in Crohn's disease | Basic research (with extracted figures) |
  238. | `slides_EP` | Endoscopic papillectomy outcomes | Clinical retrospective study |
  239. Each example includes the source paper (PDF), the generated `.tex`, and the compiled `.pdf`. The `figures/` directory contains images extracted from the source papers via `extract-figures`.
  240. ## Benchmark: With Skill vs. Without Skill
  241. Automated evaluation comparing Claude Code **with** the beamer skill against a **baseline** (no skill). Each test was run by an independent subagent; assertions check objective, verifiable properties of the output.
  242. ### Test 1 — `create`: 10-min talk from a cryptography paper
  243. | Assertion | With Skill | Baseline |
  244. |-----------|:----------:|:--------:|
  245. | .tex file generated | Pass | Pass |
  246. | `aspectratio=169`, `10pt` | Pass | Pass |
  247. | No overlay commands | Pass | Pass |
  248. | Slide count in 8–12 range | Pass (11) | Pass (12) |
  249. | References slide (`thebibliography`) | Pass | **Fail** |
  250. | Backup slides after `\appendix` | Pass | **Fail** |
  251. | Semantic colors (`\pos`, `\con`, `\HL`) | Pass | **Fail** |
  252. | **Pass rate** | **7/7 (100%)** | **4/7 (57%)** |
  253. ### Test 2 — `review` + `validate`: proofread an existing slide deck
  254. | Assertion | With Skill | Baseline |
  255. |-----------|:----------:|:--------:|
  256. | Review report generated | Pass | Pass |
  257. | 5-category classification | Pass | **Fail** |
  258. | Standard issue format (Location / Current / Proposed / Severity) | Pass | **Fail** |
  259. | Separate validation report | Pass | **Fail** |
  260. | Structured validation table (slide count, aspect ratio, hard rules) | Pass | **Fail** |
  261. | Original `.tex` unmodified (read-only) | Pass | Pass |
  262. | **Pass rate** | **6/6 (100%)** | **2/6 (33%)** |
  263. ### Summary
  264. | Metric | With Skill | Baseline | Delta |
  265. |--------|:----------:|:--------:|:-----:|
  266. | Overall pass rate | 13/13 (100%) | 6/13 (46%) | **+54 pp** |
  267. | Mean tokens | ~65k | ~50k | +30% |
  268. | Mean wall time | ~230s | ~130s | +73% |
  269. > The skill guarantees structural compliance (references, backups, semantic colors, formatted reports) that the baseline consistently misses. Token/time overhead is moderate (~30%/~73%) relative to the quality gain.
  270. ## File Structure
  271. ```
  272. beamer-skill/
  273. ├── beamer/
  274. │ ├── SKILL.md # Full skill (Claude Code / Antigravity)
  275. │ ├── AGENTS.md # Codex CLI main file
  276. │ └── references/ # Codex CLI detailed rules
  277. │ ├── create-workflow.md # Phase 0-5 creation workflow
  278. │ ├── tikz-standards.md # TikZ quality standards & patterns
  279. │ └── review-actions.md # review/audit/pedagogy/excellence/validate
  280. ├── .github/
  281. │ └── copilot-instructions.md # VS Code Copilot
  282. ├── .clinerules/
  283. │ └── beamer.md # VS Code Cline
  284. ├── .cursor/
  285. │ └── rules/
  286. │ └── beamer.mdc # VS Code Cursor
  287. ├── example/ # Real-world examples
  288. │ ├── 199.pdf # Source paper (zkAgent)
  289. │ ├── zkagent_slides.* # Generated slides
  290. │ ├── slides.* # Crohn's disease fibrosis
  291. │ ├── slides_EP.* # Endoscopic papillectomy
  292. │ └── figures/ # Extracted paper figures
  293. ├── README.md
  294. └── LICENSE
  295. ```
  296. ## License
  297. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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