Communitygithub.com

Biznomad/claude-skills

Traduzir uma composição de vídeo Remotion (baseada em React) para uma composição HTML HyperFrames. Use SOMENTE quando o usuário solicitar explicitamente portar, converter, migrar, traduzir ou reescrever uma composição Remotion como HyperFrames (ex.: "portar meu projeto Remotion para HyperFrames"). Não use quando (a) estiver criando uma NOVA composição HyperFrames (mesmo que para teste A/B com um vídeo Remotion); (b) Remotion for mencionado de passagem; (c) código Remotion for compartilhado como referência, não para tradução; (d) o usuário quiser "o mesmo vídeo do meu Remotion" sem pedir explicitamente para migrar o código-fonte — trate como uma nova construção HyperFrames. Em caso de dúvida, use a skill `hyperframes`. Detecta padrões não suportados (useState, efeitos colaterais de useEffect, calculateMetadata assíncrono, bibliotecas de componentes React de terceiros, `@remotion/lambda`) e recomenda o escape hatch de interoperação em tempo de execução em vez de uma tradução com perdas.

O que é claude-skills?

A skill Biznomad/claude-skills traduz composições de vídeo criadas com Remotion (baseado em React) para HyperFrames (HTML + GSAP). Ela é ativada apenas quando o usuário solicita explicitamente a migração ou conversão de um projeto Remotion para HyperFrames, evitando uso em cenários como criação de novas composições HyperFrames ou menção casual do Remotion. A skill inclui um processo de linting que identifica padrões que não podem ser traduzidos diretamente (como `useState`, efeitos colaterais de `useEffect`, `@remotion/lambda`, etc.) e recomenda um escape hatch de interoperação em tempo de execução para esses casos. O fluxo de trabalho envolve cinco etapas: lint do código-fonte Remotion, planejamento da tradução com base em um mapa de APIs, geração da composição HyperFrames com HTML e GSAP, validação com um corpus de teste que mede SSIM e documentação de lacunas. A skill é suportada por referências detalhadas para parâmetros, sequenciamento, timing, mídia, transições, Lottie e fontes, garantindo uma tradução mecânica para cerca de 80% das composições típicas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Biznomad/claude-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

Traduzir 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% com perdas, recusando-se a traduzir padrões que não se encaixam no modelo orientado por busca do HF e recomendando o padrão de interoperação 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 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 SOMENTE quando o usuário solicitar explicitamente a migração 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 HyperFrames HTML"

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 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 do meu Remotion" sem solicitar explicitamente a migração do código-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: Lint do código-fonte

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

  • 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 apresente a mensagem de recomendação. Avisos não interrompem a tradução — descarte o construto problemático 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 restante 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 o código-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 — carregue apenas o que o código-fonte específico precisar.

Passo 3: Gerar a composição HF

Emita index.html com:

  • Div raiz <div id="stage"> carregando o 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}) 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 com o runtime do HF.

Subcomponentes React personalizados são embutidos 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 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 da camada de complexidade da fonte (veja a tabela de limiares validados em eval.md). Se o diff 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 remotion.config.ts da fonte Remotion — caso contrário, o diff mede diferenças de codificador (~0.05 de impacto SSIM), não fidelidade da tradução.

Passo 5: Documentar lacunas

Qualquer coisa que não tenha sido traduzida de forma limpa (ramos de volume descartados, 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 por busca 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 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 aprovação/reprovação por camada 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.

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

CamadaForma da composiçãoSSIM MédioLimiar
T1fade-in de elemento único0.9740.95
T2multi-cena + spring + áudio + imagem0.9850.95
T3orientado a dados, subcomponentes personalizados, contagem-regressiva0.9530.90
T4escape hatch (8 casos de lint)8/8 aprovn/a

Individual skills in this repo

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

Biznomad/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-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/claude-skills

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

Biznomad/claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

Biznomad/claude-skills

为 Seedance 2.0(Higgsfield)生成电影级胶片风格视频提示词。在用户想要电影级、胶片感、电影质量、好莱坞风格、戏剧性或专业胶片质量的AI视频时使用。触发词:电影级、胶片感、电影场景、戏剧性打光、景深、镜头光晕、变形、信箱式、黑色电影、史诗、稳定摄像机、推车镜头、吊臂镜头或任何电影级视频生成请求。即使用户没有明确说"电影级"但描述了胶片美学,也要使用此技能。

Biznomad/claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

Biznomad/claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

Biznomad/claude-skills

Build, redesign, and deploy websites across any stack — static HTML, Next.js, Astro, or Shopify Liquid themes. Handles design systems, brand-aware layouts, component architecture, and deployment pipelines (Netlify, Vercel, Shopify API). Use when asked to build a website, redesign a site, create a landing page, build a web app, create Shopify sections/templates, or deploy web projects. Triggers on requests like "build me a website", "redesign this page", "create a landing page", "build a Shopify theme", "deploy to Netlify".

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

Habilidades Relacionadas