Communitygithub.com

Biznomad/agent-skills

Traduz uma composição de vídeo Remotion (baseada em React) para uma composição HTML HyperFrames. Use APENAS 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 é agent-skills?

Esta skill realiza a tradução sistemática de composições de vídeo baseadas em React do Remotion para o formato HTML + GSAP do HyperFrames. Cerca de 80% das composições típicas do Remotion possuem equivalentes diretos no HyperFrames e a tradução é mecânica. A skill identifica padrões que não podem ser convertidos de forma limpa, como useState, useEffect com dependências, calculateMetadata assíncrono e bibliotecas de componentes React de terceiros, e recomenda o padrão de interop de runtime, em vez de uma tradução perdedora. A skill inclui um corpus de teste escalonado (T1–T4) para validar as traduções com base em limites de SSIM medidos, garantindo que a saída renderizada corresponda à linha de base Remotion. Funciona principalmente em ambientes onde o usuário explicitamente solicita a migração de um projeto Remotion existente, diferenciando de casos onde o usuário está criando uma nova composição HyperFrames ou menciona Remotion de passagem. O fluxo de trabalho inclui linting do código-fonte, planejamento da tradução com base em referências, geração do HTML/JS da composição, validação via renderização e diff, e documentação de lacunas de tradução.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/agent-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 (baseado 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% com perda, recusando-se a traduzir padrões que não se encaixam no modelo orientado por seek do HF e recomendando o padrão de interop de runtime do PR #214.

A skill é acompanhada por um corpus de teste escalonado (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 certa", mas renderiza 0,05 SSIM abaixo da linha de base validada, está silenciosamente errada.

Quando usar

Use esta skill APENAS 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 comp Remotion"
  • "reescrever isto como HTML HyperFrames"

NÃO use esta skill quando:

  • (a) O usuário está criando uma nova composição HyperFrames, mesmo que tenha ou esteja testando A/B com um vídeo Remotion semelhante.
  • (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 a fonte — trate como uma nova construção HyperFrames.

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

Fluxo de Trabalho

Passo 1: Linter do código-fonte

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

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

Se algum bloqueador for acionado, pare. Leia references/escape-hatch.md e exiba a mensagem de recomendação. Os 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 de aviso canônico: a skill descarta a importação + chamadas renderMediaOnLambda(...) mas traduz o resto da composição.

Passo 2: Planeje 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:

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 a fonte específica precisa.

Passo 3: Gere a composição HF

Emita index.html com:

  • <div id="stage"> raiz carregando os data-composition-id, data-start="0", data-duration (em segundos), data-fps, data-width, data-height da composição, 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. Cada derivação de useCurrentFrame() do Remotion se torna um tween nesta timeline no deslocamento correto.
  • window.__timelines["<composition-id>"] = tl; registra a timeline no runtime do HF.

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

Passo 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 timing/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 de codificador (~0,05 SSIM), não fidelidade de tradução.

Passo 5: Documente lacunas

Qualquer coisa que não foi traduzida de forma limpa (rampas de volume descartadas, 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 dirigem animação via useState + useEffect não são alvos de captura de quadro determinísticos no modelo orientado por seek do HyperFrames. Recomende o padrão de interop de runtime.
  • Executar o pipeline de renderização do Remotion junto com HyperFrames. Esse é o padrão de interop de runtime do PR #214 — uma solução separada para composições que falham no linter 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 (render + diff) e T4 (validação de linter), imprime uma tabela de aprovado/reprovado por nível e emite um relatório JSON agregado. Use isto para verificar se a skill está funcionando de ponta a ponta em uma cópia limpa — e como verificação de regressão após editar qualquer referência.

Linha de base validada (atualizado em 2026-04-27):

NívelForma da composiçãoSSIM MédioLimiar
T1fade-in de elemento único0,9740,95
T2multi-cena + spring + áudio + imagem0,9850,95
T3baseada em dados, subcomponentes personalizados, contagem0,9530,90
T4escape-hatch (8 casos de linter)8/8 passn/a

Individual skills in this repo

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

Biznomad/agent-skills

Landing page quality assessment for paid advertising campaigns. Evaluates message match, page speed, mobile experience, trust signals, form optimization, and conversion rate potential. Use when user says "landing page", "post-click experience", "landing page audit", "conversion rate", or "landing page optimization".

Biznomad/agent-skills

TikTok Ads deep analysis covering creative quality, tracking, bidding, campaign structure, and TikTok Shop. Evaluates 25 checks with emphasis on creative-first strategy, safe zone compliance, and Smart+ campaigns. Use when user says "TikTok Ads", "TikTok marketing", "TikTok Shop", "Spark Ads", "Smart+", or "TikTok campaign".

Biznomad/agent-skills

YouTube Ads specific analysis covering campaign types, creative quality, audience targeting, and measurement. Evaluates video ad performance across skippable, non-skippable, bumper, Shorts, and Demand Gen formats. Use when user says "YouTube Ads", "video ads", "pre-roll", "bumper ads", "YouTube campaign", or "Shorts ads".

Biznomad/agent-skills

Help users get promoted at work. Use when someone is preparing for a promotion conversation, building their case for advancement, trying to understand what's blocking their promotion, or figuring out how to get to the next level in their career.

Biznomad/agent-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.

Biznomad/agent-skills

Video and audio processing with FFmpeg. Use for format conversion, resizing, compression, audio extraction, and preparing assets for Remotion. Triggers include converting GIF to MP4, resizing video, extracting audio, compressing files, or any media transformation task.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. Shows which VERSION slots are currently claimed by open PRs, which sibling Conductor workspaces have WIP work likely to ship soon, and what slot /ship would pick next. No mutations — just a snapshot. Use when asked to "landing report", "what's in the queue", "show me open PRs", or "which version do I claim next". (gstack)

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-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.

Biznomad/agent-skills

Still-to-video conversion guide: model selection, motion prompting, and camera movement. Covers Wan 2.5 i2v, Seedance, Fabric, Grok Video with when to use each. Use for: animating images, creating video from stills, adding motion, product animations. Triggers: image to video, i2v, animate image, still to video, add motion to image, image animation, photo to video, animate still, wan i2v, image2video, bring image to life, animate photo, motion from image

Biznomad/agent-skills

>- The Landing Page Audit skill performs comprehensive evaluations of post-click experiences, combining technical performance analysis with conversion rate optimization (CRO) assessment.

Biznomad/agent-skills

Write high-converting landing page copy using proven frameworks like PAS (Problem-Agitate-Solution), AIDA, and StoryBrand. Creates headlines, value propositions, CTAs, and full page sections optimized for conversion. Use when users need landing page copy, sales page content, or marketing website text.

Biznomad/agent-skills

Optimize landing pages for higher conversion rates using proven frameworks and design patterns. Use when designing, reviewing, or improving landing pages, hero sections, pricing pages, CTAs, or when the user asks about conversion optimization.

Biznomad/agent-skills

Read-only queue dashboard for workspace-aware ship. (gstack)

Biznomad/agent-skills

Building promotion cases, brag documents, tracking wins, and self-advocacy for career advancement. Use when preparing for promotions, documenting accomplishments, or building your case for advancement.

Biznomad/agent-skills

Best practices for Remotion - Video creation in React

Biznomad/agent-skills

Produce programmable videos with Remotion using scene planning, asset orchestration, and validation gates for automated, brand-consistent video content.

Biznomad/agent-skills

Reviews animation and motion code against a high craft bar derived from Emil Kowalski's design engineering philosophy. Default to flagging; approval is earned.

Habilidades Relacionadas