Communitygithub.com

AlessandroFare/fluxychat

Verwenden Sie dies, wenn eine HyperFrames-Komposition suchsichere 2D/3D-Keyframes, GSAP-Timelines, CSS-Keyframes, Anime.js, WAAPI, FLIP, Pfade, Masken, SVG-Morph/Zeichnen, Textspuren, 3D-Tiefe oder HyperFrames-Keyframes-Diagnose benötigt. Nicht verwenden für übergreifende Szenenstrategie, Markendesign, Medienbeschaffung, Untertitel oder allgemeine Videoplanung.

Was ist fluxychat?

Diese Fähigkeit definiert den Standard für suchsichere Keyframes in HyperFrames-Kompositionen. Sie stellt sicher, dass animierte Zustände jederzeit exakt über die Zeitachse ansteuerbar sind, und vermeidet nicht-deterministische Laufzeiteffekte. Die Fähigkeit unterstützt eine Vielzahl von Mechanismen, darunter GSAP-Timelines, CSS-Keyframes, Anime.js, WAAPI, FLIP, SVG-Morphing und Zeichnen, sowie DOM-3D- und WebGL-Keyframes. Sie liefert klare Laufzeitregeln, einen Vertrag für sichtbare Zustände und eine detaillierte Anleitung zur Auswahl des kleinstmöglichen Mechanismus, der die gestellte Aufgabe beweist. Zusätzlich enthält sie umfangreiche Diagnosewerkzeuge über die CLI (z. B. `hyperframes keyframes`, `--shot`, `--ghost`) und spezifische Fehlerbehandlungsroutinen für häufige Probleme wie Endpunkt-Animationen oder Identitätsbrüche. Kurz gesagt, es ist die zentrale Anlaufstelle für präzise, überprüfbare Animationen innerhalb von HyperFrames.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/hyperframes-keyframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Keyframes

Keyframes sind ein Pose-Vertrag: sichtbare Zustände, kontinuierliche Subjektidentität, suchsichere Laufzeit, verifizierte Pixel.

Verwenden Sie hyperframes-animation für übergreifende Szenenrezepte. Verwenden Sie hyperframes-cli für die vollständige Befehlsdokumentation. Verwenden Sie references/keyframe-patterns.md nur, wenn Sie Implementierungsmechanismen auswählen, nicht den visuellen Stil.

Vorgehen

  1. Identifizieren Sie das animierte Subjekt, die sichtbaren Zustände, den Endzustand und die Laufzeit.
  2. Wählen Sie den kleinsten Mechanismus, der die Anforderung beweist. Lesen Sie references/keyframe-patterns.md nur, wenn der Mechanismus unklar ist.
  3. Erstellen Sie suchsichere Keyframes in der deklarierten Laufzeit. Bauen Sie synchron auf und registrieren Sie die Laufzeitinstanz.
  4. Überprüfen Sie mit hyperframes lint, hyperframes check, hyperframes keyframes, einem fokussierten --shot und Snapshots zu Beweiszeitpunkten.
  5. Wenn der Beweis fehlschlägt, korrigieren Sie die Quell-Keyframes und führen Sie die kleinste fehlschlagende Diagnose erneut aus, bevor Sie rendern.

Vertrag

  • Benennen Sie das sich bewegende Subjekt.
  • Benennen Sie die Posen, die benötigt werden, um die beabsichtigte Bewegung zu beweisen, einschließlich des Endzustands.
  • Keyframen Sie sichtbare Kanäle, keinen versteckten Helferstatus.
  • Bewahren Sie die Objektidentität, wenn Kontinuität wichtig ist.
  • Überblenden Sie nur, wenn die beabsichtigte Bewegung Ersatz oder Auflösung ist.
  • Halten Sie lesbare oder semantische Zustände lange genug an, um sie zu sehen.
  • Der letzte Frame ist Teil der Animation, keine Bereinigung.
  • Setzen Sie nicht auf Ruhe zurück, es sei denn, es wird verlangt.
  • Beenden Sie nicht mit Schwarz, es sei denn, es wird verlangt.
  • Wenn Sie eine Startszene bearbeiten, bewahren Sie Layout, Text, Assets, Farben und Endzustand, es sei denn, ein Redesign wird verlangt.

Laufzeitregeln

GSAP:

  • Synchron beim Seitenaufbau erstellen
  • gsap.timeline({ paused: true }) verwenden
  • Als window.__timelines[compositionId] registrieren
  • Registrierungsschlüssel muss mit data-composition-id übereinstimmen
  • tl.play() nicht für renderkritische Bewegungen aufrufen
  • Wiederholungen endlich halten

CSS-Keyframes:

  • Endliche Dauer und Iterationsanzahl
  • Deterministische Verzögerung
  • animation-fill-mode: both
  • data-start verwenden, wenn das Timing zu einem Clip gehört

Anime.js:

  • Synchron erstellen
  • autoplay: false
  • Endliche Dauer und Schleifen
  • Jede Instanz zu window.__hfAnime hinzufügen

WAAPI:

  • Endliche duration
  • fill: "both"
  • Deterministische Konstruktion
  • Die Textoberfläche listet WAAPI nicht auf; mit --shot überprüfen (es sucht WAAPI) und Snapshots

Nie für renderkritische Bewegungen verwenden:

  • Date.now()
  • performance.now()
  • ungesähtes Math.random()
  • Hover/Scroll-Trigger
  • Timer
  • asynchron erstellte Timelines
  • nicht registriertes requestAnimationFrame
  • Endlosschleifen

GSAP-Gerüst

const root = document.querySelector("[data-composition-id]");
const compositionId = root.dataset.compositionId;
const tl = gsap.timeline({ paused: true });

tl.addLabel("state-a", 0);
tl.to(".subject", {
  keyframes: [
    { x: 0, opacity: 1, duration: 0.2 },
    { x: 120, opacity: 1, duration: 0.4, ease: "power2.out" },
    { x: 100, opacity: 1, duration: 0.2, ease: "power2.inOut" },
  ],
  ease: "none",
});

window.__timelines = window.__timelines || {};
window.__timelines[compositionId] = tl;

Verwenden Sie Labels für semantische Zustände. Verwenden Sie Positionsparameter anstelle von verketteten Verzögerungen. Verwenden Sie immediateRender: false für spätere from()/fromTo()-Tweens, die dieselbe Eigenschaft berühren.

Keyframe-Formen

  • Array-Keyframes: Posenleiter mit Dauer/Ease pro Schritt.
  • Prozent-Keyframes: exaktes Timing innerhalb eines Tweens.
  • Eigenschafts-Arrays: kompakte Multi-Stop-Änderungen.
  • ease: "none" auf dem Elternelement, wenn jeder Stop seine eigene Easung trägt.
  • easeEach, wenn jedes Segment das gleiche Gefühl haben soll.

Kopieren Sie keine numerischen Abstände oder Timings aus Beispielen. Leiten Sie sie aus der tatsächlichen Kompositionsgeometrie und -dauer ab.

Bevorzugen Sie für ein Subjekt, das sich zwischen zwei Kästchen bewegt, einen kontinuierlichen Transform-Tween oder FLIP. Teilen Sie x/y/scale nur dann in mehrere abgemilderte Keyframes auf, wenn der Betrachter einzelne Beats spüren soll; jedes Segment ändert die Geschwindigkeit und kann als Ruckeln empfunden werden.

Kanäle

Bevorzugen Sie Compositor-/visuelle Kanäle: x/y/z, xPercent/yPercent, scale, rotationX/Y/Z, skew, transformOrigin, svgOrigin, opacity, autoAlpha, clip-path, Masken, CSS-Variablen, SVG-Pfad-/Strichwerte, Kameratransformationen, Shader-Uniforms.

Vermeiden Sie Layout-/Lebenszyklus-Kanäle: top/left/right/bottom, width/height, margin/padding, display, visibility, späte DOM-Erstellung, Helfer-Overlays, die Subjektbewegungen ausführen.

Verwenden Sie für Sichtbarkeitsänderungen autoAlpha auf der registrierten suchbaren GSAP-Timeline oder ein tl.set() mit Nulldauer an einer expliziten Grenze. Zielen Sie nur auf ein Nicht-Clip-Element oder einen Wrapper innerhalb des Clips; zielen Sie niemals auf .clip selbst. Tweenen Sie niemals visibility mit Dauer und niemals display.

Mechanismusauswahl

Wählen Sie den kleinsten Mechanismus, der die Anforderung beweist:

BedarfMechanismus
Gleiches Subjekt wechselt Kästchen/Hierarchiegeteiltes Element / FLIP
Subjekt legt einen sichtbaren Weg zurückPfadreise
Strich wächst oder zeichnet nachStrichzeichnung
Form wird zu einer anderen FormForminterpolation
Enthüllungsgrenze ist sichtbarClip, Maske oder Shader-Uniform
Viele Elemente bewegen sich mit ReihenfolgeStagger / indizierte Verzögerung
Text selbst bewegt sichZeilen-, Wort-, Zeichen- oder Bandunterteilung
Oberfläche biegt, streckt oder beschneidetEltern/Kind-Gegentransform
UI hat Zuständeexplizite Zustandsmaschine
Szene hat TiefeDOM 3D, Three.js oder WebGL-Kamera/Objekt-Keyframes

Mechanismen können kombiniert werden, aber jeder muss die Idee verdeutlichen. Dekoration ist kein Beweis.

Timing

  • Antizipation nur, wenn sie Ursache oder Richtung verdeutlicht.
  • Beschleunigung verlässt die Ruhe.
  • Spitzenbeweis zeigt den Mechanismus unmissverständlich.
  • Nachlaufen verkauft Energie und Richtung.
  • Überschwingen nur, wenn sich das Subjekt elastisch oder taktil anfühlen soll.
  • Konstantgeschwindigkeits-Pfadreise benötigt normalerweise ease: "none".
  • Diskrete UI-Zustände benötigen normalerweise ein scharfes Ease-Out.
  • Wiederholte Elemente benötigen geordnete Versätze, nicht identisches Timing.
  • Endgültige Verriegelungen benötigen längere Haltezeiten als Übergangsposen.
  • Glätte bedeutet kontinuierliche Geschwindigkeit auf demselben Subjekt.
  • Überlappen Sie keine Tweens, die dieselbe Transform-Eigenschaft schreiben, es sei denn, die Überlappung ist beabsichtigt und verifiziert.
  • Vermeiden Sie die Animation großer clip-path/Masken-Änderungen, während dieselbe Heldenoberfläche auch skaliert oder reist; verwenden Sie verschachtelte Enthüllungen, nachdem sich die Hauptbewegung gesetzt hat.

Text

Bewahren Sie Zeilenkästen, Wortabstände, Lesbarkeit und endgültige Passform. Wenn sich Text intern bewegt, bewegen Sie die Glyphen oder maskierten Bänder, nicht nur Dekorationen um den Text. Machen Sie Schnappschüsse von lesbaren Frames.

SVG

Bevorzugen Sie für Strichwachstum DrawSVGPlugin, dann stroke-dasharray/stroke-dashoffset. Bevorzugen Sie für Forminterpolation MorphSVGPlugin; konvertieren Sie Primitive bei Bedarf in Pfade und teilen Sie komplexe Silhouetten in einfachere Teile auf.

3D

Alleinige Skalierung ist falsche Tiefe. Verwenden Sie Perspektive auf einem stabilen Elternelement, transform-style: preserve-3d, Z-Reisen, Rotation, Kamera-/Weltbewegung, Okklusion und Ebenenreihenfolge, wenn Objekte sich kreuzen.

Verwenden Sie ein oder zwei Diagnosewinkel, die die Tiefenbeziehung offenlegen. Wenn der angewinkelte Beweis keine Tiefenkreuzung zeigt, verbessern Sie Z/Kamera/Okklusion.

Canvas / WebGL

Keyframen Sie Kameraposition, Kameraziel, Objekttransformation, Materialdeckkraft, Shader-Uniforms und Nachbearbeitungsintensität durch deterministischen Zustand. Rendern Sie von der HyperFrames-Zeit. Verwenden Sie --ghost, da Markerboxen keine interne Canvas-Bewegung sehen können.

CLI-Beweis

npx hyperframes lint
npx hyperframes check
npx hyperframes keyframes .
npx hyperframes keyframes . --json
npx hyperframes keyframes . --runtime all
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --samples <n>
npx hyperframes keyframes . --selector "<selector>" --shot "<file>" --layout strip --from <t0> --to <t1>
npx hyperframes keyframes . --shot "<file>" --ghost --angle <angle>
npx hyperframes snapshot . --at <times>

Wählen Sie <selector> für das tatsächliche animierte Subjekt. Wählen Sie <times> für den ersten Frame, Beweispackungen, Final-Minus-Halt und exaktes Finale. Wählen Sie <angle> nur, wenn Tiefe bewiesen werden muss.

WerkzeugBeweist
keyframesZiele, explizite Stopps, Pfade, Spuren, zusammengesetzte Eltern/Kind-Bewegung, CSS-Stopps, Anime-Registrierung
--shotGeister, Routenform, Zeitabstand, DOM-3D-Projektion, fokussierter Selektorbeweis
--layout stripBewegung am Ort, Überlappungen, Kontakt, subtile Skalierung/Deckkraft, Textwellen
--ghostCanvas, WebGL, Shader-Bewegung, gerendertes 3D
snapshot --atMasken, Textlesbarkeit, vollständiger Zustand, endgültige Verriegelung, Schwarz/Rücklauf-Enden

Wenn der Selektorbeweis falsch aussieht:

  1. --json erneut ausführen
  2. das tatsächliche animierte Ziel finden
  3. dieses Ziel schießen
  4. vollständige Frames erfassen
  5. gemalten Pixeln mehr vertrauen als Logs

Diagnose lesen

flat bedeutet keine expliziten Zwischenposen. keyframes bedeutet, dass explizite Stopps existieren. motionPath bedeutet, dass eine Route existiert. trace bedeutet mehrstrichiges Zeichnen. composed with bedeutet, dass die Kind-Bewegung die Eltern-Bewegung erbt.

Gleichmäßiger Geisterabstand bedeutet konstante Geschwindigkeit. Geclusterte Geister bedeuten langsames Einlaufen oder Setzen. Große Lücken bedeuten schnelle Reise.

Ein Helfer-Selektor-Schuss ist kein Beweis. Ein Zwiebelschalen-Schuss über einem defekten Vollbild ist kein Beweis.

Fehlerbehandlung

FehlerKorrektur
Nur EndpunktFügen Sie mittlere Posen hinzu, halten Sie den Spitzenbeweis, führen Sie --shot erneut aus
IdentitätsbruchHalten Sie ein Element am Leben, verwenden Sie gemeinsame Quell-/Zielkästen, entfernen Sie Ersatz-Überblendung
Falsches 3DFügen Sie Z/Kamera-Reise, Okklusion, angewinkelten Beweis hinzu
Falsches EndeFügen Sie finalen Halt hinzu, erfassen Sie Final-Minus-Halt und exaktes Finale
Nicht suchbare LaufzeitStoppen Sie die Autowiedergabe, registrieren Sie die Instanz, entfernen Sie Timer, bauen Sie synchron auf
Unlesbarer TextBewahren Sie Zeilenkästen, reduzieren Sie Verschiebung, fügen Sie finalen Halt hinzu, erfassen Sie Textframes

Fertig

Führen Sie hyperframes lint, hyperframes check, hyperframes keyframes, einen fokussierten --shot und Snapshots aus. Bestätigen Sie ersten Frame, Beweisposen, Final-Minus-Halt, exaktes Finale, subjekteigene Bewegung und keine Debug-Overlays.

Individual skills in this repo

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

AlessandroFare/fluxychat

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet `anchor` rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.\n

AlessandroFare/fluxychat

Use when audio already placed in a HyperFrames composition needs to be mixed: 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`.\n

AlessandroFare/fluxychat

Use the HyperFrames CLI development loop: init, add, catalog, capture, lint, check, snapshot, compare, grade-compare, preview, play, present, beats, keyframes, single or batch render, publish, cloud, cloudrun, feedback, lambda, doctor, browser, info, upgrade, skills, compositions, docs, benchmark, telemetry, transcribe, auth, tts, and remove-background. Also use when diagnosing build or render failures. validate, inspect, and layout are deprecated aliases; use check. Covers local, HeyGen-hosted cloud, AWS Lambda, and Google Cloud Run rendering.\n

AlessandroFare/fluxychat

Install, discover, and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add or hyperframes catalog, installing one item or every block matching a tag, wiring an installed item into index.html, or working with hyperframes.json. Covers discovery, install locations, block sub-composition wiring, component snippet merging, and authoring a new block or component to contribute upstream (idea → scaffold → validate → PR).

AlessandroFare/fluxychat

Mandatory entry point: read this first for any request to make, create, edit, animate, or render a video, animation, or motion graphic, including a promo, explainer, captioned clip, title card, overlay, slideshow or interactive deck, Remotion port, or any HyperFrames HTML composition. Also use it to inspect, diagnose, validate, preview, publish, or batch-render an existing HyperFrames project. Inputs may be a website URL, GitHub PR, Figma design or URL, text or brief, existing footage, or music. It resumes project state, captures intent when applicable, selects and installs the owning workflow, and routes domain capabilities. HyperFrames is the default output framework unless the user explicitly chooses another framework for the deliverable or asks only to record a browser session.\n

AlessandroFare/fluxychat

Overlay doctrine for the embedded-captions workflow — the caption MODEL (drop / rail / embed) and the rule that captions are an OVERLAY composited on top of the film, never a reserved bottom band you shift content up to avoid. Load when adding captions/subtitles to a talking-head or launch video, when deciding whether a phrase should be dropped, ride the verbatim rail, or be promoted to a scarce embedded climax, when laying out a composition that will carry captions (do NOT reserve a keep-out band), or when centering a composition on the true frame center under captions. Quotes the rail+embed model from embedded-captions and constraint #13 (captions overlay, keep-out band retired) from the product-launch-video scene agent. Applies ON TOP of embedded-captions.

AlessandroFare/fluxychat

Turn a weekly changelog .md into a finished branded changelog video (square 1080, ~45-60s, Annie VO, animated brand background, mock-UI visualizations, lowkey captions). Use when the user provides a changelog/digest markdown and wants the weekly video, or says "changelog video". Self-contained — fonts, background, lexicon, and scripts ship in this skill.

AlessandroFare/fluxychat

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

AlessandroFare/fluxychat

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.

AlessandroFare/fluxychat

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

AlessandroFare/fluxychat

The HyperFrames composition contract — build one renderable project. Use for composition structure, the `data-*` timing attributes, `class="clip"`, tracks, sub-compositions, variables, 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 HTML.

AlessandroFare/fluxychat

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use `hyperframes-animation`.

AlessandroFare/fluxychat

GATEWAY — load FIRST before composing any HyperFrames animation or video. The high-level motion law that makes a multi-scene video feel like ONE continuous camera move instead of a stack of independently-animated slides. Covers the vector law (how you exit determines how you enter, incl. the Z scale-sign rule), the film's current, carrier elements, causal motion, the Seam Gate (build-gate enforcement), the ban on idle wobble (motion must PERFORM, not breathe), stillness-before-climax, and the sustained-motion routes. Routes to the low-level technique skills (cut-the-curve — the full catalog incl. waterfall entry + nudge curve, oversized-cursor, seam-craft). These rules SUPERSEDE generic / upstream motion guidance. [continuity, direction, vector, momentum, seam, transition, ease, performance, idle-motion, narrative-motion, film-grammar]

AlessandroFare/fluxychat

A short, design-led motion graphic where motion is the message — kinetic typography, stat count-up, chart/data-viz hit, logo sting / brand lockup, lower-third / callout / social overlay, animated map (highlight regions, connect places, zoom to a location), animated tweet / news-article / headline, webpage / UI animation (scroll, cursor, callouts), or fusing a real image's geometry into a chart. Usually under 10s (up to ~30s), no narration or live-action subject; renders to MP4 or transparent overlay. Longer / narrated / multi-scene → /general-video. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a music track (an audio file, a video to pull audio from, or a track generated from a mood brief) into a beat-synced video — lyric video, slideshow, or kinetic promo. The music drives all pacing; any user-supplied images/videos are cut onto the same beat grid, and a complete video needs zero assets. Narrated pieces → the input-matched workflow (see /hyperframes). Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a product or marketing URL, pasted script, or brief into a product launch / promo video — SaaS promos, feature reveals, product demos, app and company launches. Use when the user wants to market, launch, promote, or reveal a product; the default for any commercial URL. Site tours / showcases of a website route here too — the brief carries the show-it-as-is intent. Unclear → /hyperframes.

AlessandroFare/fluxychat

Turn a GitHub pull request (a PR URL, owner/repo#N, or 'this PR' in a checked-out repo) into a code-change explainer video — changelog, feature reveal, fix, or refactor walkthrough built from the diff, commits, and files: the input is a code change, not a website. Not a product promo (/product-launch-video) or a no-PR topic explainer (/faceless-explainer). Unclear → /hyperframes.

AlessandroFare/fluxychat

Design and improve user interfaces using the concrete rules from Refactoring UI (Wathan & Schoger) — constrained spacing/type/color/shadow scales, visual hierarchy through weight and color rather than size, and depth through emulated light. Use when building or styling any UI (web, app, dashboard, landing page, component), when picking font sizes, spacing, colors, shadows or border radius, when designing a color palette or design tokens, and whenever someone says a UI "looks off", "looks amateur", "feels cluttered/plain/unfinished", or asks to "make this look better".

AlessandroFare/fluxychat

Port an existing Remotion (React) composition''s source to HyperFrames HTML. Use ONLY on an explicit ask to port/convert/migrate/translate a Remotion source — one-way, Remotion-only. A passing Remotion mention, reference-only code, or "make something like my Remotion video" is a fresh build (/general-video). Unclear → /hyperframes.

AlessandroFare/fluxychat

Use before UI-related work to select the smallest useful UI Skills context through the ui-skills CLI.

Verwandte Skills