# manim-composer

Adopt this skill: https://proskills.md/skills/other/adithya-s-k-manim-skill-skills-manim-composer

Page: https://proskills.md/skills/other/adithya-s-k-manim-skill-skills-manim-composer
This document is the public skill bundle for that page. It contains SKILL.md and every helper file the catalog carries. No login is required.

## File: skills/manim-composer/SKILL.md
size: 4700
upstream: https://github.com/adithya-s-k/manim_skill/blob/main/skills/manim-composer/SKILL.md

````text
---
name: manim-composer
description: |
  Trigger when: (1) User wants to create an educational/explainer video, (2) User has a vague concept they want visualized, (3) User mentions "3b1b style" or "explain like 3Blue1Brown", (4) User wants to plan a Manim video or animation sequence, (5) User asks to "compose" or "plan" a math/science visualization.

  Transforms vague video ideas into detailed scene-by-scene plans (scenes.md). Conducts research, asks clarifying questions about audience/scope/focus, and outputs comprehensive scene specifications ready for implementation with ManimCE or ManimGL.

  Use this BEFORE writing any Manim code. This skill plans the video; use manimce-best-practices or manimgl-best-practices for implementation.
---

## Workflow

### Phase 1: Understand the Concept

1. **Research the topic** deeply before asking questions
   - Use web search to understand the core concepts
   - Identify the key insights that make this topic interesting
   - Find the "aha moment" - what makes this click for learners
   - Note common misconceptions to address

2. **Identify the narrative hook**
   - What question does this video answer?
   - Why should the viewer care?
   - What's the surprising or counterintuitive element?

### Phase 2: Clarify with User

Ask targeted questions (not all at once - adapt based on responses):

**Audience & Scope**
- What math/science background should I assume? (e.g., "knows calculus" or "high school algebra")
- Target video length? (short: 5-10min, medium: 15-20min, long: 30min+)
- Should this be self-contained or part of a series?

**Focus & Depth**
- Any specific aspects to emphasize or skip?
- Proof-heavy or intuition-focused?
- Real-world applications to include?

**Style Preferences**
- Color scheme preferences?
- Narration style? (casual, formal, playful)
- Any specific visual metaphors you have in mind?

### Phase 3: Create scenes.md

Output a comprehensive `scenes.md` file with this structure:

```markdown
# [Video Title]

## Overview
- **Topic**: [Core concept]
- **Hook**: [Opening question/mystery]
- **Target Audience**: [Prerequisites]
- **Estimated Length**: [X minutes]
- **Key Insight**: [The "aha moment"]

## Narrative Arc
[2-3 sentences describing the journey from confusion to understanding]

---

## Scene 1: [Scene Name]
**Duration**: ~X seconds
**Purpose**: [What this scene accomplishes]

### Visual Elements
- [List of mobjects needed]
- [Animations to use]
- [Camera movements]

### Content
[Detailed description of what happens, what's shown, what's explained]

### Narration Notes
[Key points to convey, tone, pacing notes]

### Technical Notes
- [Specific Manim classes/methods to use]
- [Any tricky implementations to note]

---

## Scene 2: [Scene Name]
...

---

## Transitions & Flow
[Notes on how scenes connect, recurring visual motifs]

## Color Palette
- Primary: [color] - used for [purpose]
- Secondary: [color] - used for [purpose]
- Accent: [color] - used for [purpose]
- Background: [color]

## Mathematical Content
[List of equations, formulas, or mathematical objects that need to be rendered]

## Implementation Order
[Suggested order for implementing scenes, noting dependencies]
```

## 3b1b Style Principles

Apply these principles when composing scenes:

### Visual Storytelling
- **Show, don't just tell** - Every concept needs a visual representation
- **Progressive revelation** - Build complexity gradually, don't show everything at once
- **Visual continuity** - Transform objects rather than replacing them when possible

### Pacing & Rhythm
- **Pause for insight** - Give viewers time to absorb key moments
- **Vary the pace** - Mix quick sequences with slower explanations
- **End scenes with resolution** - Each scene should feel complete

### Mathematical Beauty
- **Emphasize elegance** - Highlight when math is surprisingly simple or beautiful
- **Connect representations** - Show the same concept multiple ways (algebraic, geometric, intuitive)
- **Embrace abstraction gradually** - Start concrete, then generalize

### Engagement Techniques
- **Pose questions** - Make viewers curious before revealing answers
- **Acknowledge difficulty** - "This might seem confusing at first..."
- **Celebrate insight** - Make the "aha moment" feel earned

## References

- [references/narrative-patterns.md](references/narrative-patterns.md) - Common 3b1b narrative structures
- [references/visual-techniques.md](references/visual-techniques.md) - Effective visualization patterns
- [references/scene-examples.md](references/scene-examples.md) - Example scenes.md excerpts

## Templates

- [templates/scenes-template.md](templates/scenes-template.md) - Blank scenes.md template
````

## File: README.md
upstream: https://github.com/adithya-s-k/manim_skill/blob/main/README.md

````text
# Manim Skills Repository

![Visitors](https://visitor-badge.laobi.icu/badge?page_id=adithya-s-k.manim_skill)
![GitHub stars](https://img.shields.io/github/stars/adithya-s-k/manim_skill?style=flat-square)
![GitHub forks](https://img.shields.io/github/forks/adithya-s-k/manim_skill?style=flat-square)
![GitHub issues](https://img.shields.io/github/issues/adithya-s-k/manim_skill?style=flat-square)
![License](https://img.shields.io/github/license/adithya-s-k/manim_skill?style=flat-square)

> **⚡ Quick Start:** Add both Manim skills to your AI agent instantly:
> ```bash
> npx skills add adithya-s-k/manim_skill
> ```

A comprehensive collection of best practices, patterns, and examples for both **Manim Community Edition** and **ManimGL** (3Blue1Brown's version). This repository provides battle-tested code examples and guidelines for creating mathematical animations.

https://github.com/user-attachments/assets/3cd398b7-7cc6-43c1-a6e9-20077be6b009

## 📚 About the Two Versions

### Manim Community Edition (`manim`)
- **Repository**: https://github.com/ManimCommunity/manim
- **Focus**: Community-maintained, stable, well-documented
- **Best For**: Production use, educational content, collaborative projects
- **Command**: `manim` CLI
- **Import**: `from manim import *`

### ManimGL (`manimgl`)
- **Repository**: https://github.com/3b1b/manim
- **Focus**: Grant Sanderson's (3Blue1Brown) original version with OpenGL rendering
- **Best For**: Interactive development, 3D scenes, rapid prototyping
- **Command**: `manimgl` CLI
- **Import**: `from manimlib import *`

> **Important**: These are **separate, incompatible** frameworks. Code written for one will not work with the other without modifications.

---

## 🚀 Installation

### Prerequisites (Both Versions)
1. **Python 3.7+** - Required
2. **FFmpeg** - For video encoding
3. **LaTeX** - For mathematical typesetting (TeX Live, MiKTeX, or MacTeX)

#### Install FFmpeg

**macOS:**
```bash
brew install ffmpeg
```

**Ubuntu/Debian:**
```bash
sudo apt update
sudo apt install ffmpeg
```

**Windows:**
Download from https://ffmpeg.org/download.html and add to PATH

#### Install LaTeX

**macOS:**
```bash
brew install mactex
```

**Ubuntu/Debian:**
```bash
sudo apt install texlive-full
```

**Windows:**
Install MiKTeX from https://miktex.org/download

---

### Installing Manim Community Edition

```bash
# Using pip
pip install manim

# Using uv (recommended for this project)
uv pip install manim

# Verify installation
manim --version
```

**Documentation**: https://docs.manim.community/

---

### Installing ManimGL

```bash
# Using pip
pip install manimgl

# Using uv (recommended for this project)
uv pip install manimgl

# Verify installation
manimgl --version
```

**Additional macOS (ARM) requirement:**
```bash
arch -arm64 brew install pkg-config cairo
```

---

## 🔌 Skills.sh Integration

This repository provides two **AI Agent Skills** that can be installed with a single command using [skills.sh](https://skills.sh/):

### Install with npx (Recommended)

```bash
# Install Manim Community Edition best practices
npx skills add adithya-s-k/manim_skill/skills/manimce-best-practices

# Install ManimGL best practices
npx skills add adithya-s-k/manim_skill/skills/manimgl-best-practices

# Or install both
npx skills add adithya-s-k/manim_skill/skills/manimce-best-practices adithya-s-k/manim_skill/skills/manimgl-best-practices
```

### What are Skills?

Skills are **reusable capabilities for AI coding agents**. Once installed, your AI assistant (like Claude, GitHub Copilot, or Cursor) automatically gains access to:
- ✅ Domain-specific best practices
- ✅ Working code examples
- ✅ Common patterns and anti-patterns
- ✅ Framework-specific knowledge

The skills follow the [Agent Skills open standard](https://github.com/anthropics/skills) and work across multiple AI tools.

### When Skills Activate

**manimce-best-practices** - Automatically loads when:
- You import `from manim import *`
- You use the `manim` CLI command
- You work with Scene classes, mathematical animations, or LaTeX rendering
- You create educational videos or visual explanations with Manim Community

**manimgl-best-practices** - Automatically loads when:
- You import `from manimlib import *`
- You use the `manimgl` CLI command
- You work with InteractiveScene, 3D rendering, or camera frame control
- You use interactive mode with `.embed()` or `checkpoint_paste()`

---

## 📖 Using This Repository

### Repository Structure

```
manim_skill/
├── skills/
│   ├── manimce-best-practices/     # Manim Community Edition skills
│   │   ├── SKILL.md                # Skill metadata
│   │   └── rules/                  # Individual best practice guides
│   │       ├── animations.md
│   │       ├── scenes.md
│   │       ├── mobjects.md
│   │       └── ...
│   │
│   └── manimgl-best-practices/     # ManimGL skills
│       ├── SKILL.md
│       └── rules/
│           ├── animations.md
│           ├── 3d.md
│           ├── camera.md
│           └── ...
│
└── tests/
    ├── manimce/                    # Tests for Community Edition
    └── manimgl/                    # Tests for ManimGL
```

### What's Inside Each Skill File?

Each `.md` file contains:
- **Best practices** for specific Manim features
- **Working code examples** (all tested!)
- **Common patterns** and use cases
- **Pitfalls to avoid**
- **API differences** between versions

---

## 🎯 Quick Start Examples

### Manim Community Edition

```python
from manim import *

class BasicExample(Scene):
    def construct(self):
        circle = Circle()
        circle.set_fill(BLUE, opacity=0.5)
        circle.set_stroke(BLUE_E, width=4)

        self.play(Create(circle))
        self.wait()
```

**Run it:**
```bash
manim -pql scene.py BasicExample
# -p: preview after rendering
# -q: quality (l=low, m=medium, h=high)
```

### ManimGL

```python
from manimlib import *

class BasicExample(InteractiveScene):
    def construct(self):
        circle = Circle()
        circle.set_fill(BLUE, opacity=0.5)
        circle.set_stroke(BLUE_E, width=4)

        self.play(ShowCreation(circle))
        self.wait()
```

**Run it:**
```bash
manimgl scene.py BasicExample --write_file
# --write_file: save video output
# -s: skip to last frame
# -w: write file without opening
```

---

## 🧪 Running Tests

This repository includes comprehensive tests to ensure all code examples work correctly.

### Test Manim Community Edition Skills

```bash
# Test all files
uv run python tests/manimce/test_all_skills.py

# Test specific file
uv run python tests/manimce/test_all_skills.py animations.md

# Run with multiple workers (faster)
uv run python tests/manimce/test_all_skills.py -j 4
```

### Test ManimGL Skills

```bash
# Test all files
uv run python tests/manimgl/test_all_skills.py

# Test specific file
uv run python tests/manimgl/test_all_skills.py 3d.md

# Run with multiple workers (use caution - can cause OOM)
uv run python tests/manimgl/test_all_skills.py -j 4
```

> **Note**: Parallel testing with many workers can cause out-of-memory errors. Use 4-6 workers max, or test files individually.

---

## 🔍 Key Differences Between Versions

| Feature | Manim Community | ManimGL |
|---------|----------------|---------|
| **Import** | `from manim import *` | `from manimlib import *` |
| **CLI Command** | `manim` | `manimgl` |
| **Scene Base Class** | `Scene`, `MovingCameraScene` | `Scene`, `InteractiveScene` |
| **Creation Animation** | `Create()` | `ShowCreation()` |
| **Text Class** | `Text()`, `MathTex()` | `Text()`, `Tex()` |
| **3D Rendering** | Limited | Full OpenGL support |
| **Interactive Mode** | No | Yes (`-se` flag, `.embed()`) |
| **Camera Control** | `MovingCameraScene` | `self.camera.frame` |
| **Configuration** | Python config | YAML files |
| **Color Constants** | Same | Same + variations (e.g., `BLUE_A`, `BLUE_E`) |

---

## 📚 Exploring Skills

### For Manim Community Edition:
Start with these guides in `skills/manimce-best-practices/rules/`:
1. **sc
````
