Communitygithub.com

nateherkai/hyperframes-student-kit

GSAP-Animationsreferenz für HyperFrames. Enthält gsap.to(), from(), fromTo(), Easing, Stagger, Defaults, Timelines (gsap.timeline(), Positionsparameter, Labels, Verschachtelung, Wiedergabe) und Performance (Transforms, will-change, quickTo). Verwenden beim Schreiben von GSAP-Animationen in HyperFrames-Kompositionen.

Was ist hyperframes-student-kit?

Dieses Skill (nateherkai/hyperframes-student-kit) dient als vollständige GSAP-Animationsreferenz, die speziell für die Verwendung innerhalb von HyperFrames-Kompositionen konzipiert ist. Es deckt die gesamte Bandbreite der GSAP-Kernmethoden ab, einschließlich gsap.to(), from(), fromTo() und set(), sowie die Konfiguration von Eigenschaften wie Dauer, Verzögerung, Easing, Stagger und Callbacks. Der Fokus liegt auf praxisnahen, performanten Animationen: Das Skill empfiehlt die Verwendung von Transform-Aliasen (z.B. x, y, scale, rotation) anstelle von rohen CSS-Eigenschaften und erklärt, wie man mit gsap.quickTo() häufige Updates effizient gestaltet. Es behandelt ausführlich das Timing und die Sequenzierung mit gsap.timeline(), inklusive des Positionsparameters, Labels und der Verschachtelung von Timelines. Darüber hinaus werden responsive und barrierefreie Animationen mit gsap.matchMedia() sowie Best Practices zur Performance-Optimierung (will-change, Cleanup) vermittelt. Das Skill ist plattformunabhängig für alle Agenten geeignet, die GSAP-Code generieren sollen, und bietet eine klare, sofort anwendbare Referenz mit vielen Codebeispielen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/nateherkai/hyperframes-student-kit/tree/HEAD/.agents/skills/gsap

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

GSAP

Kern-Tween-Methoden

  • gsap.to(targets, vars) — animiert vom aktuellen Zustand zu vars. Am häufigsten verwendet.
  • gsap.from(targets, vars) — animiert von vars zum aktuellen Zustand (Eingänge).
  • gsap.fromTo(targets, fromVars, toVars) — expliziter Start- und Endzustand.
  • gsap.set(targets, vars) — wendet sofort an (Dauer 0).

Verwende immer camelCase-Eigenschaftsnamen (z. B. backgroundColor, rotationX).

Häufige vars

  • duration — Sekunden (Standard 0,5).
  • delay — Sekunden vor Start.
  • ease — "power1.out" (Standard), "power3.inOut", "back.out(1.7)", "elastic.out(1, 0.3)", "none".
  • stagger — Zahl 0.1 oder Objekt: { amount: 0.3, from: "center" }, { each: 0.1, from: "random" }.
  • overwrite — false (Standard), true oder "auto".
  • repeat — Zahl oder -1 für unendlich. yoyo — wechselt die Richtung bei Wiederholung.
  • onComplete, onStart, onUpdate — Callbacks.
  • immediateRender — Standard true bei from()/fromTo(). Setze auf false bei späteren Tweens, die dieselbe Eigenschaft und dasselbe Element ansteuern, um Überschreiben zu vermeiden.

Transforms und CSS

Bevorzuge GSAPs Transform-Aliasnamen gegenüber rohem transform-String:

GSAP-EigenschaftEntsprechung
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y in %
scale, scaleX, scaleYscale
rotationrotate (deg)
rotationX, rotationY3D-Rotation
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — bevorzugen gegenüber opacity. Bei 0: setzt auch visibility: hidden.
  • CSS-Variablen — "--hue": 180.
  • svgOrigin (nur SVG) — Ursprung im globalen SVG-Koordinatensystem. Nicht mit transformOrigin kombinieren.
  • Richtungsrotation — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" oder kommasepariert; entfernt Inline-Stile bei Abschluss.
  • Relative Werte — "+=20", "-=10", "*=2".

Funktionsbasierte Werte

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

Easing

Eingebaute Eases: power1–power4, back, bounce, circ, elastic, expo, sine. Jeder hat .in, .out, .inOut.

Defaults

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

Tweens steuern

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 + Barrierefreiheit)

Führt Setup nur aus, wenn eine Media Query zutrifft; setzt automatisch zurück, wenn sie nicht mehr zutrifft.

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

Eine Timeline erstellen

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

Positionsparameter

Das dritte Argument steuert die Platzierung:

  • Absolut: 1 — bei 1s
  • Relativ: "+=0.5" — nach Ende; "-=0.2" — vor Ende
  • Label: "intro", "intro+=0.3"
  • Ausrichtung: "<" — gleicher Start wie vorheriges; ">" — nach Ende des vorherigen; "<0.2" — 0,2s nach Start des vorherigen
tl.to(".a", { x: 100 }, 0);
tl.to(".b", { y: 50 }, "<"); // gleicher Start wie .a
tl.to(".c", { opacity: 0 }, "<0.2"); // 0,2s nach Start von .b

Labels

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

Timeline-Optionen

  • paused: true — erzeugt pausiert; rufe .play() auf, um zu starten.
  • repeat, yoyo — auf die gesamte Timeline anwenden.
  • defaults — vars werden in jeden Kind-Tween übernommen.

Timelines verschachteln

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

Wiedergabesteuerung

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


Performance

Transform und Opacity bevorzugen

Das Animieren von x, y, scale, rotation, opacity bleibt auf dem Compositor. Vermeide width, height, top, left, wenn Transforms den gleichen Effekt erzielen.

will-change

will-change: transform;

Nur auf Elementen, die tatsächlich animieren.

gsap.quickTo() für häufige Updates

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

Verwende stagger anstelle separater Tweens mit manuellen Verzögerungen.

Bereinigung

Pausiere oder beende Animationen, die nicht mehr sichtbar sind.


Referenzen (auf Anfrage geladen)

  • references/effects.md — Fertige Effekte: Schreibmaschinentext, Audio-Visualizer. Lies dies, wenn du vorgefertigte Effektmuster für HyperFrames benötigst.

Best Practices

  • Verwende camelCase-Eigenschaftsnamen; bevorzuge Transform-Aliasnamen und autoAlpha.
  • Bevorzuge Timelines gegenüber Verkettung mit delay; verwende den Positionsparameter.
  • Füge Labels mit addLabel() für lesbare Sequenzen hinzu.
  • Übergib defaults in den Timeline-Konstruktor.
  • Speichere den Rückgabewert von Tween/Timeline, wenn du die Wiedergabe steuern möchtest.

Nicht tun

  • Layout-Eigenschaften (width/height/top/left) animieren, wenn Transforms ausreichen.
  • svgOrigin und transformOrigin auf demselben SVG-Element verwenden.
  • Animationen mit delay verketten, wenn eine Timeline sie sequenzieren kann.
  • Tweens erstellen, bevor das DOM existiert.
  • Bereinigung überspringen — beende Tweens immer, wenn sie nicht mehr benötigt werden.

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.

Verwandte Skills