Communitygithub.com

MoreiraTv/vibe-video

Pipeline de producción para animaciones matemáticas y técnicas usando Manim Community Edition. Crea videos explicativos estilo 3Blue1Brown, visualizaciones de algoritmos, derivaciones de ecuaciones, diagramas de arquitectura e historias con datos.

¿Qué es vibe-video?

Esta skill implementa un pipeline completo de producción de videos estilo 3Blue1Brown utilizando Manim Community Edition. Está diseñada para creadores de contenido educativo, desarrolladores y científicos que necesitan generar animaciones matemáticas y técnicas de alta calidad. Soporta múltiples modos: videos explicativos de conceptos, derivaciones de ecuaciones paso a paso, visualizaciones de algoritmos, historias con datos y diagramas de arquitectura. La skill enfatiza la excelencia en el primer renderizado, el uso de paletas de colores coherentes, tipografía monospace y pausas estratégicas para maximizar la retención del espectador. También incluye referencias detalladas para animaciones, diseño visual, ecuaciones, gráficos, 3D, planificación de escenas y sincronización con narración mediante TTS opcional (ElevenLabs o Qwen3-TTS). El flujo de trabajo sigue las etapas PLAN → CÓDIGO → RENDERIZAR → UNIR → AUDIO (opcional) → REVISAR, todo dentro de un único script de Python por proyecto.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MoreiraTv/vibe-video/tree/HEAD/skills/manim-video

Preguntar en tu IA favorita

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

Documentación

Pipeline de Producción de Video con Manim

Estándar Creativo

Esto es cine educativo. Cada cuadro enseña. Cada animación revela estructura.

Antes de escribir una sola línea de código, articula el arco narrativo. ¿Qué concepto erróneo corrige esto? ¿Cuál es el "momento ajá"? ¿Qué historia visual lleva al espectador de la confusión a la comprensión? El prompt del usuario es un punto de partida — interprétalo con ambición pedagógica.

Geometría antes que álgebra. Muestra la forma primero, la ecuación después. La memoria visual codifica más rápido que la memoria simbólica. Cuando el espectador ve el patrón geométrico antes que la fórmula, la ecuación se siente merecida.

La excelencia en el primer renderizado no es negociable. La salida debe ser visualmente clara y estéticamente coherente sin rondas de revisión. Si algo se ve desordenado, mal sincronizado, o como "diapositivas generadas por IA", está mal.

Capas de opacidad para dirigir la atención. Nunca muestres todo con brillo máximo. Elementos principales al 1.0, elementos contextuales al 0.4, elementos estructurales (ejes, cuadrículas) al 0.15. El cerebro procesa la prominencia visual en capas.

Espacio para respirar. Cada animación necesita un self.wait() después. El espectador necesita tiempo para absorber lo que acaba de aparecer. Nunca apresures una animación tras otra. Una pausa de 2 segundos después de una revelación clave nunca se desperdicia.

Lenguaje visual cohesivo. Todas las escenas comparten una paleta de colores, un tamaño de tipografía coherente y velocidades de animación que combinan. Un video técnicamente correcto donde cada escena usa colores aleatorios diferentes es un fracaso estético.

Prerrequisitos

Ejecuta scripts/setup.sh para verificar todas las dependencias. Requiere: Python 3.10+, Manim Community Edition v0.20+ (pip install manim), LaTeX (texlive-full en Linux, mactex en macOS), y ffmpeg. Documentación de referencia probada con Manim CE v0.20.1.

Modos

ModoEntradaSalidaReferencia
Explicador de conceptosTema/conceptoExplicación animada con intuición geométricareferences/scene-planning.md
Derivación de ecuacionesExpresiones matemáticasPrueba animada paso a pasoreferences/equations.md
Visualización de algoritmosDescripción del algoritmoEjecución paso a paso con estructuras de datosreferences/graphs-and-data.md
Historia con datosDatos/métricasGráficos animados, comparaciones, contadoresreferences/graphs-and-data.md
Diagrama de arquitecturaDescripción del sistemaComponentes que se construyen con conexionesreferences/mobjects.md
Explicador de artículosArtículo de investigaciónHallazgos y métodos clave animadosreferences/scene-planning.md
Visualización 3DConcepto 3DSuperficies giratorias, curvas paramétricas, geometría espacialreferences/camera-and-3d.md

Stack

Un solo script de Python por proyecto. Sin navegador, sin Node.js, sin GPU requerida.

CapaHerramientaPropósito
NúcleoManim Community EditionRenderizado de escenas, motor de animación
MatemáticasLaTeX (texlive/MiKTeX)Renderizado de ecuaciones vía MathTex
Video I/OffmpegUnión de escenas, conversión de formatos, mezcla de audio
TTSElevenLabs / Qwen3-TTS (opcional)Voz en off de narración

Pipeline

PLANIFICAR --> CODIFICAR --> RENDERIZAR --> UNIR --> AUDIO (opcional) --> REVISAR
  1. PLANIFICAR — Escribe plan.md con arco narrativo, lista de escenas, elementos visuales, paleta de colores, guion de voz en off
  2. CODIFICAR — Escribe script.py con una clase por escena, cada una renderizable de forma independiente
  3. RENDERIZAR — manim -ql script.py Escena1 Escena2 ... para borrador, -qh para producción
  4. UNIR — ffmpeg concatena los clips de las escenas en final.mp4
  5. AUDIO (opcional) — Agrega voz en off y/o música de fondo vía ffmpeg. Consulta references/rendering.md
  6. REVISAR — Renderiza imágenes previas, verifica contra el plan, ajusta

Estructura del Proyecto

nombre-del-proyecto/
  plan.md                # Arco narrativo, desglose de escenas
  script.py              # Todas las escenas en un archivo
  concat.txt             # Lista de escenas para ffmpeg
  final.mp4              # Salida unida
  media/                 # Generado automáticamente por Manim
    videos/script/480p15/

Dirección Creativa

Paletas de Colores

PaletaFondoPrimarioSecundarioAcentoCaso de uso
3B1B clásico#1C1C1C#58C4DD (AZUL)#83C167 (VERDE)#FFFF00 (AMARILLO)Matemáticas/CS general
Académico cálido#2D2B55#FF6B6B#FFD93D#6BCB77Accesible
Tecnológico neón#0A0A0A#00F5FF#FF00FF#39FF14Sistemas, arquitectura
Monocromático#1A1A2E#EAEAEA#888888#FFFFFFMinimalista

Velocidad de Animación

Contextorun_timeself.wait() después
Aparición de título/intro1.5s1.0s
Revelación de ecuación clave2.0s2.0s
Transformación/morph1.5s1.5s
Etiqueta de apoyo0.8s0.5s
Limpieza FadeOut0.5s0.3s
Revelación "momento ajá"2.5s3.0s

Escala Tipográfica

RolTamaño de fuenteUso
Título48Títulos de escenas, texto de apertura
Encabezado36Encabezados de sección dentro de una escena
Cuerpo30Texto explicativo
Etiqueta24Anotaciones, etiquetas de ejes
Subtítulo20Subtítulos, letra pequeña

Fuentes

Usa fuentes monoespaciadas para todo el texto. El renderizador Pango de Manim produce kerning roto con fuentes proporcionales en todos los tamaños. Consulta references/visual-design.md para recomendaciones completas.

MONO = "Menlo"  # definir una vez al inicio del archivo

Text("Serie de Fourier", font_size=48, font=MONO, weight=BOLD)  # títulos
Text("n=1: sin(x)", font_size=20, font=MONO)                  # etiquetas
MathTex(r"\nabla L")                                            # matemáticas (usa LaTeX)

font_size mínimo = 18 para legibilidad.

Variación por Escena

Nunca uses una configuración idéntica para todas las escenas. Para cada escena:

  • Diferente color dominante de la paleta
  • Diferente diseño — no centres todo siempre
  • Diferente entrada de animación — varía entre Write, FadeIn, GrowFromCenter, Create
  • Diferente peso visual — algunas escenas densas, otras dispersas

Flujo de Trabajo

Paso 1: Planificar (plan.md)

Antes de cualquier código, escribe plan.md. Consulta references/scene-planning.md para la plantilla completa.

Paso 2: Codificar (script.py)

Una clase por escena. Cada escena se renderiza de forma independiente.

from manim import *

BG = "#1C1C1C"
PRIMARY = "#58C4DD"
SECONDARY = "#83C167"
ACCENT = "#FFFF00"
MONO = "Menlo"

class Escena1_Introduccion(Scene):
    def construct(self):
        self.camera.background_color = BG
        title = Text("¿Por Qué Funciona Esto?", font_size=48, color=PRIMARY, weight=BOLD, font=MONO)
        self.add_subcaption("¿Por qué funciona esto?", duration=2)
        self.play(Write(title), run_time=1.5)
        self.wait(1.0)
        self.play(FadeOut(title), run_time=0.5)

Patrones clave:

  • Subtítulos en cada animación: self.add_subcaption("texto", duration=N) o subcaption="texto" en self.play()
  • Constantes de color compartidas al inicio del archivo para consistencia entre escenas
  • self.camera.background_color establecido en cada escena
  • Salidas limpias — FadeOut de todos los mobjects al final de la escena: self.play(FadeOut(Group(*self.mobjects)))

Paso 3: Renderizar

manim -ql script.py Escena1_Introduccion Escena2_ConceptoCentral  # borrador
manim -qh script.py Escena1_Introduccion Escena2_ConceptoCentral  # producción

Paso 4: Unir

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Escena1_Introduccion.mp4'
file 'media/videos/script/480p15/Escena2_ConceptoCentral.mp4'
EOF
ffmpeg -y -f concat -safe 0 -i concat.txt -c copy final.mp4

Paso 5: Revisar

manim -ql --format=png -s script.py Escena2_ConceptoCentral  # imagen previa

Notas de Implementación Críticas

Cadenas Raw para LaTeX

# INCORRECTO: MathTex("\frac{1}{2}")
# CORRECTO:
MathTex(r"\frac{1}{2}")

buff >= 0.5 para Texto en los Bordes

label.to_edge(DOWN, buff=0.5)  # nunca < 0.5

FadeOut Antes de Reemplazar Texto

self.play(ReplacementTransform(nota1, nota2))  # no Write(nota2) encima

Nunca Animar Mobjects No Agregados

self.play(Create(circulo))  # debe agregarse primero
self.play(circulo.animate.set_color(RED))  # luego animar

Objetivos de Rendimiento

CalidadResoluciónFPSVelocidad
-ql (borrador)854x480155-15s/escena
-qm (medio)1280x7203015-60s/escena
-qh (producción)1920x10806030-120s/escena

Siempre itera con -ql. Solo renderiza con -qh para la salida final.

Referencias

ArchivoContenido
references/animations.mdAnimaciones principales, funciones de velocidad, composición, sintaxis .animate, patrones de sincronización
references/mobjects.mdTexto, formas, VGroup/Group, posicionamiento, estilos, mobjects personalizados
references/visual-design.md12 principios de diseño, capas de opacidad, plantillas de diseño, paletas de colores
references/equations.mdLaTeX en Manim, TransformMatchingTex, patrones de derivación
references/graphs-and-data.mdEjes, gráficos, BarChart, datos animados, visualización de algoritmos
references/camera-and-3d.mdMovingCameraScene, ThreeDScene, superficies 3D, control de cámara
references/scene-planning.mdArcos narrativos, plantillas de diseño, transiciones de escenas, plantilla de planificación
references/rendering.mdReferencia de CLI, ajustes de calidad, ffmpeg, flujo de trabajo de voz en off, exportación a GIF
references/troubleshooting.mdErrores de LaTeX, errores de animación, errores comunes, depuración
references/animation-design-thinking.mdCuándo animar vs. mostrar estático, descomposición, ritmo, sincronización con narración
references/updaters-and-trackers.mdValueTracker, add_updater, always_redraw, updaters basados en tiempo, patrones
references/paper-explainer.mdConvertir artículos de investigación en animaciones — flujo de trabajo, plantillas, patrones por dominio
references/decorations.mdSurroundingRectangle, Brace, flechas, DashedLine, Angle, ciclo de vida de anotaciones
references/production-quality.mdListas de verificación previas al código, previas al renderizado, posteriores al renderizado, diseño espacial, color, tempo

Divergencia Creativa (usar solo cuando el usuario solicite resultados experimentales/creativos/únicos)

Si el usuario solicita enfoques explicativos creativos, experimentales o no convencionales, selecciona una estrategia y razona a través de ella ANTES de diseñar la animación.

  • SCAMPER — cuando el usuario quiere un enfoque novedoso para una explicación estándar
  • Inversión de Supuestos — cuando el usuario quiere desafiar cómo se enseña típicamente algo

Transformación SCAMPER

Toma una visualización matemática/técnica estándar y transfórmala:

  • Sustituir: reemplaza la metáfora visual estándar (recta numérica → camino ondulante, matriz → cuadrícula de ciudad)
  • Combinar: fusiona dos enfoques explicativos (algebraico + geométrico simultáneamente)
  • Invertir: deriva hacia atrás — comienza desde el resultado y deconstruye hasta axiomas
  • Modificar: exagera un parámetro para mostrar por qué importa (10x la tasa de aprendizaje, 1000x el tamaño de la muestra)
  • Eliminar: quita toda notación — explica puramente a través de animación y relaciones espaciales

Inversión de Supuestos

  1. Enumera lo que es "estándar" sobre cómo se visualiza este tema (izquierda a derecha, 2D, pasos discretos, notación formal)
  2. Elige el supuesto más fundamental
  3. Invértelo (derivación de derecha a izquierda, incrustación 3D de un concepto 2D, morphing continuo en lugar de pasos, cero notación)
  4. Explora lo que la inversión revela que el enfoque estándar oculta

Skills relacionados