Communitygithub.com

MattiaIppoliti/tia-skills

Das gesamte Animationswissen für HyperFrames – atomare Bewegungsregeln, mehrphasige Szenen-Blaupausen, Szenenübergänge, Motion-Design-Techniken und sieben Laufzeitadapter. Für jede Bewegungs- oder Animationsaufgabe geeignet.

Was ist tia-skills?

Dieser Skill bündelt das gesamte Animations-Know-how für das HyperFrames-Framework. Er enthält atomare Bewegungsregeln („rules“), die als wiederverwendbare Bausteine für die Komposition dienen, sowie mehrphasige Szenen-Blaupausen („blueprints“) für komplexe Choreografien wie Marken-Reveals oder Social-Proof-Sequenzen. Zusätzlich werden Szenenübergänge, allgemeine Motion-Design-Techniken und insgesamt sieben Laufzeitadapter abgedeckt: GSAP als Standard, Lottie/dotLottie für After-Effects-Exporte, Three.js/WebGL für 3D-Szenen, Anime.js für leichtgewichtiges Tweening, CSS-Keyframes und die Web Animations API (WAAPI) sowie TypeGPU/WebGPU für GPU-beschleunigte Effekte wie Partikel oder Liquid Glass. Der Skill enthält auch ein Skript zur Choreografie-Prüfung („animation-map.mjs“) und 24 benannte Textanimationseffekte. Wichtig: Der Skill basiert auf der aktuellen Motion-Craft-Dokumentation, der Code bezieht sich jedoch auf einen veralteten Runtime (HTML + pausierte GSAP-Timeline). Die aktuelle Ausgabe erfolgt über Remotion + React. Beispiele müssen daher vor der Verwendung in Remotion-Projekten übersetzt werden. Der Skill unterstützt mehrere Laufzeiten gleichzeitig und stellt sicher, dass alle Animationen deterministisch und suchsicher sind.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MattiaIppoliti/tia-skills/tree/HEAD/skills/video/hyperframes-animation

In Ihrer bevorzugten KI fragen

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

Dokumentation

⚠ Vertragsstatus: Craft ist aktuell, Code ist es nicht

Das Ausgabeframework dieses Stacks ist Remotion + React (/hyperframes-core). Die Motion Craft hier gilt weiterhin: Timing, Easing-Auswahl, die Form einer Bewegung, die benannten Regeln und Blaupausen. Der Code ist nicht aktuell: Beispiele und Adapter sind auf die veraltete HTML + pausierte GSAP-Timeline-Laufzeit geschrieben.

Übersetzen Sie beim Lesen:

HierIn Remotion
gsap.fromTo(el, {x:-40}, {x:0, duration:0.5})interpolate(frame, [0, SEC(0.5)], [-40, 0], {…"clamp"})
ease: "back.out(1.7)"spring({frame, fps, config:{damping}}), nach Augenmaß abgestimmt
eine pausierte Timeline bei window.__timelines[id]nichts; jeder Wert ist eine Funktion von useCurrentFrame()
data-start / data-duration auf einem Clip<Sequence from> / durationInFrames, in Frames
ein CSS-Keyframe oder -Transitionframe-abgeleitetes style inline (CSS-Animation rendert nicht)

Fügen Sie niemals ein Beispiel aus diesem Skill unverändert in ein Remotion-Projekt ein.

HyperFrames Animation

Das gesamte Bewegungs-Know-how in einem Skill: Regeln (atomare Rezepte), Blaupausen (mehrphasige Szenenvorlagen), Übergänge (Szene-zu-Szene), Techniken (breitere Motion-Design-Muster) und Adapter (pro Laufzeit-API).

Für den Kompositionsvertrag (Datenattribute, Unterkompositionen, Determinismus) siehe hyperframes-core.

Standard: Atomare Regeln komponieren

Wählen Sie 2-4 Regeln aus rules-index.md, fügen Sie sie mit einer einzigen pausierten GSAP-Timeline zusammen, fertig. Das ist schneller und produziert weniger Code, als mit einer Blaupause zu beginnen.

Blaupause laden, wenn

  • Die Szene zu einer vorhandenen vordefinierten mehrphasigen Vorlage passt (Marken-Reveal, Social-Proof usw.) und die Wiederverwendung ihrer Phasen-Pipeline echte Authoring-Zeit spart
  • Sie ausführbaren, verlässlichen Code für eine komplexe 4-5-Phasen-Choreografie möchten

Blaupausen sind in blueprints-index.md aufgeführt. Jeder Eintrag verweist auf blueprints/<id>.md (Rezept). Lesen Sie diese nicht spekulativ; laden Sie sie, wenn Sie sich bereits für eine szenenübergreifende Orchestrierung entschieden haben.

Navigation

Wenn Sie…Lesen Sie
Ein atomares Bewegungsmuster nach Auslöser/Tag auswählenrules-index.md
Das vollständige HTML/CSS/GSAP-Rezept einer Regel lesenrules/<name>.md
Eine mehrphasige Szenenvorlage auswählenblueprints-index.md
Das vollständige Rezept einer Blaupause lesenblueprints/<id>.md
Einen Szenenübergang erstellen (CSS-gesteuert, zwischen zwei Clips)transitions/overview.md, transitions/catalog.md
Eine breitere Motion-Design-Technik nachschlagentechniques.md
Die Animationskarte einer bestehenden Komposition analysierenscripts/animation-map.mjs
GSAP-API – Timeline/Tweens/Positionsparameteradapters/gsap.md
GSAP – vorgefertigte Effektrezepterules/gsap-effects.md
GSAP – Transforms/Performanceadapters/gsap-transforms-and-perf.md
GSAP – Eases/Staggeradapters/gsap-easing-and-stagger.md
GSAP – Timeline/Labelsadapters/gsap-timeline-and-labels.md
Lottie/dotLottie (After Effects Exporte, window.__hfLottie)adapters/lottie.md
Three.js/WebGL (3D-Szenen, AnimationMixer, hf-seek)adapters/three.md
Anime.js (window.__hfAnime)adapters/animejs.md
CSS-Keyframes (animation-delay/play-state/fill-mode)adapters/css-animations.md
Web Animations API (element.animate(), currentTime seek)adapters/waapi.md
TypeGPU/WebGPU (navigator.gpu, WGSL, Compute-Pipelines)adapters/typegpu.md
HTML-als-Textur + WebGL/GLSL-Post-FX (Live-DOM per drawElementImage erfassen)adapters/html-in-canvas-patterns.md
Benannte Textanimationseffekte (24 IDs per externem animate-text-Skill)adapters/animate-text.md

Eine Laufzeit auswählen

  • GSAP ist die Standardwahl für 95% der Bewegungsarbeit – deckt Timeline-Orchestrierung, Transforms, Easing, Stagger ab. Alle atomaren Regeln in diesem Skill basieren auf GSAP.
  • Lottie wenn ein Asset eine eigene vorgefertigte Timeline hat (typischerweise After Effects Exporte).
  • Three.js für 3D-Szenen, Kamerabewegungen, shadergetriebene Visuals.
  • Anime.js für leichtgewichtiges Tweening, wenn GSAP zu viel ist.
  • CSS für einfache wiederholte Motive, Dekoration, Schimmer – keine JavaScript-Animation kostet.
  • WAAPI für native Browser-Keyframes ohne GSAP-Abhängigkeit.
  • TypeGPU/WebGPU für GPU-gerenderte Leinwände (Partikel, Liquid Glass, benutzerdefinierte Shader).

Mehrere Laufzeiten können in einer Komposition koexistieren. Jede registriert ihre Instanzen im laufzeitspezifischen globalen Objekt, sodass HyperFrames alle in einem Durchlauf suchen kann.

Kritische Einschränkungen

Voraussetzung: hyperframes-core → Unverhandelbare Regeln (einzelne pausierte Timeline, data-duration bestimmt die Länge, kein Math.random/Date.now/performance.now, kein repeat: -1, kein gsap.set beim Seitenladen für Spätszenen-Clips, kein display oder rohes visibility-Tweening, und keine Timeline-Erstellung innerhalb von async/setTimeout/Promise). GSAP autoAlpha und null-dauernde Sichtbarkeitssetzungen an expliziten Timeline-Grenzen bleiben durch den Kern erlaubt. Verwenden Sie diese Ausnahmen nur auf Nicht-Clip-Elementen oder Wrappern innerhalb eines Clips; das Framework besitzt den .clip-Lebenszyklus. Wiederholen Sie hier nicht den vollständigen Vertrag.

Zusätzliche Animations-Craft-Regeln über den Kernvertrag hinaus:

  • Vorkalkulierte Layout-Konstanten – Leiten Sie Positionen niemals zur Tween-Zeit aus getBoundingClientRect() ab. Tween-Zeit-DOM-Messungen desynchronisieren, weil der Renderer parallel abtastet; berechnen Sie Koordinaten einmalig beim Kompositions-Setup und verwenden Sie sie wieder.
  • Räumliche Bewegungen verwenden ausschließlich GSAP-Transform-Aliase (x, y, scale, rotation). Die Zulässigkeitsliste des Kerns erlaubt auch opacity/color/backgroundColor/borderRadius für nicht-räumliche Eigenschafts-Tweens – aber niemals width/height/top/left für Layoutänderungen.

Skripte

node skills/hyperframes-animation/scripts/animation-map.mjs <kompositionsverzeichnis> \
  --out <kompositionsverzeichnis>/.hyperframes/anim-map

Liest jede GSAP-Timeline aus, die auf window.__timelines registriert ist, listet Tweens auf, sammelt Bounding-Boxen, berechnet Flags und gibt animation-map.json aus. Verwenden Sie dies, um die Choreografie nach dem Authoring zu prüfen (tote Zonen, Stagger-Konsistenz, Lebenszyklus-Warnungen).

animation-map.mjs löst Hilfspakete zuerst aus dem aktuellen Projekt auf und kann dann die gebündelte HyperFrames-Paketversion bootstrappen. Setzen Sie HYPERFRAMES_SKILL_PKG_VERSION=<version> nur, wenn Sie den Skill außerhalb des gebündelten CLI/Skill-Installs ausführen und diese Bootstrap-Version explizit festlegen müssen.

Siehe auch

  • hyperframes-core – Kompositionsstruktur, Datenattribute, Unterkompositionen, deterministischer Rendervertrag
  • hyperframes-creative – Paletten, Typografie, Erzählung, Beat-Planung (nicht-animatorische kreative Richtung)
  • hyperframes-cli – npx hyperframes lint / check / snapshot / preview / render

Individual skills in this repo

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

MattiaIppoliti/tia-skills

The technique catalog: five velocity-matched SEAMS (zoom-through, INVERSE zoom-through, cut-the-curve, waterfall cut, rack-focus blur-cut) plus the two in-scene techniques — waterfall ENTRY (staggered arrival cascades for title cards / segment openers) and the nudge curve (slow-fast-slow three-phase group slides). Covers partial-travel (~12% of frame) velocity matching via mirrored power4 eases, the Z scale-sign rule, size-scaled blur (10px text / 18-20px full-frame), word-by-word staggered cuts, cascade pacing by element weight, and the 10/65/25 slide ratio. Read before authoring any transition, text-beat handoff, kinetic text entry, or group reposition. [depth, zoom, inverse-zoom, scale-sign, mirrored-zoom, rack-focus, pacing, velocity, cut-the-curve, waterfall, stagger, cascade, kinetic-text, title-card, segment-opener, nudge, slide, easing, group-motion, z-depth, motion-graphics, cinematic, transition, blur, directional-continuity]

MattiaIppoliti/tia-skills

Import Figma content into a HyperFrames composition — rendered assets, brand tokens, components, storyboard sections → reconstructed motion (frames read as states, not slides) (REST/CLI), connector-assisted motion when available, and shaders from a connector or native export. Use when the user pastes a figma.com link or asks to bring a Figma design, frame, logo, brand, or animation into a video/composition.

MattiaIppoliti/tia-skills

Author or edit a custom HyperFrames composition when no specialized workflow fits, or when BRIEF.md sets flow: companion. Use for longer or multi-scene pieces, brand and sizzle reels, montages, static loops, static title cards, footage remixes, and freeform builds. Use motion-graphics instead for a short unnarrated motion-first unit, including an animated title. Route fresh creation through hyperframes before using this skill.

MattiaIppoliti/tia-skills

Use when audio already placed in a HyperFrames composition needs to be mixed: fade-in/fade-out, crossfade, track gain or volume, volume automation, ducking, a music bed that fights a voiceover (voiceover carve), effects on a track (EQ, compressor, limiter, gate, saturation, delay, reverb, chorus, phaser, bitcrush), or automation envelopes drawn on a track's volume or any effect parameter. Don't use for sourcing or generating audio — finding BGM, SFX, or making a voiceover is `/media-use`. Don't use for clip timing or track layout, which is `/hyperframes-core`.

MattiaIppoliti/tia-skills

Drive the Remotion CLI development loop: scaffold, studio, type-check, compositions, still probes, single and batch render, bundle, Lambda and Cloud Run rendering, benchmark, versions, upgrade, and GPU checks. Also use when diagnosing a build or render failure, or when looking for a capability the retired HyperFrames CLI used to own.

MattiaIppoliti/tia-skills

The composition contract for building one renderable Remotion project. Use for project structure, `<Composition>` registration, `<Sequence>` timing, layer/track ordering, scene components, props and schemas, framework-owned media playback, deterministic-render rules, and validation. Also covers Tailwind projects and the STORYBOARD.md / SCRIPT.md plan formats. Read before writing composition code.

Verwandte Skills