Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Referência de animação GSAP para HyperFrames. Abrange gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), parâmetro de posição, labels, aninhamento, reprodução) e desempenho (transformações, will-change, quickTo). Use ao escrever animações GSAP em composições HyperFrames.

O que é Tony-Claude-Code-Skills?

Esta skill fornece uma referência completa para o uso da biblioteca GSAP dentro do ecossistema HyperFrames. Ela estabelece um contrato rígido para integrar animações GSAP com o mecanismo de renderização de vídeo do HyperFrames, exigindo que as timelines sejam criadas de forma síncrona, pausadas e registradas no objeto `window.__timelines` com uma chave que corresponda exatamente ao atributo `data-composition-id` do elemento raiz da composição. A skill documenta de forma abrangente os métodos principais de tween (gsap.to, from, fromTo, set), as propriedades CSS/transformação preferidas (como autoAlpha e aliases de transformação), os parâmetros de easing e stagger, e as práticas recomendadas para performance, como o uso de `quickTo` e a animação apenas de transformações e opacidade. Além disso, inclui orientações sobre timelines, labels, aninhamento, controle de reprodução e o uso de `gsap.matchMedia()` para responsividade e acessibilidade. A skill é direcionada para desenvolvedores que criam animações em composições HyperFrames, com ênfase em evitar loops infinitos, animações assíncronas e a animação de propriedades de layout.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/shengdabai/Tony-Claude-Code-Skills/tree/HEAD/skills/hyperframes-gsap

Perguntar na sua IA favorita

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

Documentação

GSAP

Contrato HyperFrames

O HyperFrames controla o GSAP através de seu adaptador de runtime gsap. Crie uma timeline pausada de forma síncrona, registre-a em window.__timelines com o data-composition-id exato e deixe o HyperFrames controlar a posição.

<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<script>
  window.__timelines = window.__timelines || {};
  const tl = gsap.timeline({ paused: true });

  tl.from(".title", { y: 48, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
  tl.to(".accent", { scaleX: 1, duration: 0.5, ease: "power2.out" }, 0.25);

  window.__timelines["main"] = tl; // a chave deve ser igual ao data-composition-id na raiz da composição
</script>
  • A chave do registro deve corresponder ao data-composition-id do elemento raiz da composição.
  • Não chame tl.play() para animações críticas de renderização.
  • Não construa timelines dentro de código assíncrono, timers ou manipuladores de eventos.
  • Mantenha loops finitos. O HyperFrames renderiza durações de vídeo finitas.

Métodos Principais de Tween

  • gsap.to(targets, vars) — anima do estado atual para vars. O mais comum.
  • gsap.from(targets, vars) — anima de vars para o estado atual (entradas).
  • gsap.fromTo(targets, fromVars, toVars) — início e fim explícitos.
  • gsap.set(targets, vars) — aplica imediatamente (duração 0).

Sempre use nomes de propriedade em camelCase (ex.: backgroundColor, rotationX).

Propriedades vars Comuns

  • duration — segundos (padrão 0.5).
  • delay — segundos antes de iniciar.
  • ease — "power1.out" (padrão), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — número 0.1 ou objeto: { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false (padrão), true ou "auto".
  • repeat — número finito; nunca -1 no HyperFrames. Calcule repetições a partir da duração visível. yoyo — alterna a direção com repeat.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — padrão true para from()/fromTo(). Defina como false em tweens posteriores que visam a mesma propriedade+elemento para evitar sobrescrição.

Transformações e CSS

Prefira os aliases de transformação do GSAP em vez da string transform bruta:

Propriedade GSAPEquivalente
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y em %
scale, scaleX, scaleYscale
rotationrotate (graus)
rotationX, rotationYrotação 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — prefira em vez de opacity. Em 0: também define visibility: hidden.
  • Variáveis CSS — "--hue": 180.
  • svgOrigin (apenas SVG) — origem no espaço de coordenadas global do SVG. Não combine com transformOrigin.
  • Rotação direcional — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" ou separado por vírgulas; remove estilos inline ao completar.
  • Valores relativos — "+=20", "-=10", "*=2".

Valores Baseados em Função

gsap.to(".item", {
  x: (i, target, targets) => i * 50,
  stagger: 0.1,
});

Easing

Eases embutidos: power1–power4, back, bounce, circ, elastic, expo, sine. Cada um tem .in, .out, .inOut.

Padrões

gsap.defaults({ duration: 0.6, ease: "power2.out" });

Controlando Tweens

const tween = gsap.to(".box", { x: 100 });
tween.pause();
tween.play();
tween.reverse();
tween.kill();
tween.progress(0.5);
tween.time(0.2);

gsap.matchMedia() (Responsivo + Acessibilidade)

Executa a configuração apenas quando uma media query corresponde; reverte automaticamente quando para de corresponder.

let mm = gsap.matchMedia();
mm.add(
  {
    isDesktop: "(min-width: 800px)",
    reduceMotion: "(prefers-reduced-motion: reduce)",
  },
  (context) => {
    const { isDesktop, reduceMotion } = context.conditions;
    gsap.to(".box", {
      rotation: isDesktop ? 360 : 180,
      duration: reduceMotion ? 0 : 2,
    });
  },
);

Timelines

Criando uma Timeline

const tl = gsap.timeline({ defaults: { duration: 0.5, ease: "power2.out" } });
tl.to(".a", { x: 100 }).to(".b", { y: 50 }).to(".c", { opacity: 0 });

Parâmetro de Posição

O terceiro argumento controla o posicionamento:

  • Absoluto: 1 — em 1s
  • Relativo: "+=0.5" — após o fim; "-=0.2" — antes do fim
  • Label: "intro", "intro+=0.3"
  • Alinhamento: "<" — mesmo início que o anterior; ">" — após o anterior terminar; "<0.2" — 0.2s após o anterior iniciar
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // mesmo início que .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0.2s após .b iniciar

Labels

tl.addLabel("intro", 0);
tl.to(".a", { x: 100 }, "intro");
tl.addLabel("outro", "+=0.5");
tl.play("outro");
tl.tweenFromTo("intro", "outro");

Opções de Timeline

  • paused: true — cria pausada; chame .play() para iniciar.
  • repeat, yoyo — aplica a toda a timeline.
  • defaults — vars mescladas em cada tween filho.

Aninhando Timelines

const master = gsap.timeline();
const child = gsap.timeline();
child.to(".a", { x: 100 }).to(".b", { y: 50 });
master.add(child, 0);

Controle de Reprodução

tl.play(), tl.pause(), tl.reverse(), tl.restart(), tl.time(2), tl.progress(0.5), tl.kill().


Desempenho

Prefira Transformação e Opacidade

Animar x, y, scale, rotation, opacity permanece no compositor. Evite width, height, top, left quando transformações alcançam o mesmo efeito.

will-change

will-change: transform;

Apenas em elementos que realmente animam.

gsap.quickTo() para Atualizações Frequentes

let xTo = gsap.quickTo("#id", "x", { duration: 0.4, ease: "power3" }),
  yTo = gsap.quickTo("#id", "y", { duration: 0.4, ease: "power3" });
container.addEventListener("mousemove", (e) => {
  xTo(e.pageX);
  yTo(e.pageY);
});

Stagger > Múltiplos Tweens

Use stagger em vez de tweens separados com delays manuais.

Limpeza

Pause ou elimine animações fora da tela.


Referências (carregadas sob demanda)

  • references/effects.md — Efeitos prontos: texto de máquina de escrever, visualizador de áudio. Leia quando precisar de padrões de efeito prontos para HyperFrames.

Melhores Práticas

  • Use nomes de propriedade em camelCase; prefira aliases de transformação e autoAlpha.
  • Prefira timelines em vez de encadeamento com delay; use o parâmetro de posição.
  • Adicione labels com addLabel() para sequenciamento legível.
  • Passe defaults no construtor da timeline.
  • Armazene o valor de retorno do tween/timeline ao controlar a reprodução.

Não Faça

  • Anime propriedades de layout (width/height/top/left) quando transformações forem suficientes.
  • Use svgOrigin e transformOrigin no mesmo elemento SVG.
  • Encadeie animações com delay quando uma timeline pode sequenciá-las.
  • Crie tweens antes do DOM existir.
  • Pule a limpeza — sempre elimine tweens quando não forem mais necessários.
  • Use valores de repetição infinitos em composições HyperFrames. Use contagens de repetição finitas calculadas a partir da duração visível.

Créditos e Referências

Individual skills in this repo

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

shengdabai/Tony-Claude-Code-Skills

Downloads videos from YouTube and other platforms for offline viewing, editing, or archival. Handles various formats and quality options.

shengdabai/Tony-Claude-Code-Skills

接收抖音、小红书、微信视频号等短视频链接或分享文案,查询作品/账号数据并提取语音文字稿,按作者和标题归档为 Markdown。用户希望完整解析短视频、取得数据或文字稿时使用;运行前检查 TikHub 与轻抖使用凭证,缺少时用新手能理解的方式引导购买和安全配置。

shengdabai/Tony-Claude-Code-Skills

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

shengdabai/Tony-Claude-Code-Skills

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.

shengdabai/Tony-Claude-Code-Skills

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.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-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.

shengdabai/Tony-Claude-Code-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.

Habilidades Relacionadas