Communitygithub.com

govindgoel2001/video-editing-toolkit

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

Was ist video-editing-toolkit?

Diese Skill bietet eine umfassende Referenz für die GSAP-Animationbibliothek, zugeschnitten auf die Arbeit mit dem HyperFrames-Framework. Sie deckt alle Kern- Tween-Methoden (gsap.to(), from(), fromTo(), set()), wichtige Animationsparameter (Dauer, Verzögerung, Easing, Stagger, Wiederholungen), CSS-Transform- Aliase (x, y, scale, rotation) und fortgeschrittene Funktionen wie funktionsbasierte Werte und das matchMedia() für responsives Design und Barrierefreiheit ab. Für die Erstellung von Sequenzen enthält die Skill detaillierte Informationen zu Timelines, inklusive Labels, Verschachtelung und präziser Steuerung über den Positionsparameter für zeitliche Abhängigkeiten. Ein besonderer Fokus liegt auf Performance-Optimierung: Die Skill empfiehlt die Animation von Transform- und Opacity-Eigenschaften zur Auslagerung auf den Compositor, die Verwendung von gsap.quickTo() für häufige Aktualisierungen (z.B. bei Mausbewegungen) und den Einsatz von Stagger anstelle vieler einzelner Tweens. Abschließend gibt sie klare Best Practices und häufige Fehlerhinweise (Do Nots), um sauberen, effizienten und wartbaren Animationscode zu gewährleisten, und verweist auf eine Referenzdatei (effects.md) für vorgefertigte Effektmuster.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/govindgoel2001/video-editing-toolkit/tree/HEAD/vendor/hyperframes-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 (Einblendungen).
  • 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 Parameter (vars)

  • duration — Sekunden (Standard: 0.5).
  • delay — Sekunden Verzögerung 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 mit repeat die Richtung.
  • onComplete, onStart, onUpdate — Callback-Funktionen.
  • immediateRender — Standard true bei from()/fromTo(). Setzen Sie bei späteren Tweens, die dieselbe Eigenschaft und dasselbe Element anvisieren, false, um Überschreibungen zu vermeiden.

Transforms und CSS

Bevorzugen Sie GSAPs Transform-Aliase 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-Rotation
skewX, skewYskew
transformOrigintransform-origin
  • autoAlpha — bevorzugen Sie es gegenüber opacity. Bei 0: setzt auch visibility: hidden.
  • CSS-Variablen — "--hue": 180.
  • svgOrigin (nur SVG) — globaler SVG-Koordinatenursprung. Nicht mit transformOrigin kombinieren.
  • Gerichtete Rotation — "360_cw", "-170_short", "90_ccw".
  • clearProps — "all" oder kommagetrennt; entfernt inline-Styles bei Abschluss.
  • Relative Werte — "+=20", "-=10", "*=2".

Funktionsbasierte Werte

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

Easing

Eingebaute Ease-Funktionen: power1–power4, back, bounce, circ, elastic, expo, sine. Jede hat .in, .out, .inOut.

Standardwerte (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() (Responsives Design + Barrierefreiheit)

Führt eine Konfiguration nur aus, wenn ein Media-Query zutrifft; macht sie automatisch rückgängig, wenn das Query 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 vorheriger; ">" — 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 — pausiert erstellen; .play() aufrufen zum Starten.
  • repeat, yoyo — auf die gesamte Timeline anwendbar.
  • defaults — Variablen, die in jeden untergeordneten 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

Animation von x, y, scale, rotation, opacity verbleibt im Compositor. Vermeiden Sie width, height, top, left, wenn Transforms denselben Effekt erzielen.

will-change

will-change: transform;

Nur für Elemente, 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 anstelle vieler Tweens

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

Bereinigung

Pausieren Sie Animationen außerhalb des sichtbaren Bereichs oder killen Sie sie.


Referenzen (bedarfsweise geladen)

  • references/effects.md — Fertige Effekte: Schreibmaschinentext, Audio-Visualizer. Lesen Sie dies, wenn Sie vorgefertigte 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 Sequenzierung hinzu.
  • Geben Sie Standardwerte (defaults) an den Timeline-Konstruktor weiter.
  • Speichern Sie den Rückgabewert von Tween/Timeline, wenn Sie die Wiedergabe steuern möchten.

Nicht tun (Do Not)

  • 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 — killen Sie immer Tweens, wenn sie nicht mehr benötigt werden.

Individual skills in this repo

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

govindgoel2001/video-editing-toolkit

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

govindgoel2001/video-editing-toolkit

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.

govindgoel2001/video-editing-toolkit

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

govindgoel2001/video-editing-toolkit

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

govindgoel2001/video-editing-toolkit

Edit any video by conversation. Transcribe, cut, color grade, generate overlay animations, burn subtitles — for talking heads, montages, tutorials, travel, interviews. No presets, no menus. Ask questions, confirm the plan, execute, iterate, persist. Production-correctness rules are hard; everything else is artistic freedom.

govindgoel2001/video-editing-toolkit

Production pipeline for mathematical and technical animations using Manim Community Edition. Creates 3Blue1Brown-style explainer videos, algorithm visualizations, equation derivations, architecture diagrams, and data stories. Use when users request: animated explanations, math animations, concept visualizations, algorithm walkthroughs, technical explainers, 3Blue1Brown style videos, or any programmatic animation with geometric/mathematical content.

Verwandte Skills