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:
- Barra superior minimalista (
44px, integrada enSinglePaneStage)- 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.
- 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 entriggerFrame. - 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 etiquetadas0x1004, variables mutantes, flechas punteras animadas constrokeDashoffset, 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.
- 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
- 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
WordBoundaryde TTS (startMs,endMs).
- Subtítulos limpios centrados, karaoke palabra por palabra resaltados, impulsados por marcas de tiempo de milisegundos exactas
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-fontsy cero transiciones CSS).uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md): Requerido para ejecutaruv run --with edge-ttspara la síntesis neuronal de voz en off y la extracción de marcas de tiempoWordBoundary.
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
- 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
codeSnippetenfocado (1–4líneas) para que la línea activa pasada a<SinglePaneStage>contenga eltokenactivo textualmente. - Establecer
"motionStepFrames": 2en beats con paquetes viajeros, saltos de puntero, intercambios de arrays o animaciones de tensor/UI en vivo.
- Crear proyecto y sintetizar voz en off:
- Ejecutar
scaffold(copiaSinglePaneStage.tsx,VoiceoverCaptionBar.tsxyrender_full_mp4.mjs) ysynthesize-voiceovermediantescripts/code_explainer_cli.py.
- Ejecutar
- Autor de gráficos en movimiento de lienzo completo (
viewBox="0 0 1600 680")- Pasar tu storyboard SVG animado de Log2Base2 × KodeKloud como
childrendentro 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.
- Pasar tu storyboard SVG animado de Log2Base2 × KodeKloud como
- Verificar fotogramas y renderizar el MP4 final:
- Ejecutar
npm run linte inspeccionar fotogramas representativos (npx remotion still) conread_filepara verificar que no haya superposición ni recorte. - Ejecutar
render-mp4(scripts/render_full_mp4.mjs) y asegurarse de que el.mp4final se guarde enout/, en la raíz del proyecto y en la raíz del espacio de trabajo.
- Ejecutar
Límite de velocidad y errores comunes
scripts/code_explorer_cli.pyimpone/tmp/remotion_edge_tts.lock(espaciado de0.35s, 3 reintentos con retroceso de1s/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
paddinghorizontal a tokens en línea resaltados (soloborderBottom: "2px solid #FACC15"ybackgroundColor). - Nunca uses tarjetas de texto estáticas dentro del escenario SVG cuando el movimiento animado de memoria/puntero/paquete pueda demostrar el concepto visualmente.