Communitygithub.com

manim

Renderiza animaciones explicativas y diagramas estáticos con Manim Community. Úsalo cuando una imagen explique mejor que el texto (matemáticas, ecuaciones, gráficos de funciones, geometría, redes/grafos, tablas, matrices, 3D, campos vectoriales), o cuando el usuario solicite una animación, un diagrama o una escena de Manim.

¿Qué es manim?

Esta habilidad permite a un agente de IA generar animaciones explicativas y diagramas estáticos de alta calidad usando Manim Community v0.22.1, una biblioteca de Python para animaciones matemáticas y científicas. Es especialmente útil para visualizar conceptos complejos como ecuaciones, funciones, geometría, redes, tablas y campos vectoriales, donde una representación visual dinámica supera al texto plano. La habilidad está diseñada para entornos de desarrollo como Claude Code o T3 Code, y sigue un flujo de trabajo estructurado: seleccionar el formato de salida (PNG, MP4 o GIF), escribir la escena en Python con la API de Manim, renderizar borradores de baja calidad para revisión, y producir el archivo final en alta resolución (1080p60). Incluye funciones avanzadas como narración por voz con Chatterbox Turbo, verificación de tiempo de lectura para textos, y una biblioteca de íconos integrada (Tabler Icons y Fluent Emoji) para enriquecer visualmente las escenas. El proceso es iterativo: cada cambio requiere re-renderizar y entregar el resultado final, con nombres de archivo versionados para mantener el historial.

Compatible con✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/logan-gatlin/manim-skill/tree/HEAD

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Vista previa

Del README del skill

título

Documentación

¿Qué hace manim?

Instalado aquí: Manim Community v0.22.1 (manim en PATH, instalado como uv tool con el extra typst), además de TeX Live y dvisvgm para Tex/MathTex, y Chatterbox Turbo para narración (instalación para CPU en su propio entorno virtual en ~/.local/opt/chatterbox, manejado por narration.py). Los archivos de escena se ejecutan con el Python propio de la herramienta, que incluye numpy, scipy y networkx; otras importaciones fallan. Usa únicamente la API de ManimCE. manimgl de 3Blue1Brown es una biblioteca diferente, por lo que el código escrito para ella no funcionará aquí.

Estilo

Manim es una herramienta para presentar información de forma dinámica e interesante. Si lo que has creado podría haberse hecho igual de fácil como un diagrama de flujo, una hoja de cálculo, un gráfico de puntos o una presentación de diapositivas, no estás usando manim correctamente. Lo bello es más atractivo y más memorable. Evita la jerga técnica y mantén tu presentación accesible. Elige un conjunto de motivos y mantenlos fieles: un concepto debe tener una representación visual coherente. Cuenta una historia, comienza in medias res. Introduce las ideas y los problemas desde los primeros principios.

Pasos

  1. Elige el formato de salida. Usa un PNG estático para una imagen fija (un diagrama etiquetado, gráfico, tabla o fórmula). Usa un MP4 cuando el punto sea el cambio o la secuencia (una derivación paso a paso, un punto en movimiento, una transformación). Usa GIF solo cuando el lugar donde irá no pueda reproducir video.

  2. Encuentra los ejemplos más cercanos. Abre los archivos de tema a continuación, revisa el índice al principio y lee los 1–3 ejemplos más cercanos a lo que necesitas. Construye tu escena adaptándolos: su uso de la API está probado en esta versión.

  3. Escribe la escena en /tmp/manim/<slug>/scene.py a menos que el usuario haya especificado una ubicación. Comienza con from manim import * y define una subclase de Scene (MovingCameraScene / ThreeDScene / ZoomedScene cuando los ejemplos lo usen).

    Cada imagen de una cosa (una nube, un servidor, un candado, una bandera, una persona, un documento) es un icono de la biblioteca de esta habilidad, usado tal cual: copia icons.py junto a la escena, encuentra un id con grep -iw <palabra> assets/index.tsv en el directorio de esta habilidad (prueba un sinónimo si una palabra no encuentra nada), y cárgalo con icon(id, color=..., height=...). tabler/outline/* y tabler/filled/* son iconos de un solo color (Tabler Icons) dibujados en color; fluent/* son emojis a todo color (Fluent Emoji, estilo plano) que mantienen sus propios colores. Dibuja solo la estructura del diagrama tú mismo, con las formas de Manim: cajas, flechas, líneas, ejes, gráficos y etiquetas. Dale a cada concepto un icono y reutilízalo, como uno de los motivos.

    Un MP4 o GIF que muestre texto debe dar a los espectadores tiempo de lectura, y un verificador lo exige. Copia reading_time.py junto a la escena, impórtalo con from reading_time import ReadingTime, y pon el mixin antes de la clase base de la escena: class SceneName(ReadingTime, Scene). Llama a self.wait_to_read() antes de cada play que oculte, reemplace o atenúe texto. Espera hasta que cada texto visible haya estado en pantalla durante 1 s más sus palabras a 150 ppm, con todo el texto revelado por un play leído en conjunto. Muestra las palabras nuevas como un nuevo mobject (FadeIn, ReplacementTransform) en lugar de con become(), para que su tiempo comience de nuevo. El movimiento puede continuar durante la espera: pon self.wait_to_read() después de una animación que se reproduzca mientras el texto está visible.

    Un MP4 que explique con subtítulos también está narrado: una voz lo lee en voz alta. Copia narration.py junto a la escena y ponlo antes de ReadingTime: class SceneName(Narration, ReadingTime, Scene). self.speak(texto) espera a que termine la línea anterior, luego comienza la siguiente, y las animaciones que siguen se reproducen mientras se habla. Ponlo justo antes del play que muestra el subtítulo que lee. El subtítulo muestra la línea hablada palabra por palabra, y cada línea hablada tiene uno: escribe cada línea una vez y pasa esa misma cadena a speak y al Text del subtítulo. Cuando la voz necesite una reescritura que la pantalla no muestra ("veinte" para "20"), ponlo en el diccionario pronounce de la escena, que cambia solo lo que se vocaliza. En una escena narrada, la voz establece la espera en lugar del recuento de palabras: el texto que aparece mientras se habla una línea debe permanecer hasta que el narrador termine más una pausa de 0.5 s, y self.wait_to_read() espera exactamente ese tiempo antes del siguiente cambio (el texto mostrado durante el silencio mantiene la regla del recuento de palabras). La voz es un clon neuronal de un narrador masculino calmado (Chatterbox Turbo), ajustado para recorrer diagramas técnicos. Cada nueva línea toma aproximadamente de 1 a 3 veces su duración hablada para sintetizar, incluidos los fotogramas de borrador, y se almacena en caché en media/voice, por lo que los renderizados posteriores solo vocalizan las líneas que cambiaste. Escribe cada línea para ser escuchada, no leída. Acrónimos como API, TLS y HTTP se leen bien como están escritos, y narration.py ya deletrea las unidades después de números (200 ms), versiones con puntos (2.4.1) y k8s. Di otras cadenas de máquina como lo haría un narrador, nuevamente a través de pronounce: "diecisiete once", no "2026.11.1711". Describe rutas y nombres de ramas en lugar de leerlos en voz alta ("una rama de parches automáticos"), y corrige cualquier palabra que la voz pronuncie mal mediante el diccionario pronounce de la escena ({"edgeworker": "trabajador de borde"}).

    Cada MP4 o GIF termina en una tarjeta de crédito que nombra el modelo que lo creó. Copia produced_by.py junto a la escena, pon el mixin primero de todos: class SceneName(ProducedBy, Narration, ReadingTime, Scene) (o class SceneName(ProducedBy, Scene) para una escena sin texto), y establece produced_by con el nombre de tu propio modelo tal como lo da tu prompt del sistema (produced_by = "Claude Opus 5.5"). Si tus instrucciones no nombran tu modelo, pregúntale al usuario. Una vez que la escena, su narración y su verificación de tiempo de lectura hayan terminado, el mixin desvanece la escena y mantiene la tarjeta durante los últimos 0.5 s. Los renderizados estáticos lo omiten.

  4. Boceto y revisión. Renderiza un borrador de baja calidad y lee el PNG:

    cd /tmp/manim/<slug> && manim render -ql -s --media_dir media -o draft scene.py SceneName
    # -> media/images/scene/draft.png
    

    Para una animación, también verifica los momentos clave: -s -n 0,K se detiene después de la animación K (basado en 0; cada self.play y cada self.wait cuenta como uno) y guarda ese fotograma. El fotograma mide aproximadamente 14.2 × 8 unidades, centrado en el origen. Corrige y vuelve a renderizar hasta que cada fotograma que verificaste muestre todos los elementos dentro del marco, sin etiquetas superpuestas y texto legible.

    Una escena que quita el texto demasiado pronto falla con ReadingTimeError, que enumera cada texto, cuándo apareció, cuánto tiempo se mostró frente al tiempo necesario. Agrega self.wait_to_read() antes de cada cambio enumerado. Para ver los fotogramas del borrador antes de que se corrija el tiempo, antepone el comando con MANIM_READING_TIME=warn. El renderizado final se ejecuta sin esto y debe pasar.

  5. Renderizado final. Usa -qm (720p30). Las escenas 3D son lentas en el renderizador Cairo, así que haz el borrador con -ql.

    manim render -qh --media_dir media -o final scene.py SceneName
    # -> media/videos/scene/1080p60/final.mp4   (agrega --format gif para un GIF; -s para un PNG en media/images/scene/final.png)
    
  6. Entrega. Muestra la salida en línea cuando tu interfaz pueda mostrarla, es decir, cuando tus instrucciones digan que la sintaxis de imagen Markdown incrusta imágenes o video (lo hace T3 Code). Copia el archivo de salida al directorio de trabajo de la sesión, luego incrústalo desde allí con su ruta absoluta (![título](/ruta/abs/salida.mp4); esto funciona tanto para MP4 como para PNG). T3 Code renderiza medios en línea solo desde el directorio de trabajo, por lo que una incrustación que apunte a /tmp se muestra como un enlace simple. En una interfaz que solo muestra texto, como una terminal simple, proporciona la ruta absoluta del archivo de salida. En cualquier caso, también proporciona la ruta del archivo de la escena para que el usuario pueda modificarla.

    Cada iteración termina en una entrega. Cada vez que cambies una escena, ya sea por los comentarios del usuario o por tus propias correcciones, finaliza el turno volviendo a renderizar cada video del conjunto en calidad final, incluso aquellos que no tocaste, y entregando cada uno como en el paso 6. Las imágenes fijas y las capturas de fotogramas te ayudan a verificar tu trabajo, pero no reemplazan los videos. Dale a cada ronda sus propios nombres de archivo (<nombre>-v2.mp4, <nombre>-v3.mp4), para que los mensajes anteriores sigan mostrando las versiones que describieron.

Archivos de tema

Cada uno contiene ejemplos probados con renderizado, textualmente de la documentación v0.22.1 a menos que el archivo indique lo contrario, con un índice al principio.

  • references/basics.md: posicionamiento, estilo, agrupación/organización, .animate, Transform, animaciones personalizadas.
  • references/text-and-math.md: Text/MarkupText, Tex/MathTex, matemáticas con Typst, colorear partes de fórmulas, reorganización de ecuaciones, listas con viñetas, títulos, bloques de código, llaves, números en vivo.
  • references/plots-and-axes.md: gráficos Axes, áreas y sumas de Riemann, derivadas/secantes, curvas implícitas/paramétricas/polares, ejes logarítmicos, gráficos de líneas de datos, rectas numéricas y planos, plano complejo, gráficos de barras.
  • references/diagrams-and-geometry.md: flechas, líneas/puntos/formas etiquetados, ángulos, ángulos rectos, resaltado (cuadro alrededor, subrayado, cruz), formas de Venn/booleanas, polígonos, contornos discontinuos.
  • references/code.md: código con resaltado de sintaxis: escribirlo, resaltar líneas, seleccionar un token, transformar una versión en la siguiente.
  • references/graphs-tables-matrices.md: Graph/DiGraph de nodos y enlaces, árboles, capas de redes neuronales, importación de networkx, cambios de diseño, tablas, matrices, determinantes, transformaciones lineales del plano.
  • references/animation-and-motion.md: actualizadores, ValueTracker, always_redraw, rutas trazadas, variantes de transformación, MoveToTarget/Restore, temporización Succession/LaggedStart, énfasis (Indicate, Circumscribe, Flash), entradas de crecimiento/desvanecimiento, funciones de ritmo.
  • references/camera-3d-fields.md: cámara móvil/zoom, recuadro con zoom, control de cámara ThreeDScene, superficies y curvas 3D, campos vectoriales y líneas de flujo.
  • references/complete-scenes.md: dos escenas más largas que muestran cómo se ritma una explicación de varios pasos.

Consulta de la API

El código fuente instalado, con cadenas de documentación completas, está en ~/.local/share/uv/tools/manim/lib/python3.13/site-packages/manim/. Búscalo para obtener la firma y las opciones de una clase o método antes de adivinar un argumento de palabra clave.

Advertencias

  • Escribe las cadenas LaTeX como cadenas sin procesar (r"\frac{a}{b}"). Un error de LaTeX imprime el registro .tex, y la línea problemática suele estar cerca del final.
  • xelatex no está instalado, por lo que las plantillas de TexTemplateLibrary que lo necesitan (por ejemplo, ctex) fallan. Para texto CJK usa Text/MarkupText, que se renderizan a través de Pango con las fuentes del sistema (fc-list las muestra).
  • Typst / MathTypst son una alternativa más rápida a Tex / MathTex y no necesitan LaTeX.
  • Carga los iconos con icon(), que recolorea los iconos de Tabler: sus archivos dibujan en currentColor, que un SVGMobject simple lee como negro.
  • Los iconos Fluent dibujados en negro (fluent/black-flag, fluent/black-cat) desaparecen sobre el fondo negro; elige otro icono, o colócalo sobre una forma clara.
  • Los iconos de línea de Tabler pierden los puntos dibujados como líneas de longitud cero, como las luces en tabler/outline/server.

Skills relacionados