Communitygithub.com

rbrown101010/codex-marketing-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). Utilisez-le pour écrire des animations GSAP dans les compositions HyperFrames.

Qu'est-ce que codex-marketing-skills ?

Ce skill est une référence complète pour utiliser GSAP (GreenSock Animation Platform) dans le cadre des compositions HyperFrames. Il fournit des instructions détaillées sur les méthodes de tweening de base (gsap.to, from, fromTo, set), les propriétés communes (duration, delay, ease, stagger, etc.), les alias de transformation préférés pour les performances, et les fonctions d'assouplissement (easing). Il explique également comment utiliser les timelines pour séquencer des animations avec le paramètre de position, les labels et l'imbrication, ainsi que les contrôles de lecture (play, pause, reverse, kill). Des sections dédiées à l'optimisation des performances (préférer les transformations, will-change, gsap.quickTo) et aux bonnes pratiques (nettoyage des animations, utilisation de defaults) sont incluses. Ce skill est conçu pour un usage sur les plateformes d'agents AI comme Codex (OpenAI), Claude Code (Anthropic), et Cursor (Anysphere). Il aide à générer des animations GSAP fiables et performantes en évitant les erreurs courantes comme l'animation de propriétés de layout ou l'utilisation de délais manuels.

Compatible avec~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/rbrown101010/codex-marketing-skills/tree/HEAD/plugin-workflows/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

Méthodes de tweening principales

  • gsap.to(targets, vars) — anime de l'état actuel vers vars. La plus courante.
  • 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 les noms de propriétés en camelCase (par ex. backgroundColor, rotationX).

Propriétés communes (vars)

  • duration — en secondes (défaut 0.5).
  • delay — en secondes avant le début.
  • ease — "power1.out" (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 (défaut), true, ou "auto".
  • repeat — nombre ou -1 pour infini. yoyo — alterne la direction avec repeat.
  • onComplete, onStart, onUpdate — callbacks.
  • immediateRender — true par défaut pour from()/fromTo(). Mettez false sur des 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 (deg)
rotationX, rotationYrotation 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — préférez-le à opacity. À 0 : définit également visibility: hidden.
  • Variables CSS — "--hue": 180.
  • svgOrigin (SVG uniquement) — origine dans l'espace de coordonnées SVG global. Ne pas combiner avec transformOrigin.
  • Rotation directionnelle — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" ou séparé par des virgules ; supprime les styles en ligne à la fin.
  • Valeurs relatives — "+=20", "-=10", "*=2".

Valeurs basées sur une fonction

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

Assouplissement (easing)

Easing intégrés : power1–power4, back, bounce, circ, elastic, expo, sine. Chacun avec .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 media query 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 — s'applique à toute la timeline.
  • defaults — vars fusionnées 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 lecture

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


Performances

Privilégier les transformations et l'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 plutôt que de nombreux 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 ceci lorsque vous avez besoin de patterns d'effets prêts pour HyperFrames.

Bonnes pratiques

  • Utilisez les noms de propriétés en camelCase ; privilégiez les alias de transformation et autoAlpha.
  • Préférez les timelines à l'enchaînement avec des délais ; utilisez le paramètre de position.
  • Ajoutez des labels avec addLabel() pour un séquencement lisible.
  • Passez les valeurs par défaut dans le constructeur de timeline.
  • Stockez la valeur de retour du tween/timeline lorsque vous contrôlez la lecture.

À ne pas faire

  • Animer les propriétés de layout (width/height/top/left) lorsque les transformations suffisent.
  • Utiliser à la fois svgOrigin et transformOrigin sur le même élément SVG.
  • Enchaîner des animations avec un délai alors qu'une timeline pourrait les séquencer.
  • Créer des tweens avant que le DOM n'existe.
  • Négliger le nettoyage — tuez toujours les tweens lorsqu'ils ne sont plus nécessaires.

Individual skills in this repo

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

Skills associés