Communitygithub.com

manim-motion-studio

Muestra al agente cómo planificar, construir o editar con "Manim Motion Studio" para que el resultado concreto sea una hoja de ritmo y una lista de tomas. El proceso recorre Manim Motion Studio, la configuración modular (`scripts/setup_manim.sh`) y el flujo de trabajo. Úsalo cuando una nueva tarea requiera esta especialidad.

¿Qué es manim-motion-studio?

Manim Motion Studio es una habilidad especializada que permite a un agente de IA planificar, construir y editar animaciones programáticas usando Manim Community, ffmpeg y paquetes Python modulares. Está diseñada para desarrolladores e ingenieros que necesitan producir vídeos animados de alta calidad (60 fps) con un flujo de trabajo eficiente y reproducible. La habilidad es compatible con múltiples plataformas de agente (como Claude Code, Cursor, Codex) y proporciona un script de configuración modular (`scripts/setup_manim.sh`) que permite instalar solo los perfiles necesarios (core, editing, plugins, vision, audio, notion) evitando conflictos de dependencias. El núcleo del flujo de trabajo guía al agente desde la obtención de un brief o datos desde Notion, pasando por la elección de la clase de escena adecuada según una matriz de capacidades completa, hasta la previsualización, renderizado y edición posterior con scripts como `render.py` y `video_edit.py`. Además, incluye integración nativa con Notion para sincronizar storyboards, registrar renders y actualizar estados del proyecto. La matriz de capacidades cubre más de 12 dominios, incluyendo gráficos en movimiento con cámara, dibujo de trazos y morphing, UI loaders, personajes articulados, escenas 3D, visualización de datos, código/matemáticas/física, vídeo con visión artificial, y un ecosistema más amplio de animación Python. También se detallan casos críticos (gotchas) para evitar errores comunes de configuración y renderizado.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Japheth234-14/animatedVidEd-skill/tree/HEAD/manim-motion-studio

Preguntar en tu IA favorita

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

Documentación

Manim Motion Studio

Construye animaciones programáticas nítidas a 60 fps, ejecuta tuberías de edición de vídeo asistidas por IA y sincroniza la producción de vídeo con Notion utilizando Manim Community, ffmpeg y paquetes Python modulares.

Configuración modular (scripts/setup_manim.sh)

Instala solo el perfil que necesites para que las dependencias incompatibles de GUI, CV o 3D nunca entren en conflicto:

bash scripts/setup_manim.sh core     # manim + imageio-ffmpeg + pillow + numpy + scipy
bash scripts/setup_manim.sh editing  # + av, moviepy, scenedetect, opencv-headless, faster-whisper, pydub
bash scripts/setup_manim.sh plugins  # + manim-slides, manim-physics, manim-voiceover
bash scripts/setup_manim.sh vision   # + opencv-python-headless, mediapipe, scikit-image
bash scripts/setup_manim.sh audio    # + librosa, pydub, soundfile, faster-whisper
bash scripts/setup_manim.sh notion   # + notion-client
bash scripts/setup_manim.sh full     # stack completo sin conflictos (Manim + edición IA + plugins + Notion)

Si el ffmpeg del sistema falta, scripts/setup_manim.sh crea un enlace simbólico del binario empaquetado de imageio_ffmpeg a /tmp/bin/ffmpeg, y tanto scripts/render.py como scripts/video_edit.py lo inyectan automáticamente en PATH.

Regla de portabilidad sin LaTeX: Los entornos mínimos de pip install manim no incluyen pdflatex. Siempre usa Text / MarkupText para las etiquetas y pasa label_constructor=Text dentro de Axes, BarChart y ThreeDAxes (axis_config={"label_constructor": Text}) a menos que hayas verificado que latex y dvisvgm están instalados para MathTex/Tex.

Flujo de trabajo

  1. Obtén el brief, guión o datos desde Notion (mediante la app conectada de Notion o scripts/notion_sync.py) cuando trabajes a partir de un storyboard del espacio de trabajo o una tabla de KPI.
  2. Elige la clase de escena y paquetes adecuados de la matriz de capacidades a continuación (y de references/python-motion-ecosystem.md para la pila rápida, references/python-animation-library-catalogue.md para el catálogo completo de 18 secciones).
  3. Comienza desde una plantilla verificada en templates/ o combina patrones de references/.
  4. Previsualiza rápido en calidad de borrador (--quality draft) para verificar tiempos, diseño, seguimiento de cámara y encuadre antes de un renderizado completo a 60 fps.
  5. Renderiza en la relación de aspecto objetivo usando scripts/render.py (nunca combines -qh con dimensiones -r personalizadas).
  6. Edita, subtitula, reencuadra, mezcla y exporta con scripts/video_edit.py (combine, detect-scenes, auto-captions, burn-subtitles, smart-reframe, beat-markers, duck-audio, mux-audio, overlay, trim, speed, gif, probe).
  7. Inspecciona visualmente los fotogramas extraídos mediante ffmpeg antes de entregar el .mp4 o .gif final, y registra el renderizado de vuelta a Notion.

Matriz de capacidades

DominioClases principales, animaciones y herramientasReferencia / Plantilla
Gráficos en movimiento y cámaraMovingCameraScene, ZoomedScene, self.camera.frame, LaggedStart, MarkupText, rate_functions, trazos brillantes en capasreferences/motion-graphics-camera.mdtemplates/motion_graphics_camera.py
Dibujo de trazos y morphingCreate, DrawBorderThenFill, Write, ShowPassingFlash, VMobject curvas Bezier, SVGMobject, TransformMatchingShapes, Homotopyreferences/stroke-drawing-morphing.mdtemplates/stroke_drawing_morphing.py
Cargadores de UI, microinteracciones y reels de demostración20 cargadores de UI (pelota rebotando, relleno líquido, brillo de esqueleto/texto, órbita, spinners de radio/gradiente, cuadrados persiguiendo, batería), navegador macOS, lista de verificación progresiva, cuadrícula Bento 5×4 simultáneareferences/loaders-and-ui-microinteractions.mdtemplates/loaders_and_microinteractions.py
Personajes articulados y fondos personalizadosRigs de personajes FK/IK de 2 articulaciones, squash & stretch, parpadeos/expresiones, líneas de tiempo ValueTracker multi-acto, seguimiento de cámara seguro con dt, escenas de papel/escritorio con ImageMobject, eliminación de fondos de personajesreferences/character-rigging-and-backgrounds.mdtemplates/character_rig_scene.py
Escenas 3D y superficiesThreeDScene, ThreeDAxes, Surface, move_camera, begin_ambient_camera_rotation, add_fixed_in_frame_mobjectsreferences/3d-charts-physics-hybrid.mdtemplates/three_d_showcase.py
Visualización de datos y gráficosAxes, BarChart, NumberPlane, AnnularSector, get_riemann_rectangles, ValueTracker + always_redraw contadores en vivoreferences/3d-charts-physics-hybrid.mdtemplates/data_viz_dashboard.py
Código, matemáticas, física y grafosCode, Table, Brace, SurroundingRectangle, apply_matrix, ComplexPlane, ArrowVectorField, StreamLines, Graph/DiGraph, add_updater(mob, dt)references/3d-charts-physics-hybrid.mdtemplates/math_code_and_diagrams.py
Vídeo híbrido / CV con fotosImageMobject + OpenCV (cv2.inpaint, cv2.remap float32) + MediaPipe FaceLandmarker/HandLandmarkerreferences/3d-charts-physics-hybrid.md
Ecosistema de movimiento Python más ampliomanim-slides, manim-physics, manim-voiceover, av, moviepy, lottie, cairosvg, pytweening, pymunk, transitions, bpy/pyvista, matriz de compatibilidadreferences/python-motion-ecosystem.md
Catálogo completo de bibliotecas de animaciónCatálogo de 18 secciones: matemáticas/explicativas, 2D/juegos, coding creativo, vector/SVG, edición de vídeo, CV/IA, 3D, física, gráficos, GUI, narración, easing, audio, herramientas adyacentes, índice pip, advertencias, combinaciones de objetivos, pila centralreferences/python-animation-library-catalogue.md
Edición de vídeo y postproducción con IAscripts/video_edit.py, detect-scenes (PySceneDetect), auto-captions (faster-whisper), burn-subtitles, smart-reframe (seguimiento OpenCV), beat-markers (librosa), duck-audio, combinación xfade, relleno borroso de aspecto mixto, superposiciones .mov transparentes, GIFsreferences/video-editing-postprod.mdscripts/video_edit.py
Flujos de producción con NotionApp conectada de Notion + scripts/notion_sync.py: búsqueda, lectura de briefs/storyboards, exportación de métricas de DB a JSON para gráficos Manim, creación de páginas de storyboard, actualización de estados, registro de metadatos de MP4 renderizados, añadido de bloques y comentariosreferences/notion-video-workflows.mdscripts/notion_sync.py

Comandos esenciales de renderizado, edición de vídeo y Notion

Renderizar escenas de Manim (scripts/render.py)

# Vista previa rápida en borrador (media resolución 15 fps)
python3 scripts/render.py templates/character_rig_scene.py CharacterRigShowcase --quality draft

# Renderizado completo 1080p60 16:9
python3 scripts/render.py templates/stroke_drawing_morphing.py StrokeMorphShowcase --quality high

# Retrato 9:16 (1080x1920), 3:4 (1080x1440) o Cuadrado 1:1 (1080x1080) a 60 fps
python3 scripts/render.py my_scene.py MyScene --preset portrait --quality high
python3 scripts/render.py my_scene.py MyScene --preset square --quality high

# Superposición transparente (.mov con canal alfa para componer sobre vídeo)
python3 scripts/render.py lower_third.py LowerThird --transparent --quality high

Editar, subtitular, reencuadrar y ensamblar vídeos (scripts/video_edit.py)

# Inspeccionar cualquier clip de vídeo
python3 scripts/video_edit.py probe clip1.mp4 clip2.mp4

# Combinar clips de aspecto mixto con fundidos cruzados de 0.5 s y relleno de pantalla panorámica borroso ambiental
python3 scripts/video_edit.py combine clip1.mp4 square_clip.mp4 -o Combined.mp4 --preset landscape --xfade 0.5 --bg-mode blur

# Edición con IA: detección de tomas, subtítulos automáticos con Whisper, incrustación de subtítulos, reencuadre inteligente 9:16, sincronización de ritmo, ducking
python3 scripts/video_edit.py detect-scenes raw.mp4 --out scenes.json --split-dir shots/
python3 scripts/video_edit.py auto-captions talk.mp4 -o captions.srt --json-out words.json --words
python3 scripts/video_edit.py burn-subtitles talk.mp4 --srt captions.srt -o captioned.mp4
python3 scripts/video_edit.py smart-reframe wide.mp4 -o reel_9x16.mp4 --preset portrait
python3 scripts/video_edit.py beat-markers music.mp3 --out beats.json
python3 scripts/video_edit.py duck-audio video.mp4 --voice narration.mp3 --music bgm.mp3 -o mixed.mp4

# Recortar, cambiar velocidad, componer superposición Manim transparente, multiplexar audio o exportar GIF
python3 scripts/video_edit.py trim in.mp4 -o cut.mp4 --start 2.0 --end 14.5
python3 scripts/video_edit.py speed in.mp4 -o fast.mp4 --factor 1.5
python3 scripts/video_edit.py overlay base.mp4 overlay.mov -o out.mp4
python3 scripts/video_edit.py mux-audio video.mp4 music.mp3 -o final.mp4 --volume 0.35 --fade-out 1.5
python3 scripts/video_edit.py gif final.mp4 -o preview.gif --fps 24 --width 720

Sincronizar con Notion (scripts/notion_sync.py o app conectada de Notion)

export NOTION_TOKEN="ntn_..."
python3 scripts/notion_sync.py search "Video Roadmap"
python3 scripts/notion_sync.py read-page <PAGE_ID> --out brief.md
python3 scripts/notion_sync.py query-db <DB_ID> --out metrics.json
python3 scripts/notion_sync.py create-page --parent-db <DB_ID> --title "Launch Reel" --status "Draft" --body-file storyboard.md
python3 scripts/notion_sync.py update-status <PAGE_ID> --prop Status --value "Rendered"
python3 scripts/notion_sync.py log-render <PAGE_ID> --video out.mp4 --notes "1080p60 final"

Errores críticos (Gotchas)

  • -qh reinicia las dimensiones personalizadas: Nunca pases -qh al renderizar escenas en retrato (1080x1920, 1080x1440) o cuadrado (1080x1080); usa scripts/render.py --preset ... o -r WIDTH,HEIGHT --fps 60, y haz coincidir self.camera.frame_width / frame_height en construct() con la relación de aspecto objetivo.
  • Solo instalaciones sin conflictos: Nunca mezcles opencv-python + opencv-python-headless, pygame + pygame-ce, manim + manimgl, o pip install ffmpeg (usa imageio-ffmpeg / binario del sistema).
  • Decodificación de audio con faster-whisper: Siempre predecodifica el audio a 16 kHz mono float32 mediante ffmpeg antes de pasarlo a WhisperModel.transcribe(...) (video_edit.py auto-captions lo maneja automáticamente).
  • Actualizadores de cámara en MovingCameraScene: Siempre llama a self.add(self.camera.frame) antes de self.camera.frame.add_updater(track_cam), y usa suavizado basado en dt (1.0 - np.exp(-k * dt)) para que los borradores a 15 fps y los renders a 60 fps sigan la misma trayectoria.
  • Anclaje de cadera del personaje giratorio: Nunca calcules hip_h = -min(l_foot_y, r_foot_y) mientras abs(body_spin) > 0.02; mantén un hip_h fijo y vertical durante giros de 360°/720° para que la cabeza no se hunda en el suelo.
  • Colocación del centro de AnnularSector: Pasa arc_center=center directamente en lugar de .move_to(center) (que alinea el centro del cuadro delimitador).
  • Bases de tiempo de xfade en ffmpeg: Coloca fps=60,settb=1/60,format=yuv420p al final de cada rama de entrada (especialmente después de overlay) antes de encadenar xfade.
  • HUD 3D y ejes sin LaTeX: En ThreeDScene, llama a self.add_fixed_in_frame_mobjects(...) para elementos HUD 2D; pasa axis_config={"label_constructor": Text} a Axes, BarChart y ThreeDAxes.

Skills relacionados