Communitygithub.com

remotion-code-explainer

Crea vídeos explicativos de código fuente sincronizados e inmersivos en formato Remotion, con una única ventana unificada estilo Log2Base2 que incluye un foco en una sola línea de código, animaciones a pantalla completa de cajas de memoria, flechas punteras, paquetes de datos y estado de ejecución en vivo, subtítulos karaoke WordBoundary y renderizado rápido en MP4 1080p.

¿Qué es remotion-code-explainer?

Este skill transforma cualquier archivo de código fuente en un video explicativo Remotion inmersivo de 1920×1080 a 30fps, en formato MP4 con una sola ventana unificada (SinglePaneStage) estilo Log2Base2. En lugar de usar múltiples paneles o paredes de código estáticas, concentra toda la atención del espectador en un único escenario visual que muestra la línea de código activa resaltada, animaciones de memoria (cajas etiquetadas como 0x1004, variables que mutan, flechas punteras con dashoffset), pilas de llamadas, intercambios en arrays/árboles y vistas previas de UI/tensores en el mismo canvas SVG de 1600×680. Incluye una barra superior minimalista con el título y contador de pasos, y una barra inferior de subtítulos karaoke palabra por palabra sincronizada con timestamps WordBoundary de TTS. Soporta plataformas como Claude Code, Cursor y Codex, y requiere seguir las reglas de remotion-best-practices y usar uv para síntesis de voz. El flujo de trabajo típico incluye diseñar beats narrativos en un archivo beats.json, ejecutar scaffold y synthesize-voiceover mediante scripts de Python, y renderizar el video final con un worker de 8 hilos para máxima velocidad. El skill aplica limitación de tasa en scripts de TTS y prohíbe explícitamente pantallas divididas, padding horizontal en tokens resaltados o tarjetas de texto estáticas cuando la animación puede demostrar el concepto.

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

Preguntar en tu IA favorita

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

Documentación

Remotion Code Explainer (remotion-code-explainer)

Resumen

Convierte cualquier archivo de código fuente en un vídeo explicativo Remotion inmersivo, sincronizado por fotogramas, en 1920×1080 30fps MP4 con el Formato Single-Pane Log2Base2 Studio.

Nunca dividas la pantalla en paneles laterales competitivos o muros atestados de múltiples tarjetas. Cada vídeo utiliza una única ventana visual unificada (<SinglePaneStage>) para que la atención completa del espectador se mantenga en cómo se ejecuta el código:

  1. Barra superior minimalista (44px, integrada en SinglePaneStage)
    • Título de la lección + píldora de sección activa a la izquierda; contador de pasos sutil + barra de progreso delgada a la derecha.
  2. UNA única ventana Log2Base2 unificada (SinglePaneStage — 100% de ancho)
    • Encabezado de foco en una sola línea: Muestra solo el título del paso actual y la única línea de código activa en una monoespaciada nítida (resaltando el token hablado activo en su lugar con borderBottom: "2px solid #FACC15", nunca añadiendo relleno horizontal) más una píldora de llamada activa compacta (token → significado en lenguaje llano) que aparece en triggerFrame.
    • Lienzo SVG inmersivo de ancho completo (viewBox="0 0 1600 680"): Gráficos en movimiento espacioso y continuo que combinan visuales de memoria/ejecución de Log2Base2 (cajas de memoria etiquetadas 0x1004, variables mutantes, flechas punteras animadas con strokeDashoffset, marcos de pila empujándose/retirándose, intercambios de arrays/árboles) directamente junto a vistas previas de UI/stdout/tensor en el mismo lienzo abierto.
  3. Barra inferior de subtítulos minimalista (VoiceoverCaptionBar — 68px)
    • Subtítulos limpios centrados, karaoke palabra por palabra resaltados, impulsados por marcas de tiempo de milisegundos exactas WordBoundary de TTS (startMs, endMs).

Dependencias

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md): Debe seguirse para 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 neuronal de voz en off y la extracción de marcas de tiempo WordBoundary.

Inicio rápido

# 1. Crear el proyecto Remotion explicativo
uv run python3 \
  ~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
  scaffold \
  --project-dir "/ruta/al/proyecto" \
  --source-file "/ruta/al/archivo.ext" \
  --output "/ruta/al/proyecto/scaffold-status.json"

# 2. Sintetizar voz en off neuronal natural + marcas de tiempo exactas de WordBoundary y token
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-code-explainer/scripts/code_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 1080p 30fps mediante un renderizador rápido de 8 workers con deduplicación de fotogramas clave
uv run python3 \
  ~/.gemini/config/skills/remotion-code-explainer/scripts/code_explainer_cli.py \
  render-mp4 \
  --project-dir "/ruta/al/proyecto" \
  --composition-id "CodeExplainer" \
  --out-name "Explainer.mp4" \
  --concurrency 8 \
  --output "/ruta/al/proyecto/render-report.json"

Narrativa inmersiva y flujo de trabajo

  1. Diseñar beats enérgicos (beats.json)
    • Escribir una narración nítida y conversacional que enganche al espectador de inmediato en por qué el código se comporta como lo hace.
    • Mantener codeSnippet enfocado (1–4 líneas) para que la línea activa pasada a <SinglePaneStage> contenga el token activo textualmente.
    • Establecer "motionStepFrames": 2 en beats con paquetes viajeros, saltos de puntero, intercambios de arrays o animaciones de tensor/UI en vivo.
  2. Crear proyecto y sintetizar voz en off:
    • Ejecutar scaffold (copia SinglePaneStage.tsx, VoiceoverCaptionBar.tsx y render_full_mp4.mjs) y synthesize-voiceover mediante scripts/code_explainer_cli.py.
  3. Autor de gráficos en movimiento de lienzo completo (viewBox="0 0 1600 680")
    • Pasar tu storyboard SVG animado de Log2Base2 × KodeKloud como children dentro de <SinglePaneStage>.
    • Muestra, no cuentes: Reemplaza muros de código estáticos y cuadros de texto con movimiento físico: valores volando desde registros/variables a ranuras de memoria, punteros reenrutándose suavemente, paquetes de datos viajando entre componentes, y salidas de estado/UI en vivo actualizándose en el mismo lienzo abierto.
    • Envuelve cuadrículas dinámicas o trazas desplazables en <clipPath> para que el movimiento nunca se salga de su región.
  4. Verificar fotogramas y renderizar el MP4 final:
    • Ejecutar npm run lint e inspeccionar fotogramas representativos (npx remotion still) con read_file para verificar que no haya superposición ni recorte.
    • Ejecutar render-mp4 (scripts/render_full_mp4.mjs) y asegurarse de que el .mp4 final se guarde en out/, en la raíz del proyecto y en la raíz del espacio de trabajo.

Límite de velocidad y errores comunes

  • scripts/code_explorer_cli.py impone /tmp/remotion_edge_tts.lock (espaciado de 0.35s, 3 reintentos con retroceso de 1s/2s/4s).
  • Nunca uses un panel de control de pantalla dividida en 2 zonas ni vuelques un muro de código desplazable de 40 líneas; mantén la pantalla en un solo panel <SinglePaneStage>.
  • Nunca añadas padding horizontal a tokens en línea resaltados (solo borderBottom: "2px solid #FACC15" y backgroundColor).
  • Nunca uses tarjetas de texto estáticas dentro del escenario SVG cuando el movimiento animado de memoria/puntero/paquete pueda demostrar el concepto visualmente.

Individual skills in this repo

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

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-math-explainer

Creates synchronized, immersive single-pane Remotion visual explainer videos for Mathematics (Calculus, Linear Algebra, Differential Equations, Probability, Proofs) in a pure Log2Base2 single-stage format—with a focused single-line equation spotlight, full-screen 3Blue1Brown x Log2Base2 animated geometric/data motion graphics, WordBoundary karaoke captions, and fast 1080p MP4 rendering. Use whenever the user asks to explain math with /remotion, animate a derivation or theorem, or turn a math script into an MP4 explainer.

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