Communitygithub.com

delorenj/skills

Traduza uma composição de vídeo Remotion (baseada em React) para uma composição HTML HyperFrames. Use SOMENTE quando o usuário pedir explicitamente para portar, converter, migrar, traduzir ou reescrever uma composição Remotion como HyperFrames (ex.: "portar meu projeto Remotion para HyperFrames").

O que é skills?

Esta skill realiza a tradução mecânica de composições de vídeo Remotion (baseadas em React) para o formato HyperFrames (HTML + GSAP), cobrindo aproximadamente 80% dos padrões típicos. Ela é projetada para ser usada exclusivamente quando o usuário solicita explicitamente a migração de um projeto Remotion para HyperFrames, evitando traduções em contextos de criação nova, menção casual ou referência de código. A skill detecta padrões não suportados — como `useState`, `useEffect` com efeitos colaterais, `calculateMetadata` assíncrono, bibliotecas de componentes React de terceiros e `@remotion/lambda` — e em vez de realizar uma tradução de baixa fidelidade, recomenda o uso do padrão de interoperação descrito no PR #214. Para garantir a precisão, a skill inclui um corpus de teste em níveis (T1–T4) que valida as traduções contra métricas de SSIM, exigindo que a renderização do baseline Remotion e da tradução HyperFrames usem o mesmo formato de pixel. Finalmente, qualquer lacuna na tradução é documentada em `TRANSLATION_NOTES.md`, e o fluxo de trabalho envolve lint do código-fonte, planejamento com referências específicas, geração da composição HTML, validação e documentação de discrepâncias.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/delorenj/skills/tree/HEAD/remotion-to-hyperframes

Perguntar na sua IA favorita

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

Documentação

Remotion para HyperFrames

Visão Geral

Traduza composições de vídeo Remotion (baseadas em React) para 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% de baixa fidelidade, recusando-se a traduzir padrões que não se encaixam no modelo orientado a seek do HF e recomendando o padrão de interoperação em tempo de execução do PR #214.

A skill acompanha um corpus de teste em níveis (T1–T4, 4 fixtures no total) que classifica 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 com SSIM 0,05 menor que o baseline validado está silenciosamente errada.

Quando Usar

Use esta skill SOMENTE quando o usuário pedir explicitamente para migrar do Remotion. Exemplos de frases de gatilho:

  • "portar meu projeto Remotion para HyperFrames"
  • "converter este código Remotion para HyperFrames"
  • "migrar do Remotion"
  • "traduzir esta composição Remotion"
  • "reescrever isto como HTML HyperFrames"

NÃO use esta skill quando:

  • (a) O usuário estiver criando uma nova composição HyperFrames, mesmo que tenha ou esteja testando A/B um vídeo Remotion semelhante.
  • (b) O usuário mencionar o Remotion de passagem sem pedir migração.
  • (c) O usuário compartilhar código Remotion como material de referência, e não pedir uma tradução.
  • (d) O usuário pedir "o mesmo vídeo que o meu Remotion" sem pedir explicitamente para migrar a fonte — trate como uma nova composição HyperFrames.

Em caso de dúvida, opte por criar uma composição HyperFrames nativa com a skill hyperframes.

Fluxo de Trabalho

Passo 1: Lint da Fonte

Execute scripts/lint_source.py sobre o diretório fonte do Remotion. O lint detecta padrões que não podem ser traduzidos limpidamente:

  • Bloqueadores (recusar + recomendar interoperação): 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 (traduzir após descartar o construto): configuração @remotion/lambda, delayRender, useCallback, useMemo, hooks personalizados.
  • Informações (traduzir com nota): staticFile, interpolateColors.

Se algum bloqueador for acionado, pare. Leia references/escape-hatch.md e exiba a mensagem de recomendação. Avisos não interrompem a tradução — descarte o construto ofensivo no passo 3 e anote a lacuna em TRANSLATION_NOTES.md. A configuração @remotion/lambda é o caso canônico de aviso: a skill descarta a importação + chamadas renderMediaOnLambda(...), mas traduz o resto da composição.

Passo 2: Planejar a Tradução

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

A 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 todas — carregue apenas o que a fonte específica precisar.

Passo 3: Gerar a Composição HF

Emita index.html com:

  • Raiz <div id="stage"> contendo data-composition-id, 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}). 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 runtime 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).

Passo 4: Validar

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

# Renderizar baseline 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

# Diferença 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 limiares validados em eval.md). Se a diferença falhar, execute scripts/frame_strip.sh para ver quais quadros divergiram, depois releia a referência relevante de timing/sequenciamento/mídia.

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

Passo 5: Documentar Lacunas

Qualquer coisa que não tenha sido traduzida limpidamente (rampas de volume descartadas, apresentações personalizadas aproximadas, fontes substituídas) gera um arquivo TRANSLATION_NOTES.md 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 acionam animação via useState + useEffect não são alvos determinísticos de captura de quadro no modelo orientado a seek do HyperFrames. Recomende o padrão de interoperação em tempo de execução.
  • Executar o pipeline de renderização do Remotion junto com HyperFrames. Esse é o padrão de interoperação 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 descarta como aviso e traduz o resto. 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 + diferença) e T4 (validação de lint), imprime uma tabela de aprovado/reprovado por nível e emite um relatório JSON agregado. Use isso para verificar se a skill está funcionando de ponta a ponta em um checkout limpo — e como verificação de regressão após editar qualquer referência.

Baseline validado (a partir de 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
T3orientado a dados, subcomponentes personalizados, contagem0,9530,90
T4escape-hatch (8 casos de lint)8/8 aprov.n/a

Individual skills in this repo

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

delorenj/skills

Plan and generate terminal ASCII animations/screensaver-style output (FPS, refresh rules, loop policy, low-flicker guidance), with a static poster frame and an optional local demo script.

delorenj/skills

ASCII video: convert video/audio to colored ASCII MP4/GIF.

delorenj/skills

Plan, build and quality-check a premium short commercial for a real business (roofing, property, ecommerce, B2B software) using AI-generated footage, code-built motion (HTML/GSAP), selective Three.js and an independent-critic "Gauntlet" loop. Use when asked to make a launch-style / SaaS-style video, business ad, explainer, sample reel or pitch video, or to review and improve one. Encodes motion principles distilled from 28 professional launch films, a quality bar, audio rules and a business-offer playbook.

delorenj/skills

CSS animation adapter patterns for HyperFrames. Use when authoring CSS keyframes, animation-delay based timing, animation-fill-mode, animation-play-state, or CSS-only motion that HyperFrames must seek deterministically during preview and rendering.

delorenj/skills

Generate professional voiceovers using ElevenLabs AI. Use when the user needs to create voiceovers for videos, audio narration, or text-to-speech content. Supports multiple voices with character presets (narrator, salesperson, expert) for natural delivery. Includes single scene regeneration for fine-tuning.

delorenj/skills

HyperFrames CLI dev loop — `npx hyperframes` for scaffolding (init), validation (lint, inspect), preview, render, and environment troubleshooting (doctor, browser, info, upgrade). Use when running any of these commands or troubleshooting the HyperFrames build/render environment. For asset preprocessing commands (`tts`, `transcribe`, `remove-background`), invoke the `hyperframes-media` skill instead.

delorenj/skills

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.

delorenj/skills

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.

delorenj/skills

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 dev-loop CLI commands (init, lint, inspect, preview, render) see the hyperframes-cli skill; for asset preprocessing commands (tts, transcribe, remove-background) see the hyperframes-media skill.

delorenj/skills

Manim CE animations: 3Blue1Brown math/algo videos.

delorenj/skills

Join a Google Meet or Zoom call as a video meeting agent via PikaStreaming. Trigger: user drops a Google Meet or Zoom link, or asks to join a meeting.

delorenj/skills

Generate speech using the self-hosted voxxy (vox) TTS service at https://vox.delo.sh. Use when the user asks to speak, say, narrate, synthesize speech, clone a voice, create a voice, add or register a voice, pipe TTS, or control voice qualities by description (e.g. "a young woman with a cheerful voice"). Handles HTTP API usage, voice profile management, description-based voice design, cloning, MCP registration, and integration patterns for new platforms.

delorenj/skills

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.

delorenj/skills

YouTube transcripts to summaries, threads, blogs.

Habilidades Relacionadas