manim-slides

Manim Slides Skill

A reusable skill for Claude Code and Codex that teaches authoring of manim-slides 5.6.0 presentations and ships scaffolding + build helpers focused on RevealJS HTML output.

The skill content lives in skills/manim-slides/SKILL.md.

What it does

• Teaches Slide subclassing, next_slide() keyword arguments (loop, auto_next, notes, vertical stacks), ThreeDSlide, transitions, and common pitfalls.
• Ships scripts/scaffold.py (bootstrap a new presentation directory) and scripts/build.py (one-shot render → RevealJS HTML).
• Covers the live Qt presenter, RevealJS conversion options, and includes a progressive-disclosure references/ folder for advanced topics (RevealJS customization, performance tips, ManimGL backend, PPTX/PDF/ZIP, Sphinx + Jupyter).

Installation

Claude Code (Plugin)

This repo is a Claude Code plugin (manifest at .claude-plugin/plugin.json).

Option 1: Marketplace (recommended)

/plugin marketplace add RubenBranco/Manim-Slides-Skill
/plugin install manim-slides

Option 2: Install from source

git clone https://github.com/RubenBranco/Manim-Slides-Skill.git
cc --plugin-dir /path/to/Manim-Slides-Skill

After install, runtime dependencies still need to be installed (see "Python Package" below).

Codex

See .codex/INSTALL.md.

Python Package

Using uv (recommended):

cd skills/manim-slides
uv pip install -e .

Using pip:

cd skills/manim-slides
pip install -r requirements.txt

System dependencies

• ffmpeg is required for all rendering.
• LaTeX (TeX Live, MacTeX, MiKTeX) only if you use Tex / MathTex.
• Python ≥ 3.9.
• Qt (PySide6 or PyQt6) only if you run the live manim-slides present GUI.

Quick start

cd skills/manim-slides

# 1. Scaffold a new presentation directory
python3 scripts/scaffold.py ~/my-talk

# 2. Edit the generated slides.py
$EDITOR ~/my-talk/slides.py

# 3. Render and convert to RevealJS HTML
python3 scripts/build.py ~/my-talk/slides.py MyTalk

presentation.html lands in your CWD by default. Open it in any browser.

Testing

cd skills/manim-slides
pip install -e ".[dev]"

# Unit tests (fast, no network, no ffmpeg required)
pytest -m "not integration" -v

# Integration smoke (requires ffmpeg installed)
pytest -m integration -v

Skill content

• skills/manim-slides/SKILL.md — main skill content.
• skills/manim-slides/references/ — advanced topics (RevealJS customization, performance, ManimGL, PPTX/PDF/ZIP, Sphinx/Jupyter).

Versioning

Component	Version
manim-slides	5.6.0
Skill plugin	0.1.0
Manim CE (recommended)	≥ 0.19
ManimGL (optional)	≥ 1.7.2

License

MIT.