Communitygithub.com

rbrown101010/codex-marketing-skills

GSAP-Animation-Referenz für HyperFrames. Deckt gsap.to(), from(), fromTo(), Easing, Stagger, Defaults, Timelines (gsap.timeline(), Positionsparameter, Labels, Verschachtelung, Wiedergabe) und Performance (Transforms, will-change, quickTo) ab. Verwenden Sie dies beim Schreiben von GSAP-Animationen in HyperFrames-Kompositionen.

Was ist codex-marketing-skills?

Diese Fähigkeit bietet eine umfassende GSAP-Referenz (GreenSock Animation Platform), die speziell auf die Erstellung von Animationen innerhalb von HyperFrames-Kompositionen zugeschnitten ist. Sie dokumentiert die zentralen Tween-Methoden (`to`, `from`, `fromTo`, `set`), die wichtigsten Eigenschaften wie `duration`, `ease`, `stagger` und `repeat`, sowie die Verwendung von GSAP-spezifischen Transform-Aliasen (`x`, `y`, `scale`, `rotation`) und `autoAlpha` für optimale Leistung. Die Referenz behandelt fortgeschrittene Konzepte wie Timelines inklusive Positionsparametern und Labels, Verschachtelung, die Erstellung responsiver und zugänglicher Animationen mit `gsap.matchMedia()`, sowie Performance-Optimierung durch `gsap.quickTo()`, `will-change` und richtiges Aufräumen. Entwickler, die mit Claude Code, Cursor oder Codex arbeiten, erhalten damit eine sofort einsetzbare, detaillierte Dokumentation, um effiziente, lesbare und compositor-freundliche GSAP-Animationen in HyperFrames zu schreiben.

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

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

Häufige Variablen

  • duration — Sekunden (Standard 0,5).
  • delay — Sekunden vor dem 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 mit Wiederholung.
  • onComplete, onStart, onUpdate — Callbacks.
  • immediateRender — Standard true für from()/fromTo(). Setzen Sie false bei späteren Tweens, die dieselbe Eigenschaft und dasselbe Element ansprechen, um Überschreiben zu vermeiden.

Transforms und CSS

Bevorzugen Sie GSAPs Transform-Aliase gegenüber einem rohen transform-String:

GSAP-EigenschaftÄquivalent
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y in %
scale, scaleX, scaleYscale
rotationrotate (Grad)
rotationX, rotationY3D-Rotation
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — Bevorzugt gegenüber opacity. Bei 0 wird auch visibility: hidden gesetzt.
  • CSS-Variablen — "--hue": 180.
  • svgOrigin (nur SVG) — Ursprung im globalen SVG-Koordinatenraum. Nicht mit transformOrigin kombinieren.
  • Gerichtete Rotation — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" oder durch Komma getrennt; 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 Easing-Funktionen: power1–power4, back, bounce, circ, elastic, expo, sine. Jedes hat .in, .out, .inOut.

Standardwerte

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

Führt das Setup nur aus, wenn ein Media Query zutrifft; macht es automatisch rückgängig, wenn es 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; ">" — nachdem vorheriges endet; "<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 — pausiert erzeugen; .play() zum Starten aufrufen.
  • repeat, yoyo — auf die gesamte Timeline anwenden.
  • defaults — Variablen, die in jedes untergeordnete Tween eingefügt werden.

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. Vermeiden Sie 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 Aktualisierungen

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

Verwenden Sie stagger anstelle von separaten Tweens mit manuellen Verzögerungen.

Aufräumen

Animationen, die nicht mehr sichtbar sind, pausieren oder beenden.


Referenzen (bei Bedarf geladen)

  • references/effects.md — Direkt einsetzbare Effekte: Schreibmaschinentext, Audio-Visualizer. Lesen Sie diese, wenn Sie fertige Effektmuster für HyperFrames benötigen.

Best Practices

  • Verwenden Sie camelCase-Eigenschaftsnamen; bevorzugen Sie Transform-Aliase und autoAlpha.
  • Bevorzugen Sie Timelines gegenüber Verkettung mit delay; verwenden Sie den Positionsparameter.
  • Fügen Sie Labels mit addLabel() für lesbare Abläufe hinzu.
  • Übergeben Sie Standardwerte an den Timeline-Konstruktor.
  • Speichern Sie den Rückgabewert von Tween/Timeline, wenn Sie die Wiedergabe steuern möchten.

Nicht tun

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

Individual skills in this repo

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

Verwandte Skills