Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

Référence d'animations GSAP pour HyperFrames. Couvre gsap.to(), from(), fromTo(), easing, stagger, defaults, timelines (gsap.timeline(), paramètre de position, labels, imbrication, lecture) et performances (transforms, will-change, quickTo). À utiliser lors de la rédaction d'animations GSAP dans des compositions HyperFrames.

Qu'est-ce que Tony-Claude-Code-Skills ?

Cette compétence fournit une référence complète et un guide de bonnes pratiques pour utiliser GSAP spécifiquement avec le cadre de compositions animées HyperFrames. Elle décrit le contrat d'exécution crucial : créer une timeline en pause de manière synchrone, l'enregistrer sur `window.__timelines` avec le `data-composition-id` exact, et laisser HyperFrames la contrôler en cherchant les images clés. La compétence couvre toutes les méthodes de tween de base (to, from, fromTo, set), les propriétés communes avec leurs options (duration, ease, stagger, repeat), les alias de transformation préférés pour la performance, et la gestion des timelines avec le paramètre de position, les labels et l'imbrication. Elle insiste sur les performances en recommandant d'animer les propriétés de transformation et l'opacité plutôt que la mise en page, et fournit des conseils pour utiliser `gsap.quickTo()`, `stagger`, et le nettoyage. La compétence est conçue pour des développeurs utilisant Claude Code, Cursor, ou Codex pour générer des animations GSAP prêtes pour HyperFrames, en s'assurant qu'elles respectent les contraintes de rendu vidéo (pas de répétitions infinies, pas de construction asynchrone). Elle inclut également une référence à un fichier d'effets prêts à l'emploi pour des motifs courants comme le texte machine à écrire.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

GSAP

Contrat HyperFrames

HyperFrames contrôle GSAP via son adaptateur d'exécution gsap. Créez une timeline en pause de manière synchrone, enregistrez-la sur window.__timelines avec le data-composition-id exact, et laissez HyperFrames la parcourir.

<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; // la clé doit correspondre à data-composition-id sur la racine de la composition
</script>
  • La clé du registre doit correspondre au data-composition-id de la racine de la composition.
  • N'appelez pas tl.play() pour les animations critiques pour le rendu.
  • Ne construisez pas de timelines à l'intérieur de code asynchrone, de temporisateurs ou de gestionnaires d'événements.
  • Gardez les boucles finies. HyperFrames rend des durées vidéo finies.

Méthodes de Tween Principales

  • gsap.to(targets, vars) — anime de l'état actuel vers vars. Le plus courant.
  • gsap.from(targets, vars) — anime de vars vers l'état actuel (entrées).
  • gsap.fromTo(targets, fromVars, toVars) — début et fin explicites.
  • gsap.set(targets, vars) — applique immédiatement (durée 0).

Utilisez toujours des noms de propriétés en camelCase (par ex. backgroundColor, rotationX).

Propriétés communes

  • duration — secondes (par défaut 0.5).
  • delay — secondes avant le début.
  • ease — "power1.out" (par défaut), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — nombre 0.1 ou objet : { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false (par défaut), true, ou "auto".
  • repeat — nombre fini ; jamais -1 dans HyperFrames. Calculez les répétitions à partir de la durée visible. yoyo — alterne la direction avec repeat.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — par défaut true pour from()/fromTo(). Mettez false sur les tweens ultérieurs ciblant la même propriété+élément pour éviter l'écrasement.

Transformations et CSS

Préférez les alias de transformation de GSAP plutôt que la chaîne transform brute :

Propriété GSAPÉquivalent
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y en %
scale, scaleX, scaleYscale
rotationrotate (degrés)
rotationX, rotationYrotation 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — préférez à opacity. À 0 : définit également visibility: hidden.
  • Variables CSS — "--hue": 180.
  • svgOrigin (SVG uniquement) — origine de l'espace de coordonnées SVG global. Ne combinez pas avec transformOrigin.
  • Rotation directionnelle — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" ou séparés par des virgules ; supprime les styles en ligne à la fin.
  • Valeurs relatives — "+=20", "-=10", "*=2".

Valeurs Basées sur des Fonctions

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

Easing

Eases intégrés : power1–power4, back, bounce, circ, elastic, expo, sine. Chacun a .in, .out, .inOut.

Valeurs par Défaut

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

Contrôle des 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() (Responsive + Accessibilité)

Exécute la configuration uniquement lorsqu'une requête média correspond ; se réinitialise automatiquement lorsqu'elle cesse de correspondre.

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

Créer une 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 });

Paramètre de Position

Le troisième argument contrôle le placement :

  • Absolu : 1 — à 1s
  • Relatif : "+=0.5" — après la fin ; "-=0.2" — avant la fin
  • Label : "intro", "intro+=0.3"
  • Alignement : "<" — même début que le précédent ; ">" — après la fin du précédent ; "<0.2" — 0.2s après le début du précédent
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // même début que .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0.2s après le début de .b

Labels

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

Options de Timeline

  • paused: true — crée en pause ; appelez .play() pour démarrer.
  • repeat, yoyo — appliquez à toute la timeline.
  • defaults — vars fusionnés dans chaque tween enfant.

Imbrication de Timelines

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

Contrôle de la Lecture

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


Performances

Préférez Transformation et Opacité

Animer x, y, scale, rotation, opacity reste sur le compositeur. Évitez width, height, top, left lorsque les transformations obtiennent le même effet.

will-change

will-change: transform;

Uniquement sur les éléments qui s'animent réellement.

gsap.quickTo() pour les Mises à Jour Fréquentes

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 > Plusieurs Tweens

Utilisez stagger au lieu de tweens séparés avec des délais manuels.

Nettoyage

Mettez en pause ou tuez les animations hors écran.


Références (chargées à la demande)

  • references/effects.md — Effets prêts à l'emploi : texte machine à écrire, visualiseur audio. Lisez-le lorsque vous avez besoin de motifs d'effets prêts à l'emploi pour HyperFrames.

Bonnes Pratiques

  • Utilisez des noms de propriétés en camelCase ; préférez les alias de transformation et autoAlpha.
  • Préférez les timelines plutôt que l'enchaînement avec delay ; utilisez le paramètre de position.
  • Ajoutez des labels avec addLabel() pour un séquençage lisible.
  • Passez les defaults dans le constructeur de la timeline.
  • Stockez la valeur de retour du tween/timeline lorsque vous contrôlez la lecture.

À Ne Pas Faire

  • Animer les propriétés de mise en page (width/height/top/left) lorsque les transformations suffisent.
  • Utiliser à la fois svgOrigin et transformOrigin sur le même élément SVG.
  • Enchaîner les animations avec delay lorsqu'une timeline peut les séquencer.
  • Créer des tweens avant que le DOM n'existe.
  • Sauter le nettoyage — tuez toujours les tweens lorsqu'ils ne sont plus nécessaires.
  • Utiliser des valeurs de répétition infinies dans les compositions HyperFrames. Utilisez des comptes de répétition finis calculés à partir de la durée visible.

Crédits et Références

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.

Skills associés