Communitygithub.com

heygen-com/hyperframes

Técnica de cursor macOS superdimensionado no estilo house para vídeos de lançamento HyperFrames. Carregue sempre que uma cena envolver cursores ou uma ação guiada por ponteiro, ao iniciar uma cena de UI, ao disparar uma morph/transição/digitação com um clique, ou quando uma cena parecer estática, morta ou desatualizada e precisar de uma fonte barata e de alto rendimento de movimento para guiar o olhar do espectador e tirá-lo do estado inerte. Abrange tamanho/aparência do cursor (incluindo cursores com motivos da marca), a lei de entrada fora da tela, o direcionamento da ponta e o toque do clique, clique que aciona o próximo compasso, e saída/transferência entre cenas.

O que é hyperframes?

Esta skill define uma técnica de animação de cursor superdimensionado no estilo macOS, projetada para atuar como um protagonista visual em vídeos de lançamento da HyperFrames. A técnica é acionada em cenas de interface de usuário, transições ou quando a cena está estática, usando um cursor grande que entra fisicamente pela tela, guia o olhar do espectador, clica para iniciar a próxima ação e sai de forma limpa. Ela cobre regras de tamanho (mínimo de 7cqw em cenas de tela cheia), posicionamento da ponta do cursor (transformOrigin em 21% 14%), animações de clique com escala assimétrica e dois métodos de saída: desaparecer da tela ou transferência suave entre cenas (cut-the-curve handoff). Suporta cursores personalizados com motivos da marca (como cursores de ferramentas de design colaborativo) e é otimizada para uso em vídeos produzidos para plataformas como Claude, Cursor e Codex. A técnica evita desvanecimento de opacidade e movimentos desnecessários, garantindo que o cursor sempre se mova de forma física e causal.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/heygen-com/hyperframes/tree/HEAD/.agents/skills/oversized-cursor

Perguntar na sua IA favorita

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

Documentação

Cursor Superdimensionado — o condutor do olhar

Um ponteiro macOS deliberadamente superdimensionado que percorre o quadro como um protagonista visível: entra de fora da tela, guia o olhar do espectador até o próximo ponto de interesse, clica para causar a próxima coisa que acontece e sai. Comprovado em produção em vários filmes de lançamento.

Por que existe. Movimento de cursor grande é uma das fontes de movimento de alto rendimento mais baratas em um vídeo de lançamento: um elemento, apenas tweens de transformação, e ele (1) traz o olhar através da tela em cenas que, de outra forma, pareceriam mortas, (2) dá uma ignição causal para morphs/transições ("foi o clique que fez isso"), e (3) segmenta o olhar para fora de um estado inerte ao iniciar uma nova cena ou uma sequência de animação complexa. Quanto maior, melhor — um cursor de tamanho real desaparece na escala do vídeo.

Tamanho e aparência (convenção da casa)

  • Cenas de tela cheia: 7cqw (≈134px em 1920). Em variantes em mock / tela pequena: 4.6–5.5cqw. Nunca menor.
  • Uma única geometria de seta SVG em todos os lugares. Dois preenchimentos comprovados — corpo branco + traço preto, ou corpo preto (#1c1c1c) + traço branco (1.4px). Escolha por contraste da cena, mantenha constante por filme.
  • Cursores com motivo da marca (a jogada poderosa). A seta macOS é o PADRÃO, não uma obrigação. Quando a marca do assunto tem uma identidade de cursor reconhecível — uma seta colorida de multiplayer de ferramenta de design colaborativo com uma etiqueta de nome (estilo Figma), uma mira de precisão de suíte criativa, um ponteiro de produto distinto — use ESSE cursor: linguagem de marca instantaneamente legível para quem conhece o produto. As mesmas leis se aplicam inalteradas (escala superdimensionada, entrada/saída física, direcionamento da ponta, ignição por clique), e uma variante com etiqueta de nome viaja como uma unidade rígida (etiqueta seguindo a seta). Use-a apenas quando o motivo for genuinamente referenciável; um cursor que ninguém reconhece é apenas uma seta estranha — volte ao padrão macOS.
  • filter: drop-shadow(0 4px 6px rgba(0,0,0,.3)), pointer-events: none, z-index acima de todo o conteúdo da cena, will-change: transform.
#root .cursor {
  position: absolute;
  left: 48%;
  top: 115%; /* fora da tela abaixo — a pose de repouso está FORA da tela */
  width: 7cqw;
  height: 7cqw;
  z-index: 20;
  filter: drop-shadow(0 4px 6px rgba(0, 0, 0, 0.3));
  pointer-events: none;
  will-change: transform;
}

Lei de entrada — física, nunca revelada

O cursor sempre entra de fora da tela (canônico: de baixo, top:115–120%) e viaja até seu primeiro alvo em um deslize desacelerado. Deve dar a sensação de que entrou na sala. Nunca desapareça em opacidade em uma posição de repouso, nunca revele por máscara — isso parece um glitch (um modo de falha real e repetidamente observado).

  • Caminho padrão: diretamente no eixo y até o alvo — sem diagonais fragmentadas. Uma diagonal é aceitável quando ELA é a história (entrando em direção a um alvo fora do eixo), mas é um vetor contínuo de qualquer maneira.
  • duration: 0.4–0.92s, ease: power3.out, immediateRender: false no fromTo.
tl.fromTo(
  cursor,
  { left: "48.6%", top: "115%" },
  { left: "48.6%", top: "55%", duration: 0.85, ease: "power3.out", immediateRender: false },
  0.25,
);

Direcionamento da ponta e o toque do clique

O ponto ativo é a PONTA da seta, não o centro da caixa. Posicione a ponta no centro do alvo e centralize toda a escala de pressão na ponta: transformOrigin: '21% 14%' (para o caminho da seta padrão em um viewBox de 24 unidades).

Clique = compressão/expansão assimétrica (proporção 1:2 parece um toque real):

tl.to(cursor, { scale: 0.84, duration: 0.1, ease: "power2.in", transformOrigin: "21% 14%" }, t);
tl.to(
  cursor,
  { scale: 1, duration: 0.22, ease: "power2.out", transformOrigin: "21% 14%" },
  t + 0.1,
);

A reação do alvo é um tween separado e paralelo (botão: scale: 0.94 + cor/sombra de pressão, começando no mesmo t). Toques apenas no cursor (por exemplo, focar uma entrada de texto) NÃO recebem reação do alvo. Emparelhe com cursor-click-ripple / press-release-spring para o lado do alvo.

O clique ACIONA o próximo compasso

Nunca deixe que uma morph, execução de digitação, transformação de janela ou animação de definição de cena simplesmente comece. Estacione o cursor no gatilho e deixe o clique causá-lo, no mesmo quadro:

  • clique ▸ cascata de menu/submenu, alternância de flip
  • clique ▸ início de digitação em uma entrada
  • clique ▸ morph de compositor down / encolhimento de janela
  • clique ▸ ignição de logotipo / lançamento de voo
  • clique ▸ alternância de estado de reprodução + despertar de vida de UI em um mock de produto

Durante compassos longos que não possui (digitação, narração), o cursor desvia para o lado (0.5–0.9s, power2.out) — nunca fica congelado sobre a ação, nunca oscila ociosamente.

Lei de saída e transferência entre cenas

Duas saídas sancionadas — ambas físicas, nunca um desvanecimento de opacidade no lugar:

  1. Sair do quadro: acelere para fora da borda mais próxima com power2.in (left:'118%', left:'-12%', ou top:'116%'), 0.5–0.7s.
  2. Transferência corte-a-curva: nos ~0.3s finais antes de um corte brusco, o cursor começa a acelerar (power2.in) em direção ao PRIMEIRO ponto de clique da PRÓXIMA cena, cobrindo o primeiro ~1/3 desse caminho; a próxima composição gsap.set o cursor na pose de transferência e continua com power2.out em velocidade combinada. O próprio cursor se torna o elemento condutor que costura a emenda:
// cena A, últimos 0.3s — inicia a jornada:
tl.to(cursor, { left: "40.7%", top: "63.7%", duration: 0.3, ease: "power2.in" }, CUT - 0.3);
// cena B, t=0 — finaliza em velocidade combinada:
gsap.set(cursorB, { left: "40.7%", top: "63.7%" });
tl.to(cursorB, { left: "22%", top: "45%", duration: 0.6, ease: "power2.out" }, 0);

Lista de verificação

  • ≥ 7cqw em tela cheia (4.6–5.5cqw dentro de um mock) — quando em dúvida, maior
  • entra de fora da tela em um vetor contínuo (sem desvanecimento/revelação por máscara)
  • a ponta pousa no centro do alvo; a pressão centraliza em transformOrigin: '21% 14%'
  • cada clique causa algo, no mesmo quadro
  • desvia para o lado durante compassos que não possui; zero oscilação ociosa
  • sai fisicamente (para fora do quadro ou transferência corte-a-curva) — sem desvanecimento no lugar

Individual skills in this repo

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

general-video

>

heygen-com/animejs

Anime.js adapter patterns for HyperFrames. Use when writing Anime.js animations or timelines inside HyperFrames compositions, registering animations on window.__hfAnime, making Anime.js seek-driven and deterministic, or translating Anime.js examples into render-safe HyperFrames HTML.

heygen-com/claude-design-hyperframes

Use when running inside Claude Design specifically. Produces a valid, brand-accurate HyperFrames video draft using pre-valid skeletons. For Claude Code / Cursor / Codex, use the `hyperframes` skill instead.

heygen-com/contribute-catalog

Author a new HyperFrames registry block (caption style, VFX block, transition, lower third) or component (text effect, overlay, snippet) and ship it as an upstream PR to the hyperframes repo. Use ONLY when the user wants to CONTRIBUTE to the public catalog — for in-project caption/transition authoring use the `hyperframes` skill, for installing existing registry items use the `hyperframes-registry` skill.

heygen-com/css-animations

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.

heygen-com/gsap

GSAP animation reference for HyperFrames. Covers gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), position parameter, labels, nesting, playback), and performance (transforms, will-change, quickTo). Use when writing GSAP animations in HyperFrames compositions.

heygen-com/hyperframes

A tiled headline surface flips cell by cell under a sweeping depth field to reveal the rear headline. HyperFrames block, 1920×1080, 8s, 18 variables.

heygen-com/hyperframes

Leaves sweep through the frame and part to reveal the headline. HyperFrames block, 1920×1080, 12s, 11 variables.

heygen-com/hyperframes

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

heygen-com/hyperframes

A single feature card orbits a dot sphere on approved Blender camera motion. HyperFrames block, 1920×1080, 10s, 4 variables.

heygen-com/hyperframes

A wireframe portal bursts open, the title comes through, then its letters swap into a second phrase. HyperFrames block, 1920×1080, 8s, 9 variables.

heygen-com/hyperframes

Glass shards fly in through fog and tile themselves into the headline. HyperFrames block, 1920×1080, 12.16s, 19 variables.

heygen-com/hyperframes

Render-correctness doctrine for scene-to-scene seams in HyperFrames launch videos — the prerequisites that make transitions composite correctly on the master timeline. Load when assembling the master timeline / index.html, when a white flash appears at a cut or crossfade seam (especially on dark films), when reasoning about why a transition opacity dip shows through, or when verifying the render-side mechanics of how overlapping scene wrappers blend. Covers the opaque stage-ground (#root background) white-flash guard and how the injector overlaps wrappers, holds final frames, ping-pongs tracks, and stamps lint-clean template code onto the master timeline. Does NOT contain the per-transition catalog — see the transition registry for individual transition entries.

heygen-com/hyperframes

An orbiting camera follows an ice logo as it breaks apart, reforms into two text moments, and fades. HyperFrames block, 1920×1080, 22.5s, 216 variables.

heygen-com/hyperframes

name: embedded-captions

heygen-com/hyperframes

A chain of bevelled cuboids rides a travelling wave as a content carousel. HyperFrames block, 1920×1080, 6.666666666666667s, 40 variables.

heygen-com/hyperframes

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.

heygen-com/hyperframes

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

heygen-com/hyperframes

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

heygen-com/hyperframes

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

Habilidades Relacionadas