manimce-best-practices

Agent Skills › calesthio/OpenMontage › manimce-best-practices

manimce-best-practices

GitHub

提供 Manim Community Edition (ManimCE) Python 动画引擎的最佳实践指南。涵盖场景结构、动画控制、LaTeX 数学公式渲染、3D 可视化、样式设置及 CLI 使用规范，旨在辅助开发者高效创建高质量的数学与科学动画内容。

.claude/skills/manimce-best-practices/SKILL.md calesthio/OpenMontage

Trigger Scenarios

用户提及 manim、Manim Community 或 ManimCE 代码包含 from manim import * 执行 manim CLI 命令使用 Scene、MathTex 等 ManimCE 特定类

Install

npx skills add calesthio/OpenMontage --skill manimce-best-practices -g -y

More Options

Non-standard path

npx skills add https://github.com/calesthio/OpenMontage/tree/main/.claude/skills/manimce-best-practices -g -y

Use without installing

npx skills use calesthio/OpenMontage@manimce-best-practices

指定 Agent (Claude Code)

npx skills add calesthio/OpenMontage --skill manimce-best-practices -a claude-code -g -y

安装 repo 全部 skill

npx skills add calesthio/OpenMontage --all -g -y

预览 repo 内 skill

npx skills add calesthio/OpenMontage --list

SKILL.md

Frontmatter

{
    "name": "manimce-best-practices",
    "description": "Trigger when: (1) User mentions \"manim\" or \"Manim Community\" or \"ManimCE\", (2) Code contains `from manim import *`, (3) User runs `manim` CLI commands, (4) Working with Scene, MathTex, Create(), or ManimCE-specific classes.\n\nBest practices for Manim Community Edition - the community-maintained Python animation engine. Covers Scene structure, animations, LaTeX\/MathTex, 3D with ThreeDScene, camera control, styling, and CLI usage.\n\nNOT for ManimGL\/3b1b version (which uses `manimlib` imports and `manimgl` CLI)."
}

How to use

Read individual rule files for detailed explanations and code examples:

Core Concepts

rules/scenes.md - Scene structure, construct method, and scene types
rules/mobjects.md - Mobject types, VMobject, Groups, and positioning
rules/animations.md - Animation classes, playing animations, and timing

Creation & Transformation

rules/creation-animations.md - Create, Write, FadeIn, DrawBorderThenFill
rules/transform-animations.md - Transform, ReplacementTransform, morphing
rules/animation-groups.md - AnimationGroup, LaggedStart, Succession

Text & Math

rules/text.md - Text mobjects, fonts, and styling
rules/latex.md - MathTex, Tex, LaTeX rendering, and coloring formulas
rules/text-animations.md - Write, AddTextLetterByLetter, TypeWithCursor

Styling & Appearance

rules/colors.md - Color constants, gradients, and color manipulation
rules/styling.md - Fill, stroke, opacity, and visual properties

Positioning & Layout

rules/positioning.md - move_to, next_to, align_to, shift methods
rules/grouping.md - VGroup, Group, arrange, and layout patterns

Coordinate Systems & Graphing

rules/axes.md - Axes, NumberPlane, coordinate systems
rules/graphing.md - Plotting functions, parametric curves
rules/3d.md - ThreeDScene, 3D axes, surfaces, camera orientation

Animation Control

rules/timing.md - Rate functions, easing, run_time, lag_ratio
rules/updaters.md - Updaters, ValueTracker, dynamic animations
rules/camera.md - MovingCameraScene, zoom, pan, frame manipulation

Configuration & CLI

rules/cli.md - Command-line interface, rendering options, quality flags
rules/config.md - Configuration system, manim.cfg, settings

Shapes & Geometry

rules/shapes.md - Circle, Square, Rectangle, Polygon, and geometric primitives
rules/lines.md - Line, Arrow, Vector, DashedLine, and connectors

Working Examples

Complete, tested example files demonstrating common patterns:

examples/basic_animations.py - Shape creation, text, lagged animations, path movement
examples/math_visualization.py - LaTeX equations, color-coded math, derivations
examples/updater_patterns.py - ValueTracker, dynamic animations, physics simulations
examples/graph_plotting.py - Axes, functions, areas, Riemann sums, polar plots
examples/3d_visualization.py - ThreeDScene, surfaces, 3D camera, parametric curves

Scene Templates

Copy and modify these templates to start new projects:

templates/basic_scene.py - Standard 2D scene template
templates/camera_scene.py - MovingCameraScene with zoom/pan
templates/threed_scene.py - 3D scene with surfaces and camera rotation

Quick Reference

Basic Scene Structure

from manim import *

class MyScene(Scene):
    def construct(self):
        # Create mobjects
        circle = Circle()

        # Add to scene (static)
        self.add(circle)

        # Or animate
        self.play(Create(circle))

        # Wait
        self.wait(1)

Render Command

# Basic render with preview
manim -pql scene.py MyScene

# Quality flags: -ql (low), -qm (medium), -qh (high), -qk (4k)
manim -pqh scene.py MyScene

Key Differences from 3b1b/ManimGL

Feature	Manim Community	3b1b/ManimGL
Import	`from manim import *`	`from manimlib import *`
CLI	`manim`	`manimgl`
Math text	`MathTex(r"\pi")`	`Tex(R"\pi")`
Scene	`Scene`	`InteractiveScene`
Package	`manim` (PyPI)	`manimgl` (PyPI)

Jupyter Notebook Support

Use the %%manim cell magic:

%%manim -qm MyScene
class MyScene(Scene):
    def construct(self):
        self.play(Create(Circle()))

Common Pitfalls to Avoid

Version confusion - Ensure you're using manim (Community), not manimgl (3b1b version)
Check imports - from manim import * is ManimCE; from manimlib import * is ManimGL
Outdated tutorials - Video tutorials may be outdated; prefer official documentation
manimpango issues - If text rendering fails, check manimpango installation requirements
PATH issues (Windows) - If manim command not found, use python -m manim or check PATH

Installation

# Install Manim Community
pip install manim

# Check installation
manim checkhealth

Useful Commands

manim -pql scene.py Scene    # Preview low quality (development)
manim -pqh scene.py Scene    # Preview high quality
manim --format gif scene.py  # Output as GIF
manim checkhealth            # Verify installation
manim plugins -l             # List plugins