Communitygithub.com

remotion-math-explainer

Crea videos explicativos animados e inmersivos de Matemáticas (Cálculo, Álgebra Lineal, Ecuaciones Diferenciales, Probabilidad, Demostraciones) en formato single-pane Log2Base2, con un foco en una sola ecuación por línea, gráficos animados al estilo 3Blue1Brown y subtítulos karaoke sincronizados por palabra, renderizando a MP4 1080p.

¿Qué es remotion-math-explainer?

Este skill convierte cualquier derivación, teorema, demostración o presentación matemática en un video explicativo animado en formato **single-pane Log2Base2**, sincronizado cuadro a cuadro y renderizado a **1920×1080 30fps MP4** usando Remotion. Está diseñado para mantener la atención del espectador en una sola escena visual unificada, evitando paneles laterales o tarjetas apiladas. La barra superior muestra el título y un progreso sutil, el lienzo SVG inmersivo (viewBox 1600×680) despliega gráficos en movimiento como cuadrículas, puntos animados, barras de magnitud y transformaciones 3D, mientras que los subtítulos karaoke aparecen palabra por palabra sincronizados con la voz sintetizada mediante edge-tts. Es útil para educadores, creadores de contenido y estudiantes que quieran transformar explicaciones matemáticas complejas en videos atractivos y de alta calidad, compatible con Remotion y edge-tts, y se ejecuta mediante scripts de línea de comandos (scaffold, synthesize-voiceover, render-mp4).

Compatible con✓Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/uzowurumauritius-rgb/remotion-stage/tree/main/skills/remotion-math-explainer

Preguntar en tu IA favorita

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

Documentación

Remotion Math Explainer (remotion-math-explainer)

Descripción general

Convierte cualquier derivación matemática, teorema, demostración o presentación en un video explicativo 1920×1080 30fps MP4 inmersivo y sincronizado cuadro a cuadro, en el Formato Single-Pane Log2Base2 Studio.

Nunca dividas la pantalla en paneles laterales enfrentados o paredes de tarjetas de texto apiladas. Cada video usa una única escena visual unificada (<SinglePaneStage>) para que la atención del espectador permanezca fija en la historia visual:

  1. Barra superior mínima (44px, integrada en SinglePaneStage):
    • Título del tema + píldora de sección activa actual a la izquierda; contador de paso sutil + barra de progreso fina a la derecha.
  2. UNA escena Log2Base2 unificada (SinglePaneStage — 100% de ancho):
    • Encabezado de foco en una sola línea: Muestra solo el título del paso actual y la línea de ecuación activa única (resaltando el término hablado activo en su lugar con borderBottom: "2px solid #FACC15", sin agregar nunca relleno horizontal) más una píldora compacta de información del token activo (símbolo → significado en lenguaje natural) que aparece en triggerFrame.
    • Lienzo SVG inmersivo de ancho completo (viewBox="0 0 1600 680"): Gráficos en movimiento continuos y espaciosos: cuadrículas de coordenadas vivas con puntos de datos de colores que se estiran y colapsan, números que se deslizan físicamente de matrices a bloques menores, líneas de tachado que barren, barras de magnitud con signo y cubos unitarios 3D que se deshacen hasta la identidad, integrados directamente en el mismo lienzo abierto.
  3. Barra de subtítulos inferior mínima (VoiceoverCaptionBar — 68px):
    • Subtítulos karaoke limpios centrados, palabra por palabra resaltada, impulsados por marcas de tiempo exactas de WordBoundary de TTS.

Dependencias

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md): Deben seguirse todas las reglas de animación de Remotion (useCurrentFrame(), interpolate(), spring(), <Sequence premountFor>, <Audio>, @remotion/google-fonts, y cero transiciones CSS).
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md): Requerido para ejecutar uv run --with edge-tts para la síntesis de voz neural.

Inicio rápido

# 1. Crear el proyecto explicador de matemáticas con Remotion
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/ruta/al/proyecto" \
  --output "/ruta/al/proyecto/scaffold-status.json"

# 2. Sintetizar voz neural natural + marcas de tiempo WordBoundary y de términos exactas
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/ruta/al/proyecto" \
  --beats-json "/ruta/al/proyecto/beats.json" \
  --voice "en-US-AndrewNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/ruta/al/proyecto/public/voiceover/manifest.json"

# 3. Renderizar el MP4 final a 1080p 30fps mediante el renderizador rápido de 8 workers con deduplicación de fotogramas clave
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/ruta/al/proyecto" \
  --composition-id "MathExplainer" \
  --out-name "MathExplainer.mp4" \
  --concurrency 8 \
  --output "/ruta/al/proyecto/render-report.json"

Narración inmersiva y flujo de trabajo

  1. Diseñar beats energéticos (beats.json):
    • Escribe una narración conversacional y atractiva (evita la redacción de libros de texto seca) para que incluso los estudiantes sin motivación sigan interesados.
    • Mantén el snippet en 2–4 líneas nítidas donde cada token aparezca textualmente en una línea y coincida con una triggerWord limpia en minúsculas en text.
    • Establece "motionStepFrames": 2 en beats con animaciones continuas de curvas, vectores, cuadrículas o elementos voladores.
  2. Crear proyecto y sintetizar voz:
    • Ejecuta scaffold (copia SinglePaneStage.tsx, VoiceoverCaptionBar.tsx y render_full_mp4.mjs) y synthesize-voiceover mediante scripts/explainer_cli.py.
  3. Crear gráficos en movimiento de lienzo completo (viewBox="0 0 1600 680"):
    • Pasa tu escena SVG inmersiva como children a <SinglePaneStage>.
    • Muestra, no digas: Reemplaza las tarjetas estáticas de texto/viñetas con movimiento físico: partículas/puntos que recorren deformaciones de coordenadas, elementos que vuelan entre posiciones, líneas de barrido láser, indicadores en vivo y gráficos en vivo lado a lado dentro del mismo lienzo abierto.
    • Siempre envuelve las líneas de cuadrícula que se deforman/extienden dentro de <clipPath> para que el movimiento nunca se superponga a etiquetas o píldoras.
  4. Verificar fotogramas fijos y renderizar MP4 final:
    • Ejecuta npm run lint e inspecciona fotogramas fijos representativos (npx remotion still) con read_file antes de ejecutar render-mp4.
    • Copia el .mp4 final a out/, la raíz del proyecto y la raíz del espacio de trabajo.

Límites de velocidad y errores comunes

  • scripts/explainer_cli.py impone /tmp/remotion_edge_tts.lock (espaciado de 0.35s, 3 reintentos con retroceso de 1s/2s/4s).
  • Nunca uses un diseño de pantalla dividida con múltiples paneles ni apiles sub-tarjetas con bordes—usa <SinglePaneStage> para que haya estrictamente un panel principal en pantalla.
  • Nunca muestres una demostración completa de varios pasos a la vez; resalta una línea de ecuación activa y una píldora de información activa a la vez.
  • Nunca agregues padding horizontal a los tokens en línea resaltados (solo borderBottom: "2px solid #FACC15" y backgroundColor).

Individual skills in this repo

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

remotion-code-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for source code (Mobile/Web UI, Backend, AI/ML, Algorithms) in a pure Log2Base2 single-stage format—with a focused single-line code spotlight, full-screen animated memory boxes, pointer arrows, data packets, and live execution state on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain code with /remotion, build a code walkthrough video, or turn a voiceover script into an MP4 explainer.

remotion-electronic-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Electronic Engineering (Semiconductors, PN Junctions, Diodes, BJTs, MOSFETs, CMOS Logic, Op-Amp IC Stages, ADC/DAC, PCB Signal Integrity) in a pure Log2Base2 single-stage format—with a focused single-line device equation spotlight, full-screen animated carrier/channel diagrams and live I-V curves on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain electronic engineering, semiconductors, transistors, or analog/digital ICs with /remotion.

remotion-physics-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Physics (Mechanics, Electromagnetism, Thermodynamics, Optics/Waves, Quantum Mechanics, Relativity) in a pure Log2Base2 single-stage format—with a focused single-line governing law spotlight, full-screen animated free-body/field/wave simulations and live telemetry on one canvas, millisecond-accurate WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain physics with /remotion or animate a physical law/system.

remotion-software-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Software Engineering (System Design, Distributed Systems, Microservices, Kubernetes/Docker, Design Patterns, Database Internals, CI/CD, Networking) in a pure Log2Base2 single-stage format—with a focused single-line contract/YAML spotlight, full-screen animated architecture flows with traveling request packets and live trace timelines on one canvas, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain software engineering, system design, or architecture with /remotion.

Skills relacionados