Communitygithub.com

nathankerai/hyperframes-student-kit

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, contrôle de lecture) et performance (transforms, will-change, quickTo). À utiliser lors de l'écriture d'animations GSAP dans des compositions HyperFrames.

Qu'est-ce que hyperframes-student-kit ?

Ce kit est une référence complète et structurée pour utiliser GSAP (GreenSock Animation Platform) dans l'environnement HyperFrames. Il décrit en détail les méthodes de tweening de base (gsap.to, from, fromTo), les propriétés CSS transformées, les fonctions d'assouplissement (easing), la création de timelines avec paramètres de position, labels et imbrication, ainsi que les bonnes pratiques pour optimiser les performances (préférer les transformations et l'opacité, utiliser will-change, gsap.quickTo pour les mises à jour fréquentes). Il est conçu pour être utilisé directement par un agent IA (comme Claude Code, Cursor ou Codex) afin de générer des animations GSAP fiables et performantes dans des projets HyperFrames. Le document inclut également des références vers des effets prêts à l'emploi (comme l'effet machine à écrire ou le visualiseur audio) disponibles dans un fichier séparé.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/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 depuis l'état actuel vers vars. La plus courante.
  • gsap.from(targets, vars) — anime depuis 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 de vars

  • 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 ou -1 pour l'infini. 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 brute transform :

Propriété GSAPÉquivalent
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y en %
scale, scaleX, scaleYscale
rotationrotate (deg)
rotationX, rotationYrotate 3D
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — préférez-le à opacity. À 0 : définit aussi visibility: hidden.
  • Variables CSS — "--hue": 180.
  • svgOrigin (SVG uniquement) — origine dans 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é 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,
});

Assouplissement (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 règle média correspond ; la rétablit 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().


Performance

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 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 lorsque vous avez besoin de modèles d'effets prêts pour HyperFrames.

Bonnes pratiques

  • Utilisez les noms de propriétés en camelCase ; préférez les alias de transformation et autoAlpha.
  • Préférez les timelines à l'enchaînement avec delay ; utilisez le paramètre de position.
  • Ajoutez des labels avec addLabel() pour un séquençage lisible.
  • Passez les valeurs par défaut dans le constructeur de la timeline.
  • Conservez la valeur de retour du tween/timeline pour contrôler 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 des animations avec delay alors qu'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.

Individual skills in this repo

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

nateherkai/hyperframes-student-kit

Agent 2 of the video editing pipeline. Finds and removes spoken mistakes — stutters, repeated words, false starts, and retakes (re-recorded lines) — from a talking-head recording. Use after cut-silences, when asked to cut mistakes, remove stutters / repeats / filler restarts, clean up flubs, or keep the best take. Works review-gated: it proposes every cut with context and a reason for approval, then renders only the approved cuts via ffmpeg. Requires a word-level transcript.

nateherkai/hyperframes-student-kit

Agent 1 of the video editing pipeline. Removes silences and dead air from a talking-head recording. Use when asked to cut silences, trim pauses, remove dead air / gaps, or tighten the pacing of a raw video, given a word-level transcript. Produces an edit list (EDL), a re-timed transcript for downstream agents, and optionally the cut video via ffmpeg. Does NOT cut mistakes, repeats, or false starts — that is the cut-mistakes agent.

nateherkai/hyperframes-student-kit

Edit a raw talking-head video through transcription, silence trimming, mistake review, visual storytelling, motion graphics, and verified HyperFrames rendering. Use for a complete edit; route a single requested operation directly to its specialist skill.

nateherkai/hyperframes-student-kit

HyperFrames CLI tool — hyperframes init, lint, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting or validating compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

nateherkai/hyperframes-student-kit

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

nateherkai/hyperframes-student-kit

Plan, write, time, style, and validate motion-graphic beats for long-form talking-head HyperFrames videos. Use when Codex is asked to add or improve visual beats, glassmorphism lower thirds, crumpled-paper full-screen takeovers, transcript-synced callouts, pacing coverage, YouTube retention graphics, or render-ready overlays in an existing HyperFrames video project.

nateherkai/motion-showreel

Build 10–30s motion-design showreels in the style of Nate's Opus 5.5 CLAUDE/MOTION REEL — brand motif chapters, HUD, BPM-locked cuts, logo lockup.

nateherkai/website-to-hyperframes

Capture a website URL and produce a HyperFrames promo/product-tour video — site → finished marketing video outcome.

Skills associés