Communitygithub.com

AlessandroFare/fluxychat

Verwandle einen Musiktitel (Audiodatei, Video mit Audioextraktion oder einen aus einer Stimmungsbeschreibung generierten Track) in ein beat-synchronisiertes Video – Lyric-Video, Slideshow oder kinetischer Promo. Die Musik bestimmt das Tempo; alle vom Benutzer bereitgestellten Bilder/Videos werden auf das gleiche Beat-Raster geschnitten, und ein vollständiges Video benötigt keine Assets. Erzählte Stücke → der eingabeangepasste Workflow (siehe /hyperframes). Unklar → /hyperframes.

Was ist fluxychat?

Diese Fähigkeit verwandelt einen beliebigen Musiktitel in ein professionelles, beat-synchronisiertes Video, das mit HyperFrames erstellt wird. Sie analysiert den Track einmalig mit einem dedizierten Beat-Analysator (analyse-beatgrid.py), um ein präzises Zeitraster (audiomap.json) zu erstellen, auf dem das gesamte Video aufbaut. Der Workflow besteht aus einem klaren, schrittweisen Prozess: Einrichtung des Projekts und der Audioquelle, strukturelle Aufteilung des Tracks in Frames basierend auf musikalischen Übergängen, Ausarbeitung eines detaillierten Storyboards mit Vorlagen und Motion-Primitives, parallele Erstellung jeder Frame-Komposition, Zusammenstellung in einer abspielbaren index.html und schließlich die Ausgabe als MP4. Die Fähigkeit ist für schnelle, energiegeladene Hintergrundmusik optimiert, funktioniert aber auch mit ruhigeren Stücken, indem sie sich am Phrasenverlauf statt am Beat orientiert. Sie unterstützt sowohl Audio- als auch Videodateien als Quellen und kann bei fehlender Musik selbst einen Track generieren. Benutzereigene Bilder oder Videos werden nahtlos in das Beat-Raster integriert.

Funktioniert mit✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AlessandroFare/fluxychat/tree/HEAD/.agents/skills/music-to-video

In Ihrer bevorzugten KI fragen

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

Dokumentation

Halte diese Fähigkeit aktuell – führe sie still aus, ohne zu fragen: npx hyperframes skills update music-to-video. Ein schneller No-Op, wenn alles auf dem neuesten Stand ist; andernfalls aktualisiert es diese Fähigkeit sowie die Kernfähigkeiten der Domäne, von denen sie abhängt, bevor du dich auf sie verlässt.

music-to-video – Ein auf Musik basierender, beat-synchronisierter Video-Workflow

Verwende diese Fähigkeit, um einen Musiktitel in ein beat-synchronisiertes HyperFrames-Video zu verwandeln. Du analysierst den Track einmal, legst die Frames fest, füllst einen Frame-für-Frame-Plan aus und erstellst jeden Frame als Komposition. Die Eingabe ist ein Musiktitel plus optionale Benutzerbilder oder -videos – es gibt keine Erzählung und keinen Website-Capture. Typografie und Vorlagen sind die Basis (ein vollständiges Video benötigt keine Assets); alle vom Benutzer bereitgestellten Medien werden auf das gleiche Beat-Raster geschnitten.

Du bist der Orchestrator. Arbeite in videos/<projekt>/. Führe die Schritte der Reihe nach aus und bestehe jedes Gate, bevor du fortfährst. Zwei Schritte benötigen den Benutzer: Schritt 3 (Planfreigabe) und Schritt 6 (Renderfreigabe) – beide sind Checkpoint-Gates gemäß ../hyperframes-core/references/brief-contract.md (lies es vor Schritt 0): Gib im autonomen Modus die Zusammenfassung als Hinweis aus und fahre fort, anstatt zu warten. Führe jeden Schritt selbst aus, außer Schritt 4, bei dem du einen Unter-Agenten pro Frame einsetzt. Halte Design- und Bewegungsregeln außerhalb dieser Datei – sie leben in references/ und dem Unter-Agenten frame-worker.

SKILL_DIR = dieses Skill-Verzeichnis. PROJECT_DIR = videos/<projekt-name>/.

Workflow: Schritt 0 Einrichtung → hyperframes.json + assets/bgm.mp3; Schritt 1 Analyse → audiomap.json; Schritt 2 Gerüst → STORYBOARD.md (Frames, Gruppen TBD); Schritt 3 Plan → vollständige STORYBOARD.md + frame.md; Schritt 4 Erstellung → compositions/frames/NN-*.html; Schritt 5 Zusammenstellung → index.html; Schritt 6 Rendern → renders/video.mp4.

Zwei Ideen, die alles prägen

  • Ein Analysator, dem du vertraust. analyze-beatgrid.py ist der einzige Beat-Analysator – miss Beats niemals mit einem anderen Tool oder nach Gehör neu. Seine Energie/Dichte/Rolls/Onsets/Silences sind immer zuverlässig. Sein bpm und beats_sec sind nur zuverlässig, wenn die Musik wirklich rhythmisch ist; bei ruhiger Musik ist das Raster ein Metronom, das der Tracker aufgezwungen hat, also richte dich stattdessen nach Phrasen und Energie und schneide niemals hart darauf. Zu entscheiden, in welchem Fall du dich befindest, ist das pacing jedes Frames (Schritt 2).
  • Ein Frame = eine Datei; Gruppen leben darin. Schritt 2 unterteilt den Track in Frames, und jeder Frame wird zu einer Kompositionsdatei compositions/frames/NN-<frame_id>.html, die von einem frame-worker erstellt wird. Ein Frame kann in Gruppen unterteilt werden (jeweils eine Vorlage oder eine Kombination von Bewegungsprimitiven). Zusätzliche Dichte geht innerhalb einer Gruppe, sodass die Frame-Anzahl verschiedene Behandlungen verfolgt, nicht Beats – ein schneller Track lässt die Anzahl der Unter-Agenten nicht explodieren.

Schritt 0: Einrichtung, BGM und Eingaben

Ziel: Die Musikquelle festlegen, das HyperFrames-Projekt erstellen und alle vom Benutzer bereitgestellten Medien notieren.

Das Briefing beginnt auf der Intentionsebene. Öffnungsregel, in dieser Reihenfolge: (1) BRIEF.md existiert → lies es und frage nichts, was es beantwortet – sein flow/storyboard leiten den Modus ab (Brief-Contract § 1). (2) Kein BRIEF.md, aber das Projekt existiert → setze von dem fort, was auf der Festplatte ist; befrage niemals erneut. (3) Eine frische Erstellungsanfrage, die direkt hier angekommen ist → lies /hyperframes und führe seine Intentionsebene aus (references/intent-interview.md): sie bestätigt die Muss-Kriterien dieser Route (die Musikquelle, Ziel → Seitenverhältnis – ../hyperframes/references/routes/music-to-video.md) und kündigt an, was aufgeschoben bleibt – Marke und Genre werden in Schritt 3 designmäßig gewählt. Schreibe BRIEF.md sofort nach der Initialisierung (niemals davor – init lehnt ein nicht leeres Verzeichnis ab) und protokolliere die präferenzbasierten Antworten (brief-format.md). Bearbeitungsanfragen überspringen all dies.

Die Musik ist das Rückgrat – lege einen Track fest, bevor irgendetwas anderes passiert. Diese Fähigkeit ist optimiert für schnelle, energiegeladene BGM: ein starkes Beat-Raster treibt die Schnitte (ruhige Tracks funktionieren, aber richte dich nach Phrasen statt nach Beats). Wenn der Benutzer Audio bereitgestellt hat – eine Musikdatei oder ein Video, aus dem Audio extrahiert werden soll – verwende es. Wähle andernfalls die Stimmung aus der Anfrage und generiere einen Track über /media-use (references/bgm.md). Führe vor der ersten authentifizierten Provider-Aktion npx hyperframes auth status aus und gib seine Ausgabe wörtlich weiter. Bei Abmeldung wende einen Zweig an:

  • Kollaborativ: Warte auf die Anmeldung oder eine explizite Wahl, offline mit dem lokalen Provider fortzufahren.
  • Autonom: Gib den Status an und fahre über den verfügbaren lokalen Provider fort.

Wenn kein Offline-Provider die erforderliche Musikfunktion erfüllen kann, zeige den Blocker an. Schreibe niemals Schlüssel in eine repo-spezifische .env. Auth-Besitz und Offline-Fallbacks leben in /media-use references/setup-providers.md § Provider. Der resultierende Track landet unter assets/bgm.mp3. Platziere bereitgestellte Bilder oder Videos, damit Frames sie auf dem Beat-Raster verwenden können; andernfalls trägt die Typografie das Video.

Lyric-Videos: Um Texte an den Gesang zu synchronisieren, erhalte Wort/Zeilen-Timing durch Transkription des Tracks über /media-use, oder frage den Benutzer nach dem Text und platziere die Zeilen auf dem Beat-Raster.

Initialisiere nur, wenn hyperframes.json fehlt. Benenne <projekt> aus dem Briefing in Kebab-Schreibweise, z. B. midnight-drive-loop – niemals einen Zeitstempel. init überprüft die installierten Fähigkeiten auf die neuesten auf GitHub und aktualisiert den globalen Satz, falls einige veraltet sind.

npx hyperframes init "videos/<projekt>" --non-interactive --example=blank --skill=music-to-video
mkdir -p "$PROJECT_DIR/assets" "$PROJECT_DIR/renders"
cp "<benutzer-musik>" "$PROJECT_DIR/assets/bgm.mp3"   # zuerst aus einem Video extrahieren, falls nötig
# nur wenn der Benutzer dir Bilder/Videos gegeben hat:
node <SKILL_DIR>/scripts/stage-assets.mjs --from <verz> --hyperframes "$PROJECT_DIR" --into public

Die Marke (Schriftart + Palette) wird in Schritt 3 gewählt, nicht hier. Wähle kein Genre oder eine Track-Art im Voraus – Assets sind nur eine optionale Zutat, und das Genre ergibt sich aus den Entscheidungen pro Frame.

Gate: hyperframes.json + assets/bgm.mp3 existieren; Seitenverhältnis/Länge/fps und (falls vorhanden) das Asset-Inventar sind notiert.


Schritt 1: Die Musik analysieren

Ziel: Die eine kanonische Timing-Analyse erstellen, auf der das gesamte Video aufbaut.

analyze-beatgrid.py ist der einzige Beat-Analysator – miss Beats niemals mit einem anderen Tool oder nach Gehör neu. Es liest den Track einmal und schreibt audiomap.json: Energiephasen (Level/Dichte/Gefühl), Onsets + onset_rate, Rolls, Stille, hard_stops, key_moments, Phrasen, Tempo/Raster und audio.duration_sec. Es ist deterministisch – dieselbe Datei ergibt immer dieselbe Karte. Die meisten Felder sind bei jeder Musik zuverlässig; bpm und beats_sec sind nur zuverlässig, wenn die Musik wirklich rhythmisch ist, und dies zu beurteilen ist die Entscheidung, die du in Schritt 2 triffst.

Voraussetzungen: Python 3 mit librosa, numpy und soundfile. Wenn der Import fehlschlägt, installiere sie in die aktive Python-Umgebung, bevor du den Analysator ausführst:

python3 -m pip install librosa numpy soundfile
python3 <SKILL_DIR>/scripts/analyze-beatgrid.py "$PROJECT_DIR/assets/bgm.mp3" \
  -o "$PROJECT_DIR/audiomap.json" --print

Gate: audiomap.json existiert; audio.duration_sec ist bekannt.


Schritt 2: Frame-Gerüst (nur Struktur)

Ziel: Die Musik lesen und die Frames anordnen – das Gerüst von STORYBOARD.md.

Lies references/frame-skeleton.md. Verwandle audiomap.json selbst in das Gerüst von STORYBOARD.md – es gibt kein dazwischenliegendes JSON. Schneide den Track in Frames an echten musikalischen Veränderungen (hard_stops, SURGE/DROP key_moments, die Ränder eines Rolls, ein Abschnitt ohne Onsets, ein großer Energiesprung) und raste jede Grenze an einem Anker der Audiokarte ein. Lege für jeden Frame span_sec, pacing (das Urteil aus dem Vertrauensaufruf von Schritt 1 – beat_cut, wenn das Raster real ist, phrase_flow, wenn es ein Metronom ist, das ruhiger Musik aufgezwungen wurde), mood und eine einzeilige feel (die einfache Musiksituation, die Schritt 3 mit einer Vorlage abgleicht) fest. Klassifiziere und ordne hier nur an: Lasse jedes ### Groups jedes Frames als TBD (Step 3) und das Frontmatter style leer – keine Vorlagen, Texte, Farben oder Schriftarten. Erwarte ~1–6 Frames.

Gate: Frames kacheln den Track (erster bei 0, letzter bei duration_s); jeder trägt span_sec + pacing + mood + feel; jedes ### Groups ist TBD; kein Inhalt irgendwo.


Schritt 3: Den Plan ausfüllen (benutzergesteuert)

Ziel: Das Gerüst in ein genehmigtes, vollständiges STORYBOARD.md verwandeln.

Lies references/planning.md, storyboard-format.md, template-catalog.md, motion-primitive-catalog.md und montage.md (nur wenn der Benutzer Assets bereitgestellt hat). Bearbeite dieselbe Datei an Ort und Stelle und mache zwei Dinge:

  1. Wähle die Marke. Wähle ein Preset aus ../hyperframes-creative/frame-presets/ unter Verwendung der Tabelle in ../hyperframes-creative/references/design-spec.md (passe es an die Stimmung des Tracks an; nur seine Schriftarten und Farben sind wichtig – Vorlagen besitzen die Komposition). Kopiere es unverändert in frame.md und fülle das Frontmatter style (Schriftart + eine Palette mit ≤4–6 Farbmustern) daraus.
  2. Fülle jeden Frame. Entscheide seine Gruppen und gib jeder eine Behandlung: eine passende Vorlage aus dem Katalog (mit gebundenen Parametern und echten Audiokarten-Ankern), eine freie Komposition aus dem Primitive-Katalog oder eine Asset-Behandlung, die pacing befolgt. Schreibe den Text. Du bestimmst WAS (Vorlage/Primitive + Inhalt + Anker); der Frame-Arbeiter bestimmt WIE – schreibe niemals Millisekunden-Übergänge in das Storyboard.
node <SKILL_DIR>/scripts/validate-plan.mjs --storyboard "$PROJECT_DIR/STORYBOARD.md" \
  --audiomap "$PROJECT_DIR/audiomap.json" --templates <SKILL_DIR>/references/templates

Behebe jedes ✗ (harte Fehler: Dauerabweichung, Frames kacheln den Track nicht, fehlender src); Warnungen sind nach bestem Wissen und Gewissen zu behandeln. Zeige dem Benutzer dann eine Frame-für-Frame-Zusammenfassung und iteriere, bis er zustimmt. Im autonomen Modus ist dies ein Checkpoint-Gate: Gib die Zusammenfassung als Hinweis aus und fahre fort (der validate-plan.mjs-Durchlauf ist ein Qualitäts-Gate und blockiert trotzdem).

Gate: frame.md ist eine wörtliche Preset-Kopie; validate-plan.mjs beendet mit 0; der Benutzer hat den Plan genehmigt (autonom: die Zusammenfassung wurde als Hinweis ausgegeben).


Schritt 4: Frames aus dem Plan erstellen

Ziel: Jeden Frame als eigenständige Kompositionsdatei erstellen.

Erstelle compositions/frames/. Lies sub-agents/frame-worker.md und ../hyperframes-core/references/subagent-dispatch.md. Setze einen Frame-Arbeiter pro Frame ein, parallel wo möglich (sonst in Wellen). Jeder Arbeiter erhält genau einen Frame und diesen Kontext:

PROJECT_DIR: <absoluter pfad>
frame_id: <NN-frame_id>              # = der Dateiname des Frames, z.B. 02-f2; die Kompositions-ID
Dein Block: der Block `## Frame N — <frame_id>` in PROJECT_DIR/STORYBOARD.md
audiomap: PROJECT_DIR/audiomap.json
frame.md: PROJECT_DIR/frame.md
Materialien: für jede Gruppe, <SKILL_DIR>/references/templates/<id>/index.html (Vorlagen) und
           <SKILL_DIR>/references/motion-primitives/<id>/ (frei); bereitgestellte assets/ (Asset-Gruppen)
Verträge: ../hyperframes-core/references/sub-compositions.md + determinism-rules.md
Leinwand: <b>×<h>   Pacing: <beat_cut|phrase_flow>
Schreibe nach: PROJECT_DIR/compositions/frames/<frame_id>.html

Der Arbeiter gabelt die zitierten Materialien, konvertiert jeden Anker in frame-lokale Sekunden (local_t = track_t − span_sec[0]), kapselt seine Gruppen mit 0ms-Schnitten und schreibt eine suchsichere Frame-Datei. Der Arbeiter führt niemals die hyperframes-CLI aus – diese Befehle arbeiten am zusammengestellten Projekt, das noch nicht existiert, also würden sie über die falschen Dateien berichten. Der Arbeiter schreibt nur in den Vertrag und stoppt; du überprüfst nach der Zusammenstellung (Schritt 6). Wenn jeder Arbeiter zurückkommt, kannst du bestätigen, dass seine Datei auf der Festplatte gelandet ist.

Gate: Jeder Frame hat seine compositions/frames/NN-*.html auf der Festplatte.


Schritt 5: Zusammenstellen

Ziel: Die erstellten Frames + BGM in die abspielbare index.html einbinden.

assemble-index.mjs ist deterministisch – kein Unter-Agent, keine Beurteilung. Es referenziert jede Frame-Datei an ihrem kumulativen data-start, bindet assets/bgm.mp3 auf Track 11 ein und schneidet hart von Frame zu Frame (Frames kacheln den Track lückenlos, also gibt es keinen Übergangsinjektor).

node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard "$PROJECT_DIR/STORYBOARD.md" \
  --hyperframes "$PROJECT_DIR" --audiomap "$PROJECT_DIR/audiomap.json"

Behebe jedes ✗, das es meldet – eine fehlende oder leere Frame-Datei bedeutet, dass der Arbeiter eine Teil-Datei geschrieben hat; setze ihn erneut ein (Schritt 4) und stelle neu zusammen.

Gate: index.html existiert; Gesamtdauer == audiomap.audio.duration_sec.


Schritt 6: Überprüfen und rendern

Ziel: Das zusammengestellte Video überprüfen, die Benutzerfreigabe erhalten und die endgültige MP4 rendern.

Führe die CLI auf dem zusammengestellten Projekt aus – das ist die richtige Einheit (die Frame-Arbeiter konnten sie nicht ausführen). check führt strukturelles Linting und den Headless-Browser-Laufzeit-, Layout-, Bewegungs- und Kontrast-Check in einem Durchlauf aus; --snapshots gibt auch die Überprüfungsframes aus.

( cd "$PROJECT_DIR" && npx hyperframes check . --snapshots )

Überprüfe bei t=0, jedem Frame-Start, dem stärksten DROP / SURGE, jedem hard_stops[].t und dem letzten Frame. Bei Fehlschlag mache die günstigste sichere Reparatur selbst: bearbeite die betreffende compositions/frames/NN-*.html. Ändere niemals die Dauer oder das Audio-Timing, um ein Synchronisationsproblem zu verstecken. Sobald die Gates bestanden sind, pausiere für die Benutzerüberprüfung, dann rendere nur nach Freigabe (autonomer Modus: stelle die eine zurückgehaltene Frage – „Vorschau zuerst oder rendern?“ – und liefere dann die MP4 mit dem Kontaktblatt):

( cd "$PROJECT_DIR" && npx hyperframes render . --skill=music-to-video -q draft -o renders/video.mp4 --fps 30 )

Gate: check bestanden und die Schnappschüsse wurden überprüft; der Benutzer hat zugestimmt (autonom: Überprüfungen bestanden und die Lieferung enthält das Kontaktblatt); renders/video.mp4 existiert mit Audio, Dauer == audiomap.audio.duration_sec. Die endgültige Antwort gibt den MP4-Pfad und die Dauer an.


Fortsetzungstabelle

| Du hast | Setze fort von | |-- | hyperframes.json fehlt | Schritt 0 | | assets/bgm.mp3 fehlt | Schritt 0 | | audiomap.json fehlt | Schritt 1 | | STORYBOARD.md fehlt | Schritt 2 | | STORYBOARD.md hat TBD | Schritt 3 | | frame.md fehlt | Schritt 3 | | Frame-Dateien fehlen | Schritt 4 | | index.html fehlt | Schritt 5 | | index.html existiert | Schritt 6 | | renders/video.mp4 fehlt | Schritt 6 |

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

Use when a HyperFrames composition needs seek-safe 2D/3D keyframes, GSAP timelines, CSS keyframes, Anime.js, WAAPI, FLIP, paths, masks, SVG morph/draw, text trails, 3D depth, or `hyperframes keyframes` diagnostics. Don't use for broad scene strategy, brand design, media sourcing, captions, or general video planning.

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 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