Communitygithub.com

Remotion Math Explainer

Cria vídeos explicativos imersivos em matemática (Cálculo, Álgebra Linear, Equações Diferenciais, Probabilidade, Provas) no formato single-pane do Log2Base2, com spotlight em uma única equação, gráficos animados ao estilo 3Blue1Brown × Log2Base2, legendas sincronizadas por palavra e renderização rápida em MP4 1080p.

O que é Remotion Math Explainer?

Este skill transforma qualquer derivação matemática, teorema, prova ou apresentação em um vídeo explicativo Remotion MP4 1920×1080 30fps totalmente sincronizado, no formato single-pane do Log2Base2. Ele mantém o espectador focado em um único palco visual unificado, eliminando divisões de tela ou painéis laterais. O destaque é uma única linha de equação ativa com um termo destacado em tempo real via sublinhado amarelo, enquanto um canvas SVG imersivo exibe gráficos animados, coordenadas dinâmicas e elementos visuais que se transformam. Legendas estilo karaokê com destaque palavra por palavra são geradas a partir de timestamps exatos de TTS neural. O skill depende de `remotion-best-practices` para animações e `uv` com `edge-tts` para síntese de voz. O fluxo inclui projetar beats narrativos, scaffold do projeto, sintetizar voiceover e renderizar o MP4 final com alta concorrência. Recomenda-se evitar layouts multi-painel e usar `<SinglePaneStage>` para manter uma única cena principal.

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

Perguntar na sua IA favorita

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

Documentação

Remotion Math Explainer (remotion-math-explainer)

Visão Geral

Transforma qualquer derivação matemática, teorema, prova ou conjunto de slides em um vídeo explicativo Remotion MP4 1920×1080 30fps totalmente sincronizado, no formato single-pane Log2Base2 Studio.

Nunca divida a tela em painéis laterais concorrentes ou paredes de cartões de texto empilhados. Cada vídeo usa um palco visual unificado (<SinglePaneStage>) para que toda a atenção do espectador permaneça na história visual:

  1. Barra Superior Mínima (44px, integrada ao SinglePaneStage):
    • Título do tópico + pílula da seção ativa à esquerda; contador de etapas sutil + barra de progresso fina à direita.
  2. ÚNICO Palco Log2Base2 Unificado (SinglePaneStage — 100% de largura):
    • Cabeçalho Spotlight de Linha Única: Mostra apenas o título da etapa atual e a única linha de equação ativa (destacando o termo falado ativo no local com borderBottom: "2px solid #FACC15", nunca adicionando padding horizontal) além de uma pílula compacta de chamada de token ativo (símbolo → significado em linguagem simples) surgindo em triggerFrame.
    • Canvas SVG Imersivo em Largura Total (viewBox="0 0 1600 680"): Gráficos em movimento contínuos e espaçosos — grades de coordenadas vivas com pontos de dados coloridos se esticando e colapsando, números deslizando fisicamente de matrizes para blocos menores, linhas de corte a laser, barras de magnitude sinalizadas e cubos unitários 3D se desfazendo de volta à identidade — integrados diretamente no mesmo canvas aberto.
  3. Barra de Legenda Inferior Mínima (VoiceoverCaptionBar — 68px):
    • Legendas limpas centralizadas com destaque palavra por palavra no estilo karaokê, acionadas por timestamps exatos de WordBoundary do TTS.

Dependências

  • remotion-best-practices (~/.gemini/skills/remotion/SKILL.md): Deve ser seguido para todas as regras de animação Remotion (useCurrentFrame(), interpolate(), spring(), <Sequence premountFor>, <Audio>, @remotion/google-fonts e zero transições CSS).
  • uv (~/.gemini/config/plugins/science/skills/uv/SKILL.md): Necessário para executar uv run --with edge-tts na síntese de voz neural.

Início Rápido

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

# 2. Sintetizar narração neural natural + timestamps exatos WordBoundary e de termos
uv run --with edge-tts python3 \
  ~/.gemini/config/skills/remotion-math-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 final em 1080p 30fps via renderizador rápido com 8 workers e deduplicação de keyframes
uv run python3 \
  ~/.gemini/config/skills/remotion-math-explainer/scripts/explainer_cli.py \
  render-mp4 \
  --project-dir "/caminho/para/projeto" \
  --composition-id "MathExplainer" \
  --out-name "MathExplainer.mp4" \
  --concurrency 8 \
  --output "/caminho/para/projeto/render-report.json"

Narrativa Imersiva e Fluxo de Trabalho

  1. Projetar Beats Energéticos (beats.json) :
    • Escreva narração conversacional e com gancho inicial (evite frases secas de livro didático) para que até estudantes desmotivados permaneçam engajados.
    • Mantenha snippet com 2–4 linhas nítidas onde cada token apareça literalmente em uma linha e corresponda a uma triggerWord limpa em minúsculas em text.
    • Defina "motionStepFrames": 2 em beats com animações contínuas de curvas, vetores, grades ou elementos voadores.
  2. Scaffold e Sintetizar Voz:
    • Execute scaffold (copia SinglePaneStage.tsx, VoiceoverCaptionBar.tsx e render_full_mp4.mjs) e synthesize-voiceover através de scripts/explainer_cli.py.
  3. Criar Gráficos em Movimento em Tela Cheia (viewBox="0 0 1600 680"):
    • Passe seu palco SVG imersivo como children para <SinglePaneStage>.
    • Mostre, não conte: Substitua cartões estáticos de texto/bullet por movimento físico — partículas/pontos montados em deformações de coordenadas, elementos voando entre posições, linhas de laser varrendo, medidores ao vivo e gráficos lado a lado no mesmo canvas aberto.
    • Sempre envolva linhas de grade que se deformam/estendem dentro de <clipPath> para que o movimento nunca sangre sobre rótulos ou pílulas.
  4. Verificar Stills e Renderizar MP4 Final:
    • Execute npm run lint e inspecione stills representativos (npx remotion still) com read_file antes de executar render-mp4.
    • Copie o .mp4 final para out/, a raiz do projeto e a raiz do workspace.

Limitação de Taxa e Erros Comuns

  • scripts/explainer_cli.py impõe /tmp/remotion_edge_tts.lock (espaçamento de 0.35s, 3 tentativas com 1s/2s/4s de backoff).
  • Nunca use um layout de tela dividida com vários painéis ou empilhe subcartões com borda — use <SinglePaneStage> para que haja estritamente um painel principal na tela.
  • Nunca despeje uma prova completa de várias etapas na tela de uma vez; destaque uma linha de equação ativa e uma pílula de chamada ativa por vez.
  • Nunca adicione padding horizontal a tokens inline destacados (apenas borderBottom: "2px solid #FACC15" e backgroundColor).

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

Habilidades Relacionadas