Communitygithub.com

remotion-software-explainer

Cria vídeos explicativos Remotion sincronizados e imersivos em painel único para Engenharia de Software (System Design, Sistemas Distribuídos, Microsserviços, Docker/Kubernetes, Padrões de Projeto, Internals de Banco de Dados, CI/CD, Redes) no formato Log2Base2 de estágio único — com destaque em uma única linha/contrato YAML, animações de arquitetura em tela cheia com pacotes de requisição viajantes e linhas do tempo de rastreamento ao vivo em um único canvas, legendas karaokê palavra por palavra e renderização rápida de MP4 em 1080p. Use sempre que o usuário pedir para explicar engenharia de software, design de sistemas ou arquitetura com /remotion.

O que é remotion-software-explainer?

Esta skill gera vídeos explicativos visuais e imersivos para tópicos complexos de Engenharia de Software (como design de sistemas, sistemas distribuídos, microsserviços, Kubernetes/Docker, padrões de projeto, internals de banco de dados, CI/CD e redes). O formato de saída é um vídeo MP4 1080p 30fps, criado com a biblioteca Remotion, e segue estritamente o formato 'Painel Único Log2Base2 Studio'. Isso significa que, em vez de dividir a tela em vários painéis, toda a informação visual é apresentada em um único palco unificado, com uma barra superior mínima contendo o título e o progresso, um canvas SVG imersivo de largura total (que anima nós de arquitetura, pipelines e pacotes de requisição) e uma barra de legendas inferior com destaque karaokê palavra por palavra, sincronizada com a narração gerada por TTS (Text-to-Speech). A skill depende de duas outras: 'remotion-best-practices' para as práticas padrão de produção de vídeos Remotion, e 'uv' para o gerenciamento das dependências Python e execução dos scripts da CLI. O fluxo de uso é primeiro gerar o scaffold do projeto, depois sintetizar a narração com edge-tts e, por fim, renderizar o vídeo MP4. O foco está em mostrar progressivamente os componentes da arquitetura, animar os fluxos de requisição e manter o contrato/linha de destaque ativo para guiar a atenção do espectador. É especialmente útil para criar conteúdo didático de alta qualidade sobre conceitos de engenharia de software de forma automatizada.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Remotion Explicador de Engenharia de Software (remotion-software-explainer)

Visão Geral

Transforma qualquer design de sistema, arquitetura distribuída, padrão de projeto, funcionamento interno de banco de dados ou fluxo de DevOps em um vídeo explicativo Remotion MP4 1920×1080 30fps imersivo e sincronizado com quadros, no Formato Log2Base2 Studio de Painel Único.

Nunca divida a tela em painéis lado a lado concorrentes ou paredes de cartões de texto empilhadas. Cada vídeo usa um palco visual unificado (<SinglePaneStage>):

  1. Barra Superior Mínima (44px, integrada ao SinglePaneStage) :
    • Título do tópico + pílula de seção ativa à esquerda; contador de etapas sutil + barra de progresso fina à direita.
  2. UM Palco Log2Base2 Unificado (SinglePaneStage — 100% de largura) :
    • Cabeçalho de Destaque de Linha Única Focado: Destaca o elemento falado ativo (replicas: 3, ConsistentHash, WAL, CircuitBreaker) na linha de contrato/especificação ativa com borderBottom: "2px solid #FACC15" (nunca adicione preenchimento horizontal) mais uma pílula de chamada ativa compacta (termo → função arquitetural) em triggerFrame.
    • Canvas SVG Imersivo de Largura Total (viewBox="0 0 1600 680"): Nós de serviço vetoriais progressivos (Cliente, API Gateway, Balanceador de Carga, Microsserviços, Fila de Mensagens, Cache, Shards de BD, Pods K8s) aparecendo conforme são falados, conectados por pipelines animados tracejados com pacotes de requisição viajantes, medidores de acerto de cache/throughput ao vivo e spans de rastreamento de requisição fluindo diretamente no mesmo canvas aberto.
  3. Barra de Legendas Inferior Mínima (VoiceoverCaptionBar — 68px) :
    • Legendas limpas e centralizadas com destaque palavra por palavra no estilo karaokê, geradas por timestamps exatos de WordBoundary do TTS.

Dependências

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md)
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md)

Início Rápido

# 1. Scaffold
uv run python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  scaffold \
  --project-dir "/caminho/para/projeto" \
  --output "/caminho/para/projeto/scaffold-status.json"

# 2. Sintetizar Narração
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
  synthesize-voiceover \
  --project-dir "/caminho/para/projeto" \
  --beats-json "/caminho/para/projeto/beats.json" \
  --voice "en-US-AndrewNeural" \
  --rate "+2%" \
  --pause-sec 0.40 \
  --output "/caminho/para/projeto/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 "/caminho/para/projeto" \
  --composition-id "SoftwareExplainer" \
  --out-name "SoftwareExplainer.mp4" \
  --concurrency 8 \
  --output "/caminho/para/projeto/render-report.json"

Narrativa Imersiva e Fluxo de Trabalho

  1. Mantenha o snippet focado (2–4 linhas) para que <SinglePaneStage> destaque uma linha de contrato ativa e revele os nós da arquitetura progressivamente — nunca despeje 15 caixas no quadro 0.
  2. Defina "motionStepFrames": 2 nos beats com pacotes de requisição viajantes, cascatas de failover ou animações de escalonamento automático.
  3. Mostre, não conte: Anime pacotes de requisição se movendo entre nós junto com barras de latência/fila/rastreamento ao vivo diretamente dentro do mesmo canvas SVG de largura total 1600×680 (usando <clipPath> quando necessário), nunca em caixas separadas em tela dividida.
  4. Sempre execute npm run lint, inspecione quadros representativos estáticos (npx remotion still) com read_file e salve o .mp4 final em out/, na raiz do projeto e na raiz do workspace.

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.

Habilidades Relacionadas