Communitygithub.com

shengdabai/Tony-Claude-Code-Skills

GSAP-Animationsreferenz 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, wenn Sie GSAP-Animationen in HyperFrames-Kompositionen schreiben.

Was ist Tony-Claude-Code-Skills?

Dieses Skill bietet eine umfassende GSAP-Referenz, die speziell für die Verwendung mit HyperFrames optimiert ist, einem Framework zur Erstellung von Videokompositionen. Es definiert einen klaren Vertrag (Contract) für die Integration: Entwickler müssen pausierte Timelines synchron erstellen, sie im globalen `window.__timelines`-Objekt mit der exakten `data-composition-id` registrieren und HyperFrames das Steuern der Wiedergabe überlassen. Das Skill deckt alle wichtigen GSAP-Konzepte ab: Kern-Tween-Methoden (`gsap.to()`, `from()`, `fromTo()`), Eigenschaften (camelCase), Easing-Funktionen, Stagger, Defaults, Timeline-Erstellung mit Positionsparametern und Labels, sowie verschachtelte Timelines und Wiedergabesteuerung. Es enthält zudem Best Practices zur Performanceoptimierung, wie die Verwendung von Transform-Aliasen, `will-change`, `gsap.quickTo()` für häufige Updates und die Vermeidung von Layout-Animationen. Zusätzlich werden wichtige HyperFrames-spezifische Regeln hervorgehoben: keine unendlichen Wiederholungen, keine Timelines in async Code oder Event-Handlern, und endliche Schleifen. Das Skill ergänzt eine Referenz auf Effektvorlagen (`references/effects.md`) sowie Quellenangaben und Links zur offiziellen GSAP-Dokumentation.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

GSAP

HyperFrames-Vertrag

HyperFrames steuert GSAP über seinen gsap-Laufzeitadapter. Erstellen Sie synchron eine pausierte Timeline, registrieren Sie sie mit der exakten data-composition-id auf window.__timelines und lassen Sie HyperFrames sie abspielen.

<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; // Schlüssel muss mit data-composition-id auf dem Kompositionswurzelelement übereinstimmen
</script>
  • Der Registrierungsschlüssel muss mit der data-composition-id des Kompositionswurzelelements übereinstimmen.
  • Rufen Sie tl.play() nicht für rendernotwendige Bewegungen auf.
  • Erstellen Sie Timelines nicht innerhalb von asynchronem Code, Timern oder Event-Handlern.
  • Halten Sie Schleifen endlich. HyperFrames rendert endliche Videodauern.

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 Endpunkt.
  • gsap.set(targets, vars) — Wird sofort angewendet (Dauer 0).

Verwenden Sie 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 — Endliche Zahl; niemals -1 in HyperFrames. Berechnen Sie Wiederholungen basierend auf der sichtbaren Dauer. yoyo — Wechselt die Richtung bei Wiederholung.
  • onComplete, onStart, onUpdate — Rückruffunktionen.
  • immediateRender — Standard true bei from()/fromTo(). Setzen Sie false bei späteren Tweens, die dieselbe Eigenschaft und dasselbe Element anvisieren, um Überschreiben zu vermeiden.

Transforms und CSS

Bevorzugen Sie GSAPs Transform-Aliasnamen gegenüber rohem transform-String:

GSAP-EigenschaftÄquivalent
x, y, ztranslateX/Y/Z (px)
xPercent, yPercenttranslateX/Y in %
scale, scaleX, scaleYscale
rotationrotate (Grad)
rotationX, rotationY3D-Rotate
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — Bevorzugen Sie es gegenüber opacity. Bei 0: Setzt ebenfalls visibility: hidden.
  • CSS-Variablen — "--hue": 180.
  • svgOrigin (nur SVG) — Globaler SVG-Koordinatenraum-Ursprung. Nicht mit transformOrigin kombinieren.
  • Richtungsrotation — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" oder kommagetrennt; 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. Jede 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() (Responsiv + Barrierefreiheit)

Führt Setup nur aus, wenn eine Media Query zutrifft; wird automatisch rückgängig gemacht, 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 vorherige; ">" — nach dem Ende der vorherigen; "<0.2" — 0.2s nach Start der 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 — Erstellt pausiert; rufen Sie .play() auf, um zu starten.
  • repeat, yoyo — Auf die gesamte Timeline anwendbar.
  • defaults — Vars werden in jeden untergeordneten Tween eingemischt.

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 denselben Effekt erzielen.

will-change

will-change: transform;

Nur auf Elementen, die tatsächlich animiert werden.

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 statt vieler Tweens

Verwenden Sie stagger anstelle separater Tweens mit manuellen Verzögerungen.

Bereinigung

Pausieren oder beenden Sie Animationen, die nicht mehr sichtbar sind.


Referenzen (bei Bedarf geladen)

  • references/effects.md — Fertige Effekte: Schreibmaschinentext, Audio-Visualizer. Lesen Sie dies, wenn Sie gebrauchsfertige Effektmuster für HyperFrames benötigen.

Best Practices

  • Verwenden Sie camelCase-Eigenschaftsnamen; bevorzugen Sie Transform-Aliasnamen und autoAlpha.
  • Bevorzugen Sie Timelines gegenüber Verkettungen mit delay; verwenden Sie den Positionsparameter.
  • Fügen Sie Labels mit addLabel() für lesbare Sequenzen hinzu.
  • Übergeben Sie defaults 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.
  • Gleichzeitig svgOrigin und transformOrigin auf demselben SVG-Element verwenden.
  • Animationen mit delay verketten, wenn eine Timeline sie sequenzieren kann.
  • Tweens erstellen, bevor das DOM existiert.
  • Keine Bereinigung durchführen — beenden Sie Tweens immer, wenn sie nicht mehr benötigt werden.
  • Unendliche Wiederholungswerte in HyperFrames-Kompositionen verwenden. Verwenden Sie endliche Wiederholungszahlen, die aus der sichtbaren Dauer berechnet werden.

Quellen und Referenzen

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.

Verwandte Skills