Remotion Software Engineering Explainer (remotion-software-explainer)
Resumen
Convierte cualquier diseño de sistemas, arquitectura distribuida, patrón de diseño, motor de base de datos o flujo de DevOps en un video explicativo inmersivo de Remotion, sincronizado por fotogramas, en 1920×1080 30fps MP4 en el Formato de Estudio Log2Base2 de Panel Único.
Nunca dividas la pantalla en paneles laterales en competencia o muros de tarjetas de texto apiladas. Cada video utiliza un escenario visual unificado (<SinglePaneStage>):
- Barra Superior Mínima (
44px, integrada enSinglePaneStage):- Título del tema + píldora de sección activa a la izquierda; contador de pasos sutil + barra de progreso delgada a la derecha.
- UN Escenario Log2Base2 Unificado (
SinglePaneStage— 100% de ancho):- Encabezado Spotlight de Línea Única Enfocado: Resalta el elemento hablado activo (
replicas: 3,ConsistentHash,WAL,CircuitBreaker) en la línea de especificación/contrato activa conborderBottom: "2px solid #FACC15"(nunca agregues padding horizontal) más una píldora de llamada activa compacta (término→rol arquitectónico) entriggerFrame. - Lienzo SVG Inmersivo de Ancho Completo (
viewBox="0 0 1600 680"): Nodos de servicio vectoriales progresivos (Cliente, API Gateway, Balanceador de Carga, Microservicios, Cola de Mensajes, Caché, Shards de BD, Pods de K8s) que aparecen al ser mencionados, conectados por tuberías animadas con guiones con paquetes de solicitudes viajeros, medidores en vivo de aciertos de caché/rendimiento y tramos de trazas de solicitudes que fluyen directamente a través del mismo lienzo abierto.
- Encabezado Spotlight de Línea Única Enfocado: Resalta el elemento hablado activo (
- Barra de Subtítulos Inferior Mínima (
VoiceoverCaptionBar—68px):- Subtítulos karaoke limpios y centrados con resaltado palabra por palabra, impulsados por marcas de tiempo exactas de
WordBoundaryde TTS.
- Subtítulos karaoke limpios y centrados con resaltado palabra por palabra, impulsados por marcas de tiempo exactas de
Dependencias
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md)uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md)
Inicio Rápido
# 1. Scaffold
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/ruta/al/proyecto" \
--output "/ruta/al/proyecto/scaffold-status.json"
# 2. Sintetizar Voz en Off
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-software-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 MP4 1080p
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/ruta/al/proyecto" \
--composition-id "SoftwareExplainer" \
--out-name "SoftwareExplainer.mp4" \
--concurrency 8 \
--output "/ruta/al/proyecto/render-report.json"
Narrativa y Flujo de Trabajo Inmersivos
- Mantén
snippetenfocado (2–4líneas) para que<SinglePaneStage>resalte una línea de contrato activa y revele los nodos de arquitectura progresivamente—nunca coloques 15 cajas en el fotograma 0. - Establece
"motionStepFrames": 2en los beats con paquetes de solicitudes viajeros, cascadas de failover o animaciones de autoescalado. - Muestra, no digas: Anima los paquetes de solicitudes moviéndose entre nodos junto con barras de latencia/cola/traza en vivo directamente dentro del mismo lienzo SVG de ancho completo
1600×680(usando<clipPath>cuando sea necesario), nunca en cajas separadas de pantalla dividida. - Siempre ejecuta
npm run lint, inspecciona fotogramas representativos (npx remotion still) conread_file, y guarda el.mp4final enout/, la raíz del proyecto y la raíz del espacio de trabajo.