Manim Skill

Create videos like you write code, with your coding agent

Works with Claude Code and Codex. Your coding agent autonomously generates 3Blue1Brown-style videos following a structured workflow: Narration → TTS → Code → Render → Mux → View. Voiceover narration and time-synced subtitles are on by default.

Installation

git clone https://github.com/Yusuke710/manim-skill
cd manim-skill

# System libraries (macOS)
brew install cairo pkg-config ffmpeg
brew install --cask mactex-no-gui   # LaTeX — required for Tex/MathTex text rendering

# Python packages — Manim + local Kokoro voiceover(no API key needed), from pyproject.toml
uv sync

# Register the skill (symlink it into each agent's skills dir)
ln -s "$PWD/skills/manim-skill" ~/.claude/skills/manim-skill   # Claude Code
ln -s "$PWD/skills/manim-skill" ~/.codex/skills/manim-skill    # Codex
# Alternatively, ask your coding agent to add this skill

How it works

Describe the video to your coding agent. It chooses the scene structure directly in the animation code, without creating a separate plan document.

1. Generate - The agent writes spoken lines to narration.txt, generates local Kokoro TTS, writes Manim code using measured narration timing, checks subtitles, renders, and muxes until video.mp4 exists. Silent videos skip narration and go straight to code and rendering.

2. Iterate - Claude opens a video viewer in your browser. Add feedback, copy it into Claude Code, and Claude refines the video based on your notes. The same workflow works with Codex.

   Watch the video and pause at a moment you want to discuss. Click Capture or press t to add the current timestamp and scene name to Notes. Describe what to fix in that frame, request a change, or ask a question—for example, "These labels overlap; move them apart" or "Why does this token attend most strongly to cup?" Repeat for any other moments.

   Click Copy, paste the notes into Claude Code (or Codex), and send them. The agent can inspect the referenced frames, answer your questions, and update the affected scenes. Reload the viewer to watch the revised video and repeat as needed.

Local voiceover with Kokoro TTS

Narration uses Kokoro TTS, an open-weight text-to-speech model that runs locally without an API key. uv sync installs the Python dependencies.

Where files go

Every video is a flat session folder under one consistent home — never in your working directory:

~/.manim-skill/<project-slug>/    # narration.txt, script.py, video.mp4, media/, ...

Override the home with MANIM_SKILL_HOME. This means you can point the skill at your own codebase ("visualize this algorithm") without it leaving artifacts behind — it reads your files in place and writes only into the session folder.

License

MIT License - see LICENSE file for details.