Communitygithub.com

remotion-software-explainer

Crea videos explicativos de Remotion sincronizados e inmersivos en un solo panel para temas de Ingeniería de Software (Diseño de Sistemas, Sistemas Distribuidos, Microservicios, Kubernetes/Docker, Patrones de Diseño, Bases de Datos, CI/CD, Redes) en un formato Log2Base2 de etapa única, con un spotlight de línea única/contrato YAML, animaciones de arquitectura a pantalla completa con paquetes de solicitudes viajeros y líneas de tiempo de trazas en vivo en un solo lienzo, subtítulos karaoke con división por palabras y renderizado rápido en MP4 1080p. Úsalo siempre que el usuario pida explicar ingeniería de software, diseño de sistemas o arquitectura con /remotion.

¿Qué es remotion-software-explainer?

Este skill transforma 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 en formato MP4 1920×1080 a 30fps, utilizando un único panel visual de Log2Base2. En lugar de dividir la pantalla en paneles laterales o tarjetas de texto apiladas, cada video emplea un escenario visual unificado (`<SinglePaneStage>`) que integra una barra superior mínima con el título y un contador de pasos, un lienzo SVG de ancho completo (1600×680) para animaciones progresivas de nodos de servicio con paquetes de solicitudes viajeros y medidores en vivo, y una barra de subtítulos inferior con karaoke palabra por palabra sincronizada con las marcas de tiempo de TTS. Es ideal para desarrolladores y agentes de IA que necesitan crear explicaciones visuales claras y dinámicas de conceptos complejos de ingeniería de software, soportando plataformas como Claude Code, Cursor o Codex. El flujo de trabajo incluye el scaffolding del proyecto con la CLI integrada, la síntesis de voz usando edge-tts y el renderizado final en MP4 1080p, asegurando animaciones fluidas con pasos de movimiento configurables y una presentación visual progresiva que evita saturar la pantalla desde el inicio.

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

Preguntar en tu IA favorita

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

Documentación

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>):

  1. Barra Superior Mínima (44px, integrada en SinglePaneStage):
    • Título del tema + píldora de sección activa a la izquierda; contador de pasos sutil + barra de progreso delgada a la derecha.
  2. 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 con borderBottom: "2px solid #FACC15" (nunca agregues padding horizontal) más una píldora de llamada activa compacta (término → rol arquitectónico) en triggerFrame.
    • 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.
  3. 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 WordBoundary de TTS.

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

  1. Mantén snippet enfocado (2–4 lí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.
  2. Establece "motionStepFrames": 2 en los beats con paquetes de solicitudes viajeros, cascadas de failover o animaciones de autoescalado.
  3. 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.
  4. Siempre ejecuta npm run lint, inspecciona fotogramas representativos (npx remotion still) con read_file, y guarda el .mp4 final en out/, la raíz del proyecto y la raíz del espacio de trabajo.

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-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.

Skills relacionados