Communitygithub.com

HyperFrames Keyframes – Quadros-chave (poses)

Usado quando uma composição HyperFrames precisa de quadros-chave 2D/3D seguros para busca, timelines GSAP, CSS keyframes, Anime.js, WAAPI, FLIP, caminhos, máscaras, morph/draw SVG, rastros de texto, profundidade 3D ou diagnósticos `hyperframes keyframes`. Não use para estratégia geral de cena, design de marca, busca de mídia, legendas ou planejamento de vídeo genérico.

O que é HyperFrames Keyframes – Quadros-chave (poses)?

Esta skill define um contrato claro e seguro para animações em composições HyperFrames, garantindo que os quadros-chave sejam previsíveis, depuráveis e consistentes com a identidade visual do sujeito animado. Ela abrange desde mecanismos simples, como animações CSS e GSAP, até técnicas avançadas como FLIP (First, Last, Invert, Play), morphing SVG, animação de traços e cenas 3D com perspectiva e câmera. A skill impõe regras rígidas de tempo de execução, como a criação síncrona de timelines, registro em um registry global (`window.__timelines`), uso de `paused: true` e proibição de timers ou loops infinitos. Para cada tipo de necessidade (ex.: sujeito viajando, mudança de forma, revelação por máscara), ela sugere o mecanismo mais adequado e oferece comandos CLI específicos (`hyperframes keyframes`, `--shot`, `--ghost`) para verificar visualmente a animação, identificar problemas de continuidade, profundidade falsa ou tempo final incorreto. O objetivo é que o desenvolvedor possa iterar rapidamente, usando diagnósticos focados, até que todos os quadros-chave estejam corretos, legíveis e sem overlays de debug.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/sansayan01/finance_app_zo/tree/HEAD/.agents/skills/hyperframes-keyframes

Perguntar na sua IA favorita

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

Documentação

HyperFrames Keyframes (Quadros-chave)

Quadros-chave são um contrato de pose: estados visíveis, identidade contínua do sujeito, execução segura para busca, pixels verificados.

Use hyperframes-animation para receitas de cena amplas. Use hyperframes-cli para documentação completa de comandos. Use references/keyframe-patterns.md apenas ao escolher mecanismos de implementação, não estilo visual.

Procedimento

  1. Identifique o sujeito animado, estados visíveis, estado final e tempo de execução.
  2. Escolha o menor mecanismo que comprove a instrução. Leia references/keyframe-patterns.md apenas se o mecanismo não estiver claro.
  3. Crie quadros-chave seguros para busca no tempo de execução declarado. Construa de forma síncrona e registre a instância de tempo de execução.
  4. Verifique com lint, validate, hyperframes keyframes, um --shot focado e snapshots nos momentos de prova.
  5. Se a prova falhar, corrija os quadros-chave de origem e reexecute o menor diagnóstico de falha antes de renderizar.

Contrato

  • Nomeie o sujeito em movimento.
  • Nomeie as poses necessárias para provar o movimento pretendido, incluindo o estado final.
  • Aplique quadros-chave em canais visíveis, não em estado oculto auxiliar.
  • Preserve a identidade do objeto quando a continuidade for importante.
  • Faça crossfade apenas quando o movimento pretendido for substituição ou dissolução.
  • Mantenha estados legíveis ou semânticos por tempo suficiente para serem vistos.
  • O quadro final faz parte da animação, não é uma limpeza.
  • Não retorne ao estado de repouso a menos que solicitado.
  • Não termine em preto a menos que solicitado.
  • Ao editar uma cena inicial, preserve layout, texto, assets, cores e estado final, a menos que seja solicitado um redesign.

Regras de Tempo de Execução

GSAP:

  • construa de forma síncrona no carregamento da página
  • use gsap.timeline({ paused: true })
  • registre como window.__timelines[compositionId]
  • a chave do registro deve corresponder a data-composition-id
  • não chame tl.play() para movimentos críticos de renderização
  • mantenha repetições finitas

CSS keyframes:

  • duração e contagem de iterações finitas
  • atraso determinístico
  • animation-fill-mode: both
  • use data-start quando o tempo pertencer a um clipe

Anime.js:

  • crie de forma síncrona
  • autoplay: false
  • duração e loops finitos
  • envie cada instância para window.__hfAnime

WAAPI:

  • duration finito
  • fill: "both"
  • construção determinística
  • a superfície de texto não lista WAAPI; verifique com --shot (ele busca WAAPI) e snapshots

Nunca use para movimentos críticos de renderização:

  • Date.now()
  • performance.now()
  • Math.random() sem semente
  • gatilhos de hover/scroll
  • timers
  • timelines criadas de forma assíncrona
  • requestAnimationFrame não registrado
  • loops infinitos

Esqueleto GSAP

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

Use labels para estados semânticos. Use parâmetros de posição em vez de atrasos encadeados. Use immediateRender: false para tweens from()/fromTo() posteriores que toquem a mesma propriedade.

Formas de Quadros-chave

  • Array de quadros-chave: escada de poses com duração/ease por etapa.
  • Quadros-chave percentuais: tempo exato dentro de um tween.
  • Arrays de propriedades: mudanças compactas de múltiplas paradas.
  • ease: "none" no pai quando cada parada carrega sua própria easing.
  • easeEach quando cada segmento deve compartilhar a mesma sensação.

Não copie distâncias numéricas ou tempos de exemplos. Derive-os da geometria real da composição e duração.

Para um sujeito se movendo entre duas caixas, prefira um tween contínuo de transformação ou FLIP. Divida x/y/scale em vários quadros-chave com easing apenas quando o espectador deve sentir batidas distintas; cada segmento altera a velocidade e pode ser lido como um soluço.

Canais

Prefira canais do compositor/visuais: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, máscaras, variáveis CSS, valores de caminho/dash SVG, transformações de câmera, uniforms de shader.

Evite canais de layout/ciclo de vida: top/left/right/bottom, width/height, margin/padding, display, visibility, criação tardia de DOM, overlays auxiliares fazendo movimento de sujeito.

Escolha do Mecanismo

Escolha o menor mecanismo que comprove a instrução:

NecessidadeMecanismo
Mesmo sujeito muda de caixa ou hierarquiaelemento compartilhado / FLIP
Sujeito percorre uma rota visívelviagem por caminho
Traço cresce ou traçadesenho de traço
Forma se torna outra formainterpolação de forma
Fronteira de revelação é visívelclip, máscara, ou uniforme de shader
Muitos itens se movem com ordemstagger / atraso indexado
O próprio texto se movesubdivisão de linha, palavra, caractere ou banda
Superfície dobra, estica ou cortacontra-transformada pai/filho
UI tem estadosmáquina de estados explícita
Cena tem profundidadeDOM 3D, Three.js, ou quadros-chave de câmera/objeto WebGL

Mecanismos podem combinar, mas cada um deve esclarecer a ideia. Decoração não é prova.

Tempo

  • Antecipação apenas quando esclarece causa ou direção.
  • Aceleração deixa o repouso.
  • Pico de prova mostra o mecanismo inconfundivelmente.
  • Acompanhamento vende energia e direção.
  • Ultrapassagem apenas quando o sujeito deve parecer elástico ou tátil.
  • Viagem em caminho a velocidade constante geralmente precisa de ease: "none".
  • Estados discretos de UI geralmente precisam de um ease-out brusco.
  • Elementos repetidos precisam de deslocamentos ordenados, não tempos idênticos.
  • Travamentos finais precisam de retenções mais longas do que as poses de transição.
  • Suavidade significa velocidade contínua no mesmo sujeito.
  • Não sobreponha tweens que escrevem a mesma propriedade de transform, a menos que a sobreposição seja intencional e verificada.
  • Evite animar grandes mudanças de clip-path/máscara enquanto a mesma superfície hero também está escalando ou viajando; use revelações aninhadas após o movimento principal se estabilizar.

Texto

Preserve caixas de linha, espaçamento entre palavras, legibilidade e ajuste final. Se o texto se move internamente, mova os glifos ou bandas mascaradas, não apenas decorações ao redor do texto. Tire snapshot de quadros legíveis.

SVG

Para crescimento de traço, prefira DrawSVGPlugin, depois stroke-dasharray/stroke-dashoffset. Para interpolação de forma, prefira MorphSVGPlugin; converta primitivas em caminhos quando necessário e divida silhuetas complexas em partes mais simples.

3D

Escala sozinha é profundidade falsa. Use perspectiva em um pai estável, transform-style: preserve-3d, viagem em z, rotação, movimento de câmera/mundo, oclusão e ordem de camadas quando objetos se cruzam.

Use um ou dois ângulos de diagnóstico que exponham a relação de profundidade. Se a prova angulada não mostrar cruzamento de profundidade, melhore z/câmera/oclusão.

Canvas / WebGL

Aplique quadros-chave em posição da câmera, alvo da câmera, transformação do objeto, opacidade do material, uniforms de shader e intensidade de pós-processamento através de estado determinístico. Renderize a partir do tempo HyperFrames. Use --ghost porque caixas marcadoras não podem ver movimento interno do canvas.

Prova CLI

npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<arquivo>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<arquivo>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<arquivo>" --ghost --angle <ângulo>
npx hyperframes snapshot . --at <tempos>

Escolha <selector> para o sujeito animado real. Escolha <tempos> para o primeiro quadro, poses de prova, final-menos-retenção, e final exato. Escolha <ângulo> apenas quando a profundidade precisar ser provada.

FerramentaComprova
keyframesalvos, paradas explícitas, caminhos, traços, movimento composto pai/filho, paradas CSS, registro Anime
--shotfantasmas, forma da rota, espaçamento temporal, projeção DOM 3D, prova de seletor focado
--layout stripmovimento no lugar, sobreposições, contato, escala/opacidade sutis, ondas de texto
--ghostcanvas, WebGL, movimento de shader, 3D renderizado
snapshot --atmáscaras, legibilidade de texto, estado completo, travamento final, caudas pretas/reset

Se a prova do seletor parecer errada:

  1. reexecute --json
  2. encontre o destino animado real
  3. filme esse destino
  4. tire snapshot de quadros completos
  5. confie nos pixels pintados em vez de logs

Leitura de Diagnóstico

flat significa sem poses intermediárias explícitas. keyframes significa que existem paradas explícitas. motionPath significa que existe uma rota. trace significa desenho multitraço. composed with significa que o movimento filho herda o movimento pai.

Espaçamento uniforme de fantasmas significa velocidade constante. Fantasmas agrupados significam desaceleração ou estabilização. Grandes lacunas significam viagem rápida.

Um tiro de seletor auxiliar não é prova. Um tiro cebola sobre um quadro completo quebrado não é prova.

Tratamento de Erros

FalhaCorreção
apenas ponto finaladicione poses intermediárias, segure o pico de prova, reexecute --shot
quebra de identidademantenha um elemento vivo, use caixas de origem/destino compartilhadas, remova crossfade substituto
3D falsoadicione viagem em z/câmera, oclusão, prova angulada
final erradoadicione retenção final, tire snapshot do final-menos-retenção e do final exato
tempo de execução não buscávelpause autoplay, registre a instância, remova timers, construa de forma síncrona
texto ilegívelpreserve caixas de linha, reduza deslocamento, adicione retenção final, tire snapshot dos quadros de texto

Pronto

Execute lint, validate, keyframes, um --shot focado e snapshots. Confirme o primeiro quadro, poses de prova, final-menos-retenção, final exato, movimento de propriedade do sujeito e sem overlays de debug.

Individual skills in this repo

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

sansayan01/finance_app_zo

Add captions to a talking-head video. ONE catalog (CATALOG.md) of 36 visual identities behind two engines: column-flow (captions composited INTO the scene — matte occlusion + mix-blend; cream/ink/editorial/keynote/documentary/loud/neon/glitch/chrome/velocity) and themed constitutions (anchor/ordnance/terminal/neonsign/stardust/stomp/scoreboard/transit/vhs/arcade/dossier/laser/thunder/hologram/biolume/aurora/spectrum/papercut/popup/chalkboard/graffiti/brush/inkwater/ransom/lastpage/nightcity — e.g. a glyph-decode climax, a neon sign WRITTEN stroke by stroke, or the quiet `anchor` rail default). Route by identity, never by mode. Trigger on "captions/subtitles", "embed/cinematic captions", "VFX captions", "炸/特效/酷炫字幕", a named identity, or top-tier motion-graphics asks. Embedding every word is wrong for most talking-head content — `anchor` is the verbatim default. Runs locally end-to-end (transcribes and mattes the subject itself, no API key). Requires hyperframes and a single-subject clip (multi-shot clips ar...

sansayan01/finance_app_zo

The fallback workflow for authoring or editing any custom HyperFrames composition at any length or format — longer / multi-scene pieces, brand and sizzle reels, montages, title cards, static loops, freeform builds. Use only when no specialized workflow fits the input; routing table at /hyperframes.

sansayan01/finance_app_zo

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.

sansayan01/finance_app_zo

HyperFrames CLI dev loop. Use when running npx hyperframes init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, render, publish, cloud, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, tts, or remove-background (validate/inspect/layout are deprecated aliases covered by check), or when troubleshooting the HyperFrames build/render environment. Entry point for HeyGen-hosted cloud rendering (`hyperframes cloud render / list / get / delete`) and self-managed AWS Lambda rendering (`hyperframes lambda deploy / render / progress / destroy / policies / sites`).

sansayan01/finance_app_zo

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. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition HTML.

sansayan01/finance_app_zo

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`.

sansayan01/finance_app_zo

MicroFlow Pro - MFI Staff Portal built with Flutter & Supabase

Habilidades Relacionadas