Communitygithub.com

delorenj/skills

Animaciones Manim CE estilo 3Blue1Brown: videos de matemáticas y algoritmos.

¿Qué es skills?

Este skill permite a un agente AI generar videos de tipo explicativo al estilo 3Blue1Brown usando Manim Community Edition. Cubre desde animaciones matemáticas, derivaciones de ecuaciones, visualización de algoritmos, diagramas de arquitectura, hasta historias basadas en datos. El flujo de trabajo sigue un pipeline PLAN → CODE → RENDER → STITCH → AUDIO → REVIEW, con énfasis en una narrativa pedagógica clara, uso de paletas de colores coherentes, tipografía monoespaciada y animaciones con tiempos precisos. Soporta múltiples modos de entrada (concepto, ecuación, algoritmo, datos, diagrama, paper, 3D) y produce videos independientes por escena. El skill incluye referencias detalladas para diseño visual, ecuaciones, gráficos, cámaras 3D, y técnicas avanzadas como SCAMPER y Assumption Reversal para salidas creativas. Es compatible con entornos Python 3.10+, Manim CE v0.20+, LaTeX y ffmpeg, y no requiere GPU ni Node.js.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/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

Cuándo usarlo

Usar cuando los usuarios soliciten: explicaciones animadas, animaciones matemáticas, visualizaciones de conceptos, recorridos de algoritmos, videos explicativos técnicos, videos estilo 3Blue1Brown, o cualquier animación programática con contenido geométrico/matemático. Crea videos explicativos estilo 3Blue1Brown, visualizaciones de algoritmos, derivaciones de ecuaciones, diagramas de arquitectura e historias basadas en datos usando Manim Community Edition.

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 mensaje 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 de 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 dirigen la atención. Nunca muestres todo al máximo brillo. Elementos primarios a 1.0, elementos contextuales a 0.4, elementos estructurales (ejes, cuadrículas) a 0.15. El cerebro procesa la prominencia visual en capas.

Espacio para respirar. Cada animación necesita self.wait() después. El espectador necesita tiempo para absorber lo que acaba de aparecer. Nunca te apresures de una animación a la siguiente. 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, tamaño de tipografía consistente, velocidades de animación coincidentes. 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. Documentos de referencia probados contra 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áticasDemostración 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 papersArtículo de investigaciónHallazgos y métodos clave animadosreferences/scene-planning.md
Visualización 3DConcepto 3DSuperficies rotantes, 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 formato, mezcla de audio
TTSElevenLabs / Qwen3-TTS (opcional)Voz en off narrativa

Pipeline

PLANEAR --> CODIFICAR --> RENDERIZAR --> UNIR --> AUDIO (opcional) --> REVISAR
  1. PLANEAR — Escribe plan.md con el 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 independientemente
  3. RENDERIZAR — manim -ql script.py Escena1 Escena2 ... para borrador, -qh para producción
  4. UNIR — ffmpeg concatenación de clips de escenas en final.mp4
  5. AUDIO (opcional) — Agregar voz en off y/o música de fondo vía ffmpeg. Ver references/rendering.md
  6. REVISAR — Renderizar vistas previas estáticas, verificar contra el plan, ajustar

Estructura del Proyecto

nombre-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
Clásico 3B1B#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/morfismo1.5s1.5s
Etiqueta de apoyo0.8s0.5s
Limpieza FadeOut0.5s0.3s
Revelación "momento ajá"2.5s3.0s

Escala de Tipografía

RolTamaño de fuenteUso
Título48Títulos de escena, 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. Ver 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)

Mínimo font_size=18 para legibilidad.

Variación por Escena

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

  • Color dominante diferente de la paleta
  • Diseño diferente — no centres todo siempre
  • Entrada de animación diferente — varía entre Write, FadeIn, GrowFromCenter, Create
  • Peso visual diferente — algunas escenas densas, otras dispersas

Flujo de Trabajo

Paso 1: Planificar (plan.md)

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

Paso 2: Codificar (script.py)

Una clase por escena. Cada escena es renderizable independientemente.

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_ConceptoClave  # borrador
manim -qh script.py Escena1_Introduccion Escena2_ConceptoClave  # producción

Paso 4: Unir

cat > concat.txt << 'EOF'
file 'media/videos/script/480p15/Escena1_Introduccion.mp4'
file 'media/videos/script/480p15/Escena2_ConceptoClave.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_ConceptoClave  # vista previa estática

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 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(ROJO))  # luego anima

Objetivos de Rendimiento

CalidadResoluciónFPSVelocidad
-ql (borrador)854x480155-15s/escena
-qm (media)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 tiempo
references/mobjects.mdTexto, formas, VGroup/Group, posicionamiento, estilizado, 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 escena, plantilla de planificación
references/rendering.mdReferencia CLI, presets de calidad, ffmpeg, flujo de trabajo de voz en off, exportación 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 a código, previas a renderizado y posteriores a renderizado, diseño espacial, color, tempo

Divergencia Creativa (usar solo cuando el usuario solicite salida experimental/creativa/única)

Si el usuario pide 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 fresco para una explicación estándar
  • Inversión de Suposiciones — 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 sinuoso, matriz → cuadrícula de ciudad)
  • Combinar: fusiona dos enfoques de explicación (algebraico + geométrico simultáneamente)
  • Invertir: deriva hacia atrás — comienza desde el resultado y deconstruye hasta los axiomas
  • Modificar: exagera un parámetro para mostrar por qué importa (10x la tasa de aprendizaje, 1000x el tamaño de muestra)
  • Eliminar: elimina toda notación — explica puramente a través de la animación y las relaciones espaciales

Inversión de Suposiciones

  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 la suposición más fundamental
  3. Invértela (derivación de derecha a izquierda, incrustación 3D de un concepto 2D, transformación continua en lugar de pasos, cero notación)
  4. Explora lo que revela la inversión que el enfoque estándar oculta

Individual skills in this repo

This repo contains 14 individual skills — each has its own dedicated page.

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

delorenj/skills

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

delorenj/skills

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames (e.g. "port my Remotion project to HyperFrames"). Do NOT use when (a) authoring a NEW HyperFrames composition (even if A/B-testing a Remotion video); (b) Remotion is mentioned in passing; (c) Remotion code is shared as reference, not for translation; (d) the user wants "the same video as my Remotion one" without explicitly asking to migrate the source — treat as a fresh HyperFrames build. When in doubt, default to the `hyperframes` skill. Detects unsupported patterns (useState, useEffect side effects, async calculateMetadata, third-party React component libraries, `@remotion/lambda`) and recommends the runtime interop escape hatch instead of a lossy translation.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Skills relacionados