Communitygithub.com

laviedezidane/hyperframes-skill

Importe conteúdo do Figma em uma composição HyperFrames — assets renderizados, tokens de marca, componentes, seções de storyboard → movimento reconstruído (quadros lidos como estados, não slides) via REST/CLI, movimento assistido por conector quando disponível, e shaders de um conector ou exportação nativa. Use quando o usuário colar um link figma.com ou pedir para trazer um design, quadro, logotipo, marca ou animação do Figma para um vídeo/composição.

O que é hyperframes-skill?

Esta skill conecta o Figma ao HyperFrames, permitindo que agentes de IA (como Claude Code ou Cursor) importem automaticamente designs, tokens de marca, componentes, animações e shaders do Figma para composições de vídeo. Ela usa uma abordagem em cinco fases, priorizando chamadas REST para assets estáticos, tokens e componentes (garantindo reprodutibilidade local), enquanto oferece suporte a conectores opcionais para movimento (GSAP) e shaders. A autenticação é feita via token pessoal do Figma com escopo somente leitura, e a skill gerencia limites de taxa automaticamente. Para storyboards, a skill interpreta quadros como keyframes de animação (não slides estáticos), reconstruindo linhas do tempo de elementos a partir de diferenças entre quadros adjacentes. A validação rigorosa contra a saída real do Figma (comparação de pixels) é obrigatória para assets hero e movimento, garantindo fidelidade visual.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/laviedezidane/hyperframes-skill/tree/HEAD/.agents/skills/figma

Perguntar na sua IA favorita

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

Documentação

Instalação do Plugin: Antes dos comandos de configuração ou atualização, siga as regras de execução do plugin quando esta skill estiver dentro de um plugin HyperFrames. Instalações independentes mantêm as instruções de atualização abaixo.

Primeiro, mantenha esta skill atualizada — confirme com o usuário antes de executar: npx hyperframes skills update figma. Uma operação rápida quando tudo está atualizado; caso contrário, atualiza esta skill e as skills de domínio principais das quais ela depende antes de você confiar nelas.

Figma → HyperFrames

Traga o trabalho do Figma do usuário para uma composição. Dividido por capacidade (especificação de design §2):

FaseO quêTransporteSuperfície
1Assets estáticosRESThyperframes figma asset
2Tokens/estilos de marcaRESThyperframes figma tokens
3Componentes → HTMLRESThyperframes figma component
4Movimento → GSAPconector quando disponíveluse seu contexto de movimento
5Shadersconector / exportação manualuse-o ou uma exportação nativa

REST é usado sempre que possível (utilizável em volume, headless). Um conector Figma compatível é opcional para dados de movimento e shaders; sem um, peça uma exportação nativa. Todos os caminhos congelam assets localmente para que as renderizações permaneçam determinísticas. Reconstruções de storyboard compõem exportações de assets da Fase 1 (REST) com montagem de linha do tempo orientada por agente — nenhum conector necessário. Assets congelados existentes, registros de manifesto e ligações não são afetados por mudanças de roteamento — a divisão apenas altera qual credencial a próxima importação usará.

Autenticação — duas credenciais, com escopo

Verificação prévia — antes da primeira chamada CLI, verifique se existe um token: shell env ([ -n "$FIGMA_TOKEN" ]) ou o .env do projeto (a CLI carrega automaticamente — uma entrada .env conta como configurado). Se nenhum, NÃO execute o comando para obter o erro — oriente o usuário na configuração inicial primeiro, então pare e aguarde:

  1. figma.com/settings → Segurança → Tokens de acesso pessoal → Gerar novo token.
  2. Escopos — somente leitura é tudo que esta integração precisa (ela nunca escreve no Figma): Conteúdo do arquivo: Somente leitura + Metadados do arquivo: Somente leitura. Adicione Conteúdo da biblioteca: Somente leitura se você executar tokens em um plano não Enterprise — o fallback de estilos publicados acessa /v1/files/:key/styles, que retorna 403 sem isso (um escopo que o texto de configuração mais antigo omitia). Opcionalmente Variáveis: Somente leitura para variáveis de marca — exclusivo Enterprise; sem isso, tokens degrada para estilos publicados automaticamente (esperado, não é um erro — informe isso). Um 403 agora nomeia o escopo exato ausente; 429s tentam novamente automaticamente (limite por minuto, respeita Retry-After).
  3. Peça ao usuário para definir FIGMA_TOKEN no perfil do shell ou .env do projeto; nunca peça para colar o token na conversa.

Durante a integração, também estabeleça expectativas de uma só vez: cada importação termina como um arquivo local congelado com proveniência registrada — as renderizações nunca chamam o Figma, reexecutar um comando reimporta apenas o que mudou no Figma, e um token funciona para assets, tokens de marca e componentes em todos os arquivos que a conta Figma do usuário pode visualizar.

  • Fases 4–5 (movimento/shaders): um conector Figma compatível, com autorização separada do token. Se estiver indisponível ou não autenticado, peça ao usuário para conectá-lo ou fornecer uma exportação nativa, então pare.
  • Diga exatamente qual credencial uma fase com falha precisa — nunca apresente a divisão como quebrada.
  • BAD_TOKEN (401) no meio do fluxo → o token expirou/foi revogado; gere novamente. FORBIDDEN (403) → a mensagem nomeia o escopo exato ausente (ex.: library_content:read para o fallback de estilos) — adicione-o, ou o arquivo não está visível para a conta. REQUIRES_ENTERPRISE (403 em variáveis) → não é uma falha: o fallback de estilos já foi executado. RATE_LIMITED (429) → o cliente já tentou novamente com backoff (isso se aplica a TODAS as leituras — assets, tokens, estilos, árvores de nós, versões — a repetição reside no caminho de requisição compartilhado; Retry-After é respeitado, limitado a 60s); se ainda assim surgir, aguarde um minuto ou importe menos nós por chamada.

Consciência de limite de taxa (especificação §2.1): as cotas do conector variam por plano Figma — agrupe requisições de quadros pai, evite capturas de tela de verificação a menos que solicitado e armazene em cache respostas brutas para que uma rederivação nunca gaste uma segunda chamada. REST é por minuto (10+/min, buckets por endpoint) — ok em volume, faça backoff em 429.

Roteamento

Analise o link figma do usuário com parseFigmaRef (URL, fileKey:nodeId, fileKey simples). Então, por intenção:

  • "use esta camada / logotipo / imagem" → Asset (CLI)
  • "puxe minha marca / cores / tokens" → Tokens (CLI)
  • "construa uma cena a partir deste quadro" → Componente (CLI)
  • "importe esta animação / movimento" → Movimento (conector quando disponível, abaixo)
  • uma seção de storyboard / tira de quadros de cena → Storyboard (abaixo)
  • preenchimento/efeito de shader → Shaders (abaixo)

Narre cada etapa para o usuário — antes de cada comando, diga o que você está prestes a puxar do Figma; depois, diga onde o artefato foi parar (o caminho congelado / sidecar / diretório do componente), o que mudou na composição e a próxima ação imediata (visualizar, adicionar variáveis impressas, reimportar para vincular ligações). O usuário nunca deve precisar perguntar "funcionou?" ou "e agora?".

Assets (Fase 1 — CLI)

hyperframes figma asset '<url-ou-fileKey:nodeId>' [mais refs…] [--format svg|png|jpg|pdf] [--scale 2] [--description "..."] [--entity "..."]

Renderiza via REST, sanitiza SVG, congela em .media/images/, anexa ao manifesto com proveniência, regenera .media/index.md (o inventário de uso de mídia compartilhado), imprime um trecho <img>. Idempotente por fileKey:nodeId:format:scale:version. Prefira SVG para vetores/logotipos (escalável, animável), PNG --scale 2 para fidelidade raster. Sempre passe --description "<o que é>" (torna-se a linha do índice + <img alt>); adicione --entity "<nome>" para marcas nomeadas para que a resolução de media-use as encontre depois (correspondências de entidade funcionam em imagem/ícone).

Agrupe vários nós em UMA requisição — passe várias refs (separadas por espaço ou vírgula) do MESMO arquivo: hyperframes figma asset 'KEY:1-2' 'KEY:3-4' 'KEY:5-6'. Todas são renderizadas em uma única chamada /v1/images, que é a própria resposta do Figma ao limite de taxa por minuto — prefira isso a N comandos separados ao puxar assets de um quadro inteiro. --description/--entity se aplicam a cada nó no lote, então agrupe nós que compartilham um propósito. 429s também tentam novamente automaticamente com backoff.

Tokens (Fase 2 — CLI)

hyperframes figma tokens <fileKey>

Importa variáveis como entradas de variáveis de marca da composição + sidecar figma-tokens.json + registros de índice de ligação (.media/figma-bindings.jsonl). Variáveis são controladas pelo Enterprise upstream: em outros planos, o comando degrada para metadados de estilo publicado (os valores são resolvidos no momento da importação do componente). Adicione as entradas impressas ao data-composition-variables da composição.

Importe tokens antes dos componentes quando ambos são desejados — é isso que permite que as cores do componente se liguem a variáveis de marca em vez de criar duplicatas.

Caminho de variáveis não Enterprise (testado em campo): Variáveis REST são controladas pelo Enterprise, mas um conector compatível pode fornecer definições de variáveis. Quando tokens relatar REQUIRES_ENTERPRISE e o conector estiver disponível, recupere as variáveis da cena pai uma vez, armazene em cache a resposta bruta para .media/figma-cache/ e use-a para construir o índice de ligação. O boundVariables da árvore de nós REST fornece VariableIDs por propriedade; junte-os por nó e propriedade, então escreva linhas .media/figma-bindings.jsonl ({kind:"binding", figmaId, sourceFileKey, compositionVariableId:"figma:<nome>", version}) mais as entradas de variáveis de composição. Tudo a jusante (resolução var() do componente, atualização, variáveis CSS em tempo de execução) é a maquinaria fornecida. Rotule para o usuário: "tokens via conector Figma — planos Enterprise obtêm isso diretamente de hyperframes figma tokens."

O runtime declara cada variável de composição declarada como uma propriedade personalizada CSS (raiz do documento + hosts de subcomponentes), então o var(--slug, literal) importado preenche a recolorização quando o padrão da variável muda — atualizar um valor em data-composition-variables remarca cada componente importado sem reimportar nada. hyperframes render --variables '<json>' os substitui no momento da renderização.

Componentes (Fase 3 — CLI)

hyperframes figma component '<url-ou-fileKey:nodeId>'

Árvore de nós → HTML editável na geometria exata do Figma, empacotado como um item de registro em compositions/components/<nome>/. Vetores/operações booleanas são auto-rasterizados via exportação da Fase 1. Passagem de ligação (especificação §7.1, apenas ID exato — nunca correspondência de valor):

  • Auto-verificação de fidelidade estática (obrigatória para conteúdo hero): após importar, renderize o fragmento e compare com os pixels reais do Figma — figma asset <mesmo node> --format png é a verdade absoluta. Texto é o eixo de deriva conhecido: uma caixa de texto do Figma mais curta que sua altura de linha tem limites com corte vertical (o mapeador emite text-box-trim para estes; a deriva medida sem isso era ~6px em uma fonte de 70px). Se a comparação mostrar deriva que o mapeador não cobre, relate — não ajuste manualmente o fragmento silenciosamente.
  • Preenchimento vinculado a um token importado → var(--slug, #literal) — a atualização de marca se propaga.
  • Vinculado a um token desconhecido → literal + flag data-figma-unresolved. O comando informa; ofereça ao usuário: execute tokens no arquivo de origem (ou biblioteca), então reimporte o componente para vinculá-los. Pergunte uma vez por biblioteca desconhecida qual arquivo é — nunca adivinhe, nunca corresponda por hex.

Movimento (Fase 4 — assistido por conector)

Beacon de uso: As fases assistidas por conector não têm ponto de contato CLI, então dispare o beacon da skill no início e no fim (anônimo, com consentimento, nunca falha): npx hyperframes events --skill=figma-motion quando começar, npx hyperframes events --skill=figma-motion --event=skill_completed --outcome=success|error quando terminar. O mesmo para shaders (figma-shaders) e storyboards (figma-storyboard).

Não existe equivalente REST. Quando um conector compatível estiver disponível, use-o e entregue sua saída aos helpers puros em @hyperframes/core/figma; caso contrário, peça uma exportação nativa:

  1. Recupere o contexto de movimento para o quadro pai em uma requisição recursiva, não uma requisição por elemento. Salve o JSON bruto ao lado do projeto (.media/figma-cache/) para que a retradução seja gratuita.
  2. Normalize em MotionDocs com motionContextToDocs(rawResponse, { selectorFor, repeat }) de @hyperframes/core/figma — nunca transcreva números de keyframe manualmente. O helper codifica as regras de decodificação testadas em campo mecanicamente: ele analisa os trechos motion.dev (a codificação confiável — os trechos CSS alongam durações e podem discordar; eles são ignorados), remove keyframes finais de loop wrap (segmentos de submilissegundo em tempos ≈0.9999→1 são o reset instantâneo do loop, não movimento criado — o wrap é realizado pelo reinício de repeat), e preserva eases bezier verbatim. selectorFor deve retornar os ids da importação do componente da Fase 3 — não derive seletores de nomes de nós. 2b. Valide contra a verdade absoluta antes de considerar concluído — obrigatório: exporte o quadro raiz da coorte através do conector disponível e execute node <SKILL_DIR>/scripts/verify-motion.mjs --reference <export.mp4> --render <render.mp4> --crop WxH+X+Y — ele compara deltas de energia de movimento (a fidelidade da importação estática se anula) e falha abaixo de 15dB de PSNR de movimento mínimo (calibrado: fiel ≈ 20+, divergente ≈ 5). Meça --crop a partir das bordas reais do cartão na renderização, não adivinhe. FALHA significa verificar a tradução, não o limite.
  3. motionToGsap(doc) → emitTimelineScript(spec) → injete como um <script> após as tags CDN do GSAP + CustomEase. Pausado, finito, registrado em window.__timelines com uma chave literal.
  4. Faixa intraduzível (orientada a shader, propriedade não suportada, máscaras complexas) → exporte através do conector, congele o MP4, então incorpore como <video class="clip">. Exceção: faixas orientadas a shader — o caminho de exportação do Figma achata shaders para a cor base (veja Shaders abaixo), então uma gravação lá perde silenciosamente o shader; peça ao usuário uma exportação Figma nativa. Sempre diga qual caminho você usou e por quê. Eases nomeadas fora do conjunto mapeado voltam para linear — a tabela de mapeamento está em motionEase.ts; sinalize o fallback ao usuário quando ocorrer.
  5. Execute npx hyperframes check antes de considerar concluído.

Shaders (Fase 5 — principalmente manual)

O caminho de renderização do conector do Figma não executa shaders (eles são achatados para a cor base), e a origem do shader só é acessível para estilos publicados em biblioteca (assento Full pago). Caminho padrão: peça ao usuário para exportar o quadro do shader nativamente no Figma (PNG ou MP4 de movimento), então importe como um asset da Fase 1 / clipe. Não tente captura de pixel do conector de um shader — isso produzirá silenciosamente a coisa errada.

Storyboards (uma SEÇÃO de quadros de cena → animação)

A regra cardinal: quadros de storyboard são KEYFRAMES, não slides. Dois quadros contendo o mesmo elemento descrevem o estado desse elemento ao longo do tempo — anime o ELEMENTO entre os estados; nunca reproduza os quadros como uma sequência de imagens estáticas. Um logotipo desenhado em quatro quadros consecutivos em y decrescente é UM elemento subindo através de quatro keyframes. Reproduzir quadros de storyboard um após o outro é o modo de falha; reconstruir as linhas do tempo dos elementos que eles implicam é o trabalho.

Os arquivos de storyboard seguem uma gramática que você pode analisar mecanicamente — não veja a olho nu, decodifique:

  1. Unidades de cena: dentro da SEÇÃO, todo nó do tamanho de um quadro é uma cena — tanto FRAMEs nomeados quanto RECTANGLEs soltos de quadro inteiro (designers colam imagens estáticas diretamente na seção). Filtre por tamanho (≈ proporção da composição, ex.: >1400×900), não por tipo ou nome de nó.
  2. Ordem = posição x (linha principal se a tira quebrar). Ordene as cenas por absoluteBoundingBox.x.
  3. Diferença entre adjacentes: emparelhe cenas ordenadas e faça diff dos IDs das subárvores — a árvore de nós não é renderizada, apenas analisada estruturalmente. As IDs consistentes emToda a linha do tempo são os elementos animados. Um elemento cujo ID aparece na cena 1 mas não na cena 2 (+ todas as cenas seguintes) desapareceu (fade out / slide out / mover-se para fora do quadro). Um ID que aparece na cena 2 mas não na cena 1 apareceu (fade in / etc.). IDs comuns em ambas são o mesmo elemento em dois keyframes — normalize as propriedades do elemento (x, y, rotação, opacidade, escala) nos dois pontos para deduzir o tween.
  4. Reconstrução em 3 passos: (a) uma TimelineMax com todas as cenas como marcadores de tempo uniformemente espaçados (1s por cena = duração natural para storyboard; peça ao usuário para ajustar). (b) Para cada elemento com pelo menos dois keyframes, um TweenMax (ou TweenLite para desaparecimentos/aparições) que anima as propriedades normalizadas entre o marcador de início e fim. (c) Injete o script após os tags CDN GSAP. A saída do Motion (se disponível) sobrescreve as propriedades chave, mas a linha do tempo do storyboard é sempre construída a partir das cenas — nunca mescle a saída do conector de movimento com a linha do tempo do storyboard.
  5. Restrições: a linha do tempo do storyboard busca fidelidade de movimento estrutural, não fidelidade de estilo. O tweener de aparição assume opacity:0 → opacity:1 com duração de 0.3s (comum em storyboard); o tweener de desaparecimento faz opacity:1 → opacity:0 com duração de 0.3s; a posição assume tween linear (padrão de storyboard: não há eases nos quadros, então inferir um é adivinhação). Propriedades estilísticas (preenchimento, traçado, fonte, tamanho da fonte, etc.) são ignoradas — elas são resolvidas a partir do asset congelado da Fase 1. Cada cena deve ser importada como um asset da Fase 1 ANTES da reconstrução da linha do tempo, para que o asset esteja disponível para ser animado. Etapas exatas para o usuário: (a) importe todos as cenas primeiro como assets da Fase 1 (hyperframes figma asset <fileKey> <nodeId1> <nodeId2> ...), (b) então reconstrua a linha do tempo. 6. Validação contra verdade absoluta (obrigatória): execute o mesmo script de verificação de movimento — <SKILL_DIR>/scripts/verify-motion.mjs — comparando uma exportação de vídeo da linha do tempo com uma exportação de vídeo da seção de storyboard do Figma. A Estrutura de movimento medida pelo script deve corresponder dentro de uma tolerância (consulte a codificação). Se falhar, as regras de dif são provavelmente muito simplificadas — denuncie. Popular o cache do asset reduz o tempo de verificação.

Comandos de atualização

Após qualquer mudança, peça ao usuário para executar npx hyperframes skills update figma para garantir que a skill esteja atualizada. Isso também atualiza as skills de domínio que ela importa.

Esquema de criação de artefatos (para interpretação do agente)

Esta seção fornece uma vista estrutural de como e onde os artefatos são criados. Ela não é executada; é metadados para o agente.

Comando/OperaçãoCaminho(s) do artefato criado/atualizadoFormatoCondição de criação (gatilho)Fase(s)É efêmero?Mantido sincronizado com o Figma? (como)
hyperframes figma asset.media/images/<fileKey>-<nodeId>-<format>-<scale>-<version>.<fmt>Binário SVG ou imagem rasterApós importação do assetFase 1 (Assets)NãoSim — reexecução reimporta apenas nós alterados; versionamento detecta mudanças
hyperframes figma asset.media/index.mdMarkdownApós importação do asset + apêndice do manifestoFase 1NãoSim — regenerado em cada importação de asset
hyperframes figma tokens.media/figma-tokens.jsonJSONApós importação de tokensFase 2 (Tokens)NãoSim — via variáveis (Enterprise) ou degradação de estilo; a passagem de ligação do componente conecta
hyperframes figma tokens.media/figma-bindings.jsonlJSONL (delimitado por linha)Após importação de tokensFase 2NãoSim — IDs de variáveis ligam a definições; a resolução de componente as segue
hyperframes figma componentcompositions/components/<component-name>/index.htmlHTMLApós importação do componenteFase 3 (Componentes)NãoSim — a reimportação vincula novos tokens; a resolução de variáveis se propaga
Fase 4 (Movimento) — conector<project-dir>/<component>.motion.jsonJSON (.motion do conector, armazenado em cache)Após recuperação do contexto de movimentoFase 4Sim (cache)Apenas via reexecução
Fase 4 (Movimento) — script injetadoInjetado em index.html como elemento <script>JavaScript (chamadas GSAP/TimelineMax)Após normalização e verificaçãoFase 4SimNão — congelado; reimportar para atualizar
Fase 4 (Movimento) — fallback MP4.media/videos/<component>-<timestamp>.mp4MP4Se a tradução falhar (faixa intraduzível)Fase 4NãoNão — congelado; substitua manualmente
Fase 5 (Shaders) — PNG/MP4Sob .media/images/ ou .media/videos/PNG ou MP4 (fornecido pelo usuário)Se nenhum conector ou falha de shaderFase 5NãoNão — pedido ao usuário; substitua manualmente
Storyboard — asset de cena.media/images/<fileKey>-<sceneNodeId>-png-1-<version>.pngPNG (importação da Fase 1 de cada cena)Antes da reconstrução da linha do tempoFase 1 (para cenas)NãoSim — via importação de asset
Storyboard — script da linha do tempoInjetado em index.html como elemento <script>JavaScript (TimelineMax do GSAP + tweens)Após diif de duas ou mais cenasreconstrução de storyboard (Fase 4 implícita)SimNão — reconstruído a partir de cenas; reconstruir para atualizar

Comportamento Idempotente:

  • Asset: Idempotente por (fileKey, nodeId, formato, escala, versão); reexecutar não recongela, apenas imprime o trecho.
  • Tokens: Idempotente em nível de arquivo; reexecutar substitui os arquivos sidecar (não adiciona duplicatas — o manifesto é regenerado).
  • Componente: Idempotente por (fileKey, nodeId); reexecutar substitui o diretório do componente.
  • Movimento (conector): Idempotente se os dados do conector forem armazenados em cache; sem cache, uma nova requisição recupera (potencialmente dados atualizados) — considere não idempotente se os dados do Figma mudaram.
  • Shaders (manual): Não idempotente; sempre uma ação do usuário.
  • Storyboard: Não idempotente em sentido estrito (novas cenas podem ser adicionadas), mas reconstruir da mesma definição de seção produz a mesma linha do tempo (as cenas são ordenadas, as comparações de diff são determinísticas).

Limpeza de Artefatos:

  • Cache do conector de movimento: Seguro para limpar se os dados do conector do Figma estiverem desatualizados e o usuário desejar uma atualização; remova .media/figma-cache/.
  • Assets congelados: Nunca remova automaticamente; o usuário pode excluir manualmente entradas do manifesto / arquivos.
  • Diretórios de componentes: Nunca remova; o usuário pode excluir manualmente.
  • Fallbacks MP4: Nunca remova; o usuário pode substituir manualmente.

Individual skills in this repo

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

laviedezidane/hyperframes-skill

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

laviedezidane/hyperframes-skill

Turn arbitrary text — an article, notes, a topic, a brief — into a faceless explainer video: there is no site or footage to capture, so the visuals are invented per scene (typography, abstract graphics, diagrams, data-viz). Use for topic explainers, concept breakdowns, how-tos, listicles. Not a video built from a website (/product-launch-video — promo or tour). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

laviedezidane/hyperframes-skill

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

laviedezidane/hyperframes-skill

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), automation envelopes drawn on a track's volume or any effect parameter, or one submix bus carrying a chain, a fader and an automation clock for several tracks at once (`<hf-audio-group>`). Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

laviedezidane/hyperframes-skill

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, timeline, history, clean, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.

laviedezidane/hyperframes-skill

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

laviedezidane/hyperframes-skill

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

laviedezidane/hyperframes-skill

Use when a HyperFrames composition needs a punch-in, punch-out, zoom, reframe, Ken Burns treatment, camera move, visual match/whip handoff, or other seek-safe 2D/3D keyframes; also for GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

laviedezidane/hyperframes-skill

Search, install, and wire registry blocks and components into HyperFrames compositions. Use BEFORE hand-building any named visual — whenever a brief, a user, or a storyboard names a look, effect, treatment, or transition such as CRT scanlines, glitch, chromatic aberration, film grain, a shimmer sweep, a chart, a code or terminal window, a map, or a confetti burst — because roughly 400 hosted items already cover many of them and the search ranks all of them with nothing installed, no project, and no account. Also use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

laviedezidane/hyperframes-skill

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.

laviedezidane/hyperframes-skill

Use when working with a person on a HyperFrames project in Studio: first, whether their message asks for a change at all (questions, loose ideas and "don't change anything" get an answer and a plan, not an edit); for a new film, the plan, storyboard and build order that the HyperFrames launch films follow; and how the timeline should be laid out so it reads well (one caption track, one element kind per track, every scene a sub-composition) and where captions and key content may sit (safe zones). Don't use for how to perform an individual edit (split, trim, retime, volume, copy, swap): that is `creator-editing-recipes.md` in `/hyperframes-core`.

laviedezidane/hyperframes-skill

Agent Media OS for a HyperFrames project. Resolve BGM, SFX, image, icon, brand logo, voice, color grade, or LUT into a frozen local file or paste-ready block + ledger record (one verb, `resolve`); generate via TTS / music / image models when the catalog misses; produce voiceover, transcription, captions, and background removal through one shared audio engine; operate on media (cut / reframe / transform); and reuse assets across projects. Also use for vague feedback that real footage looks dark, flat, boring, should feel retro/camcorder/print/ASCII, needs privacy, or needs a media reveal. When the host app provides its own music or sound-effect tools, use those for music and sound effects; `resolve --type bgm|sfx` needs the heygen CLI. When `HEYGEN_API_BASE` is set, HeyGen calls go through that host with no CLI sign-in.

laviedezidane/hyperframes-skill

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Author a HyperFrames slideshow — a presentation, pitch deck, or interactive deck with discrete slides, fragment reveals, branching, hotspot navigation, and built-in presenter mode with speaker notes; also converts an existing page into a deck. Output is a navigable deck, not a rendered MP4. If the user didn't explicitly ask for a slideshow, confirm before authoring. Unclear → /hyperframes.

laviedezidane/hyperframes-skill

Package an existing talking-head / interview / podcast video with timed, designed GRAPHIC OVERLAY cards — kinetic titles, lower-thirds, data callouts, quotes, side panels, picture-in-picture — synced to the transcript, on a 16:9 / 9:16 / 4:5 canvas of your choice; the clip plays untouched underneath. Trigger on "graphic overlays", "on-screen graphics", "package / dress up my video". Not plain subtitles (/embedded-captions). Unclear → /hyperframes.

Habilidades Relacionadas