Skip to content
Back to search

powerpoint-skill

AI coding assistant skill for creating visually rich PowerPoint (.pptx) presentations with native OMML math, LaTeX formulas, and Graphviz/Mermaid/TikZ diagrams

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

HTML

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

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

Claude Code

Copy the skill directory into your Claude Code skills folder:

mkdir -p ~/.claude/skills
cp -r powerpoint-skill/powerpoint-slides ~/.claude/skills/

Restart Claude Code. The skill triggers automatically when you mention powerpoint, pptx, PPT, slides, or related keywords.

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 · 239 lines

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

  1. # PowerPoint Slides Skill
  2. An AI coding assistant skill for creating visually rich **PowerPoint (.pptx)** presentations from academic papers, research notes, or any structured content.
  3. Built on **PptxGenJS** (Node.js) with native **OMML math** + LaTeX image rendering, **Graphviz/Mermaid/TikZ** diagram pipelines, and 5 built-in color themes.
  4. Supports **Claude Code** natively. Adaptable to other AI coding assistants.
  5. ## Features
  6. | Action | Description |
  7. |--------|-------------|
  8. | `create [topic/paper]` | Full lifecycle: material analysis → interview → structure plan → formula/diagram prep → script generation → QA loop |
  9. | `compile [file.js]` | Execute PptxGenJS script to generate .pptx |
  10. | `review [file.pptx]` | Read-only proofreading report (grammar, typos, consistency, academic quality) |
  11. | `audit [file.pptx]` | Visual layout audit via PDF→image inspection |
  12. | `visual-check [file.pptx]` | PDF-based systematic visual review with parallel subagents |
  13. | `validate [file.pptx]` | Structural validation against skill constraints |
  14. | `extract-figures [pdf]` | Extract figures from paper PDFs for slide inclusion |
  15. ### Highlights
  16. - **5 color themes** — Academic Light (default), Midnight, Ocean, Forest, Sandwich (dark title + light content)
  17. - **OMML math (native)** — display/inline formulas rendered as native PowerPoint math via pandoc, editable after generation
  18. - **LaTeX image fallback** — paragraph-mode formulas rendered at 600 DPI via XeLaTeX pipeline
  19. - **5-layer diagram pipeline** — Graphviz (structural) → Mermaid (behavioral) → TikZ (math) → PptxGenJS shapes (native) → PDF extraction
  20. - **Theme color injection** — diagrams automatically use the slide theme's color palette
  21. - **Quality scoring** — automated rubric (start at 100, deduct per issue) with visual QA via parallel subagents
  22. - **29 hard rules** — covering content density, layout diversity, typography, math rendering, boundary validation, overflow prevention
  23. - **Mathematical slide patterns** — 5 structural templates (Definition, Construction, Comparison, Theorem-Proof, Insight)
  24. - **Content density guards** — both upper bounds (7 bullets, 2 formulas, 5 symbols/slide) and lower bounds (every slide earns its place)
  25. - **Visual-first planning** — "10-second test" ensures diagrams/tables/charts where text alone fails
  26. - **Pacing control** — talk-type tips, timing allocation, max 3-4 consecutive theory slides before a visual break
  27. - **16:9 layout** with precise positioning via layout constants (`SW`/`SH`/`M`/`CW`/`CY`/`CH`)
  28. - **17 helper functions** — `sTitle`, `sectionSlide`, `addBullets`, `addCard`, `addTable`, `addNumCard`, `addFlow`, `addChart`, `addFormula`, `addDiagram`, `cols2`, etc.
  29. - **9 layout code patterns** — two-column, three-card, process flow, formula-centered, striped table, stat callout, text+diagram, full-diagram, chart-centered
  30. ## Prerequisites
  31. ### Required
  32. ```bash
  33. # Node.js (PptxGenJS runtime)
  34. brew install node
  35. # pandoc (OMML formula conversion)
  36. brew install pandoc
  37. # TeX distribution (LaTeX image formulas + TikZ diagrams)
  38. brew install --cask mactex
  39. # Graphviz (diagram rendering)
  40. brew install graphviz
  41. # Python packages (image processing, OMML injection)
  42. pip install Pillow lxml
  43. # LibreOffice (PPT→PDF for visual QA)
  44. brew install --cask libreoffice
  45. # markitdown (text extraction for content verification)
  46. pip install "markitdown[pptx]"
  47. ```
  48. ### Recommended
  49. ```bash
  50. # Mermaid CLI (sequence/Gantt/pie/state/ER diagrams)
  51. # Without it, Mermaid diagrams fall back to Graphviz or PptxGenJS shapes
  52. npm install -g @mermaid-js/mermaid-cli
  53. ```
  54. ### Optional
  55. ```bash
  56. # Ghostscript (SVG formula output via dvisvgm)
  57. brew install ghostscript
  58. ```
  59. ### pdf-mcp (Recommended)
  60. Install [pdf-mcp](https://github.com/Noi1r/pdf-mcp) (fork with file-based image extraction — avoids base64 token bloat) so the AI assistant can read papers and extract figures:
  61. ```bash
  62. pip install git+https://github.com/Noi1r/pdf-mcp.git
  63. claude mcp add pdf-mcp --scope user pdf-mcp
  64. ```
  65. ## Installation
  66. Clone the repo:
  67. ```bash
  68. git clone https://github.com/Noi1r/powerpoint-skill.git
  69. ```
  70. ### Claude Code
  71. Copy the skill directory into your Claude Code skills folder:
  72. ```bash
  73. mkdir -p ~/.claude/skills
  74. cp -r powerpoint-skill/powerpoint-slides ~/.claude/skills/
  75. ```
  76. Restart Claude Code. The skill triggers automatically when you mention powerpoint, pptx, PPT, slides, or related keywords.
  77. ## Usage
  78. **Create slides from a paper:**
  79. ```
  80. Help me make a PPT based on this paper: /path/to/paper.pdf
  81. ```
  82. **Create slides with specific theme:**
  83. ```
  84. Make a presentation about X using the Midnight theme
  85. ```
  86. **Compile an existing script:**
  87. ```
  88. Compile generate_slides.js
  89. ```
  90. **Review a presentation:**
  91. ```
  92. Review my slides: output.pptx
  93. ```
  94. **Extract figures from a paper:**
  95. ```
  96. Extract figures from /path/to/paper.pdf pages 3-5
  97. ```
  98. ## How It Works
  99. ### Creation Pipeline
  100. ```
  101. Phase 0: Paper Analysis (extract key concepts, prerequisites, notation)
  102. ↓
  103. Phase 1: Requirements Interview (duration, audience, scope, theme)
  104. ↓
  105. Phase 2: Structure Plan (GATE — user approval required)
  106. ↓
  107. Phase 3: Formula Preparation (LaTeX → OMML metadata + PNG@600DPI)
  108. ↓
  109. Phase 3.5: Diagram Preparation (DOT/Mermaid/TikZ → SVG/PNG)
  110. ↓
  111. Phase 4: Generate JS Script (PptxGenJS with helpers + self-review)
  112. ↓
  113. Phase 5: QA Loop (execute → PDF → visual inspection → score → fix)
  114. ↓
  115. Post-Creation Checklist (final gate)
  116. ```
  117. ### Formula Pipeline
  118. ```
  119. formulas.json → render_latex.py → formulas/manifest.json
  120. ↓
  121. image entries: PNG@600DPI
  122. omml entries: metadata only
  123. ↓
  124. generate_slides.js → .pptx (with {{MATH:id}} placeholders)
  125. ↓
  126. inject_omml.py → .pptx (native OMML math injected)
  127. ```
  128. ### Diagram Pipeline
  129. ```
  130. diagrams.json → render_diagrams.py → diagrams/manifest.json
  131. ↓
  132. Graphviz → SVG (structural diagrams)
  133. Mermaid → SVG (behavioral diagrams)
  134. TikZ → SVG/PNG (math diagrams)
  135. Extract → PNG@300DPI (paper figures)
  136. ```
  137. ## Color Themes
  138. | Theme | Style | Best For |
  139. |-------|-------|----------|
  140. | **Academic Light** | White/light gray, clean | Research talks, seminars |
  141. | **Midnight** | Dark throughout | Tech, premium feel |
  142. | **Ocean** | Blue tones | Professional academic |
  143. | **Forest** | Green natural tones | Biology, environmental |
  144. | **Sandwich** | Dark title/conclusion + light content | Conference talks |
  145. ## File Structure
  146. ```
  147. powerpoint-skill/
  148. ├── powerpoint-slides/
  149. │ ├── SKILL.md # Main skill definition (29 rules, 9 actions)
  150. │ ├── formula-rendering.md # OMML + LaTeX image pipeline docs
  151. │ ├── diagram-rendering.md # 5-layer diagram pipeline docs
  152. │ ├── pptxgenjs-reference.md # PptxGenJS API + 9 layout code patterns
  153. │ ├── references/
  154. │ │ └── themes.md # Theme JSON, script template, 17 helpers
  155. │ └── scripts/
  156. │ ├── render_latex.py # Batch formula renderer (600 DPI + SVG)
  157. │ ├── render_diagrams.py # Batch diagram renderer (Graphviz/Mermaid/TikZ)
  158. │ ├── inject_omml.py # OMML post-processor (pandoc → OMML XML)
  159. │ ├── check_overlaps.py # Card-aware overlap & boundary checker
  160. │ ├── soffice.py # LibreOffice PPT→PDF wrapper
  161. │ └── thumbnail.py # Slide thumbnail grid generator
  162. ├── example/
  163. │ ├── Bünz et al. - Linear-Time Permutation Check.pdf
  164. │ └── linear_perm_slides/
  165. │ ├── generate_slides.js # Generated PptxGenJS script
  166. │ ├── formulas.json # 23 formulas (15 OMML + 8 image)
  167. │ ├── diagrams.json # 2 Graphviz diagrams
  168. │ └── linear_perm_slides.pptx # Output presentation (25 slides)
  169. ├── .gitignore
  170. ├── LICENSE
  171. └── README.md
  172. ```
  173. ## Known Limitation: LibreOffice & OMML
  174. OMML (Office MathML) is PowerPoint's native math format. LibreOffice does not fully support OMML rendering — when converting `.pptx` to PDF via LibreOffice (`soffice`), OMML formulas may appear blank or distorted. This is a LibreOffice limitation, not a bug in the generated file. The formulas display correctly in Microsoft PowerPoint and WPS Office.
  175. The QA visual-check step uses LibreOffice for PDF conversion, so OMML formulas are expected to look wrong in the QA preview. Only image-rendered formulas (LaTeX → PNG) are checked for visual clarity during QA.
  176. ## Example
  177. The `example/` directory contains a complete real-world example:
  178. **Linear-Time Permutation Check** (Bünz, Chen, DeStefano, NYU 2025)
  179. - 25-slide Academic Light theme presentation
  180. - 23 formulas (15 native OMML + 8 LaTeX image)
  181. - 2 Graphviz diagrams with theme color injection
  182. - Source paper PDF included
  183. ## License
  184. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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