Communitygithub.com

Remotion para HyperFrames

Traduza uma composição de vídeo Remotion (baseada em React) existente em uma composição HTML do HyperFrames. Use SOMENTE quando o usuário pedir explicitamente para portar, converter, migrar, traduzir ou reescrever uma composição Remotion como HyperFrames — por exemplo, "portar meu projeto Remotion para HyperFrames", "converter este código Remotion para HyperFrames", "migrar do Remotion", "traduzir esta composição Remotion" ou "reescrever isso como HTML do HyperFrames". NÃO use quando (a) o usuário está criando uma NOVA composição HyperFrames, mesmo que ele tenha ou esteja fazendo teste A/B com um vídeo Remotion similar; (b) o usuário menciona Remotion de passagem sem pedir migração; (c) o usuário compartilha código Remotion como material de referência em vez de pedir uma tradução; (d) o usuário pede "o mesmo vídeo que o meu Remotion" sem pedir explicitamente para migrar o código-fonte — trate isso como uma nova construção HyperFrames. Em caso de dúvida, opte por criar uma composição HyperFrames nativa com a skill `hyperframes`. A skill detecta padrões não suportados (uso...

O que é Remotion para HyperFrames?

Esta skill traduz composições de vídeo Remotion (baseadas em React) para composições HyperFrames (HTML + GSAP). Ela oferece um mapeamento mecânico direto para aproximadamente 80% das composições típicas, recusando-se a traduzir padrões que não se encaixam no modelo orientado a busca (seek-driven) do HyperFrames e recomendando o padrão de interoperabilidade em tempo de execução do PR #214 para os casos restantes. A skill inclui um corpus de teste em camadas (T1 a T4, 4 fixtures) que avalia as traduções com base em limites de SSIM medidos, exigindo validação automática para garantir a fidelidade visual. O fluxo de trabalho consiste em cinco etapas: lint do código-fonte Remotion para detectar bloqueadores e avisos, planejamento da tradução com base no mapa de API e referências modulares, geração da composição HyperFrames (index.html com divs de cena, estilos inline e uma timeline GSAP), validação via comparação de quadros com SSIM, e documentação de lacunas em um arquivo TRANSLATION_NOTES.md. A skill é compatível com a CLI do HyperFrames e scripts auxiliares para renderização e diff, e é particularmente útil para desenvolvedores que desejam migrar projetos Remotion existentes para a plataforma HyperFrames sem reescrever toda a lógica de animação do zero.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/libz-renlab-ai/TeamBrain/tree/HEAD/.agents/skills/remotion-to-hyperframes

Perguntar na sua IA favorita

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

Documentação

O que Remotion para HyperFrames faz?

Visão Geral

Traduza composições de vídeo Remotion (baseadas em React) em composições HyperFrames (HTML + GSAP). A maioria dos idiomas do Remotion tem equivalentes diretos no HyperFrames — a tradução é mecânica para ~80% das composições típicas. Esta skill codifica o mapeamento e protege contra os 20% que resultam em perda, recusando-se a traduzir padrões que não se encaixam no modelo orientado a busca do HF e recomendando o padrão de interoperabilidade em tempo de execução do PR #214.

A skill vem com um corpus de teste em camadas (T1–T4, 4 fixtures no total) que avalia as traduções com base em limites de SSIM medidos. Não traduza sem executar a avaliação — uma tradução que "parece correta", mas renderiza 0,05 SSIM abaixo da linha de base validada, está silenciosamente errada.

Fluxo de Trabalho

Etapa 1: Lint do código-fonte

Execute scripts/lint_source.py no diretório de origem do Remotion. O lint detecta padrões que não podem ser traduzidos de forma limpa:

  • Bloqueadores (recuse + recomende interop): useState, useReducer, useEffect/useLayoutEffect com dependências não vazias, calculateMetadata assíncrono, bibliotecas de UI React de terceiros (MUI, Chakra, Mantine, antd, shadcn, Radix, NextUI).
  • Avisos (traduza após remover o constructo): configuração @remotion/lambda, delayRender, useCallback, useMemo, hooks personalizados.
  • Informações (traduza com nota): staticFile, interpolateColors.

Se algum bloqueador for acionado, pare. Leia references/escape-hatch.md e apresente a mensagem de recomendação. Avisos não interrompem a tradução — remova o constructo problemático na etapa 3 e anote a lacuna em TRANSLATION_NOTES.md. A configuração @remotion/lambda é o caso de aviso canônico: a skill remove a importação + as chamadas renderMediaOnLambda(...), mas traduz o restante da composição.

Etapa 2: Planeje a tradução

Leia references/api-map.md — o índice de cada API do Remotion e seu equivalente no HF ou referência por tópico. Identifique quais referências de tópico você precisará com base no que o código-fonte usa:

Código-fonte contémCarregar referência
Composition, defaultProps, schema, calculateMetadataparameters.md
Sequence, Series, Loop, AbsoluteFill, Freezesequencing.md
useCurrentFrame, interpolate, spring, Easing, interpolateColorstiming.md
Audio, Video, Img, IFrame, staticFile, delayRendermedia.md
TransitionSeries, @remotion/transitionstransitions.md
@remotion/lottielottie.md
@remotion/google-fonts/<Family>, Font.loadFont, @font-facefonts.md

Não carregue todos eles — carregue apenas o que o código-fonte específico precisar.

Etapa 3: Gere a composição HF

Emita index.html com:

  • Raiz <div id="stage"> carregando o data-composition-id da composição, data-start="0", data-duration (em segundos), data-fps, data-width, data-height, mais um data-* por prop escalar.
  • Uma lista plana de divs de cena com data-start / data-duration / data-track-index.
  • <style> inline para layout; CSS define o estado from de cada propriedade animada.
  • Uma única tag <script> no final contendo uma gsap.timeline({paused: true}) pausada. Toda derivação de useCurrentFrame() do Remotion se torna um tween nesta timeline no deslocamento correto.
  • window.__timelines["<composition-id>"] = tl; registra a timeline com o tempo de execução do HF.

Subcomponentes React personalizados são incorporados como HTML repetido usando a interface de props como modelo (veja parameters.md para o padrão data-* por instância).

Etapa 4: Valide

Execute o harness de avaliação — references/eval.md para o guia completo. Caminho rápido:

# Renderizar linha de base Remotion (após npm install na fixture)
cd remotion-src && npx remotion render <CompositionId> out/baseline.mp4

# Renderizar tradução HF
cd ../hf-src && npx hyperframes render --output ../hf.mp4

# Diff SSIM
../../scripts/render_diff.sh ./remotion-src/out/baseline.mp4 ./hf.mp4 ./diff

Limiar: ~0,02 abaixo do p05 do nível de complexidade da fonte (veja a tabela de limites validados em eval.md). Se o diff falhar, execute scripts/frame_strip.sh para ver quais quadros divergiram, depois releia a referência de temporização/sequenciamento/mídia relevante.

Crítico: ambas as renderizações devem usar formato de pixel correspondente. Defina Config.setVideoImageFormat("png") + Config.setColorSpace("bt709") no remotion.config.ts da fonte Remotion — caso contrário, o diff mede diferenças do codificador (~0,05 de impacto SSIM), não a fidelidade da tradução.

Etapa 5: Documente lacunas

Qualquer coisa que não tenha sido traduzida de forma limpa (rampas de volume removidas, apresentações personalizadas aproximadas, fontes substituídas) recebe um TRANSLATION_NOTES.md escrito ao lado da saída HF. Veja references/limitations.md para o formato.

O que esta skill explicitamente NÃO faz

  • Traduzir máquinas de estado React. Composições que conduzem animação via useState + useEffect não são alvos determinísticos de captura de quadros no modelo orientado a busca do HyperFrames. Recomende o padrão de interoperabilidade em tempo de execução.
  • Executar o pipeline de renderização do Remotion junto com o HyperFrames. Esse é o padrão de interoperabilidade em tempo de execução do PR #214 — uma solução separada para composições que falham no lint desta skill.

(@remotion/lambda não é um bloqueador — a configuração Lambda é implantação, não animação. A skill o remove como um aviso e traduz o restante. Veja references/escape-hatch.md.)

Como avaliar sua própria tradução

Execute o orquestrador do corpus de teste:

./assets/test-corpus/run.sh

Ele executa T1, T2, T3 (renderizar + diff) e T4 (validação de lint), imprime uma tabela de passou/falhou por nível e emite um relatório JSON agregado. Use isso para verificar se a skill está funcionando de ponta a ponta em uma instalação limpa — e como uma verificação de regressão após editar qualquer referência.

Linha de base validada (em 27/04/2026):

NívelForma da composiçãoSSIM MédioLimiar
T1fade-in de elemento único0,9740,95
T2múltiplas cenas + spring + áudio + imagem0,9850,95
T3baseado em dados, subcomponentes personalizados, contagem0,9530,90
T4escape-hatch (8 casos de lint)8/8 passamn/a

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

libz-renlab-ai/TeamBrain

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

libz-renlab-ai/TeamBrain

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

libz-renlab-ai/TeamBrain

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

libz-renlab-ai/TeamBrain

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

libz-renlab-ai/TeamBrain

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

Habilidades Relacionadas