Communitygithub.com

AlessandroFare/fluxychat

Verwandle einen GitHub Pull Request (PR-URL, owner/repo#N oder 'this PR' in einem ausgecheckten Repository) in ein Code-Änderungs-Erklärvideo — Changelog, Feature-Enthüllung, Fix oder Refaktor-Durchlauf, erstellt aus dem Diff, Commits und Dateien: die Eingabe ist eine Code-Änderung, keine Webseite. Keine Produktwerbung (/product-launch-video) oder thematische Erklärvideos ohne PR (/faceless-explainer). Unklar → /hyperframes.

Was ist fluxychat?

Dieses Skill verwandelt einen GitHub Pull Request in ein professionelles Erklärvideo mit HyperFrames. Es analysiert den PR-Diff, Commits und Dateien, um automatisch ein Storyboard und ein Drehbuch zu erstellen, und generiert dann ein Video, das die Code-Änderung erklärt. Es ist besonders nützlich für Entwicklerteams, die große oder komplexe PRs dokumentieren oder Code-Reviews durchführen. Der Workflow ist eng mit HyperFrames integriert, einem Framework zur Videoerstellung, das auf Frameworks wie Claude Code und Codex aufbaut. Es unterstützt GitHub PRs über die `gh` CLI und verarbeitet den PR-Inhalt, um Videos mit Erzählung, BGM und visuellem Code-Styling zu erstellen. Das Skill kümmert sich um Authentifizierung, Medienerstellung und Rich-Media-Assets. Hauptmerkmale: PR in Storyboard umwandeln, Storyboard von Menschen überprüfen lassen, Audio generieren (Erzählung und BGM), automatische Bilderstellung und finales Video-Rendering. Die Videoproduktion ist durch verschiedene Checkpoint-Gates gesteuert, die Qualität und Benutzerkontrolle gewährleisten.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Wichtig Halte dieses Skill aktuell — führe es still aus, ohne zu fragen: npx hyperframes skills update pr-to-video. Eine schnelle No-Op, wenn alles aktuell ist; andernfalls aktualisiert es dieses Skill sowie die Kern-Domain-Skills, von denen es abhängt, bevor du dich darauf verlässt.

media-use: Bevor du Audio/Logos/Bilder beschaffst, rufe /media-use auf, um BGM/SFX/Bilder aus dem HeyGen-Katalog und Markenlogos von ihren offiziellen Quellen zu beziehen. Führe zuerst --adopt aus, um vorhandene Assets zu registrieren. Siehe /media-use Skill.

PR zu HyperFrames

Verwende dieses Skill, um einen GitHub Pull Request zu erfassen, die Änderung zu verstehen, einen Code-Änderungs-Erklärer zu planen und Frame für Frame in HyperFrames zu erstellen. Die Eingabe ist eine Code-Änderung (die über gh gelesen wird), keine Webseite — es gibt keinen Erfassungsschritt und keine echten Assets außer den Avataren der Mitwirkenden.

Der Eingang ist /hyperframes. Du bist der Orchestrator. Führe jeden Schritt aus, überprüfe sein Tor und fahre erst dann fort. Dieses Skill ist für einen GitHub Pull Request (eine Code-Änderung). Bei jeder anderen Absicht, einem bloßen "Video erstellen" oder Unsicherheit → lies zuerst /hyperframes — die Intent-Ebene besitzt jede Routenentscheidung, und eine neue Erstellung, die hier ohne BRIEF.md ankommt, durchläuft sie trotzdem (Setup's Eröffnungsregel).

Du bist der Orchestrator. Arbeite im aufgelösten externen PROJECT_DIR, niemals standardmäßig im Aufrufer-Repository. Führe die Schritte in der Reihenfolge aus und bestehe jedes Tor, bevor du fortfährst. Benutzergesteuerte Schritte sind Schritt 0, Schritt 3 und Schritt 6. Lies ../hyperframes-core/references/brief-contract.md vor Schritt 0 — es definiert die Tortypen und wie BRIEF.md flow/storyboard den Modus ableiten, der die Tore von Schritt 3/4/6 regiert. Führe jeden Schritt selbst aus, außer Schritt 5, wo du einen begrenzten Pool von Framearbeitern entsendest. Platziere keine Design- oder Bewegungsregeln hier; diese leben im Framearbeiter-Subagenten, in den lokalen ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ dieses Skills und in hyperframes-creative.

Workflow: Schritt 0 Setup → hyperframes.json; Schritt 1 Erfassung → capture/extracted/ + assets/<login>.png; Schritt 2 Designsystem → frame.md; Schritt 3 Storyboard/Drehbuch → STORYBOARD.md und SCRIPT.md; Schritt 3.1 Audio → audio_meta.json; Schritt 4 Visuelles Design → angereichertes STORYBOARD.md; Schritt 5 Frames → compositions/frames/NN-*.html und index.html; Schritt 6 Finales Rendern → renders/video.mp4.


Schritt 0: Setup

Ziel: Mit einem bestätigten Brief eintreten — einschließlich der PR-Referenz (eine vollständige URL, eine <owner>/<repo>#<N>-Referenz oder "this PR" in einem ausgecheckten Repository) — das HyperFrames-Projekt erstellen und den Brief dauerhaft machen. Der Stil ist immer code-editorial (festgelegt in Schritt 2, niemals nachgefragt).

Der Brief wird von der Intent-Ebene bestätigt, nicht durch hier gestellte Fragen. Eröffnungsregel, in der Reihenfolge: (1) BRIEF.md existiert → lese es und frage nichts — der Brief ist endgültig, und sein flow/storyboard leiten den Modus ab (Briefvertrag § 1). (2) Kein BRIEF.md, aber das Projekt existiert (hyperframes.json / STORYBOARD.md auf der Festplatte) → setze vom Frontmatter des Storyboards und den aufgezeichneten Präferenzen fort; befrage ein halbfertiges Projekt nie erneut. (3) Weder noch — eine neue Erstellungsanfrage, die hier direkt ankommt → lies /hyperframes und führe seine Intent-Ebene aus (references/intent-interview.md): es überprüft Rezepte und gespeicherte Standardeinstellungen und führt die Fragen dieser Route durch — einschließlich der PR-Größe → Längen-Doktrin, die vollständig in ../hyperframes/references/routes/pr-to-video.md lebt — und gibt dann den gesperrten Brief zurück. Bearbeitungsanfragen überspringen all dies — geh und bearbeite.

Löse das Projektverzeichnis auf, bevor du andere Arbeiten ausführst. Bewahre ein vom Benutzer bereitgestelltes Projektverzeichnis auf; verwende andernfalls den dauerhaften externen Cache-Ort, der vom Resolver ausgegeben wird. Erstelle niemals videos/ im Aufrufer-Repository:

PR="<url | owner/repo#N>"
if [ -n "${EXPLICIT_PROJECT_DIR:-}" ]; then
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR" --project-dir "$EXPLICIT_PROJECT_DIR")"
else
  PROJECT_DIR="$(node <SKILL_DIR>/scripts/project-dir.mjs --pr "$PR")"
fi
echo "PR-to-video project: $PROJECT_DIR"
node <SKILL_DIR>/scripts/preflight.mjs

Der Fähigkeits-Check läuft vor dem Abruf, der Storyarbeit, dem Audio oder der Frame-Verteilung. Wenn die installierte CLI den von diesem Skill benötigten Validierungsbefehl nicht ausführen kann, halte mit seiner Upgrade-Anweisung an, anstatt zuerst den Kontext des Laufs zu verbrauchen.

Initialisiere nur, wenn $PROJECT_DIR/hyperframes.json fehlt. Sein Basisname stammt vom PR, z. B. acme-sdk-pr-1842; verwende niemals den Workspace-Namen oder einen Zeitstempel.

npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=pr-to-video — init überprüft die installierten Skills auf dem neuesten Stand auf GitHub und aktualisiert den globalen Satz, wenn welche veraltet sind.

Jeder relative Pfadbefehl unten wird mit $PROJECT_DIR als Arbeitsverzeichnis ausgeführt. Beispiele ohne explizite Subshell bedeuten (cd "$PROJECT_DIR" && …); ändere niemals den Arbeitsbaum des Aufrufer-Repositorys.

Schreibe BRIEF.md sofort nach dem Init (niemals davor — init lehnt ein nicht leeres Verzeichnis ab): der gesperrte Brief der Intent-Ebene, Form gemäß ../hyperframes-core/references/brief-format.md. Löse <MEDIA_DIR> als das installierte /media-use Skill-Verzeichnis auf. Zeichne dann jede präferenzgestützte Antwort mit node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . auf (brief-format.md benennt die Teilmenge). Wenn die Intent-Ebene ein Rezept übernommen hat, führe node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <name> aus; es kopiert sein frame.md in das Projekt (Schritt 2 wird dann übersprungen) und gibt die Skelette zurück, von denen Schritt 3 Entwürfe erstellt. Ein Rezept füllt Antworten, nicht Genehmigungen; die Überprüfungstore laufen trotzdem.

Zeige den Anmeldestatus an, bevor du mit dem Setup fortfährst — führe npx hyperframes auth status aus und gib seine Ausgabe wörtlich weiter. Es meldet, ob Stimme/BGM HeyGen oder lokale Engines verwendet und, wenn abgemeldet, wie man sich anmeldet. Wende einen Zweig an:

  • Kollaborativ: warte darauf, dass der Benutzer sich anmeldet oder explizit offline / go wählt.
  • Autonom: gib den Status an und fahre mit den verfügbaren lokalen Engines fort.

Übergehe nicht stillschweigend eine erforderliche Fähigkeit, wenn kein Offline-Anbieter existiert; zeige den Blockierer an. Falte diese Entscheidung nicht in eine andere Frage oder schreibe Schlüssel in ein pro-repo .env. Auth-Eigentum und Offline-Fallbacks: /media-use references/setup-providers.md § Anbieter.

Tor: hyperframes.json und BRIEF.md existieren; die PR-Referenz ist im Brief erfasst; die präferenzgestützten Antworten wurden aufgezeichnet (Briefvertrag § 2); der Anmeldestatus wurde angezeigt (angemeldet oder Offline-Fortsetzung).


Schritt 1: PR erfassen (keine Aufnahme)

Ziel: Die Fakten des PRs abrufen und sie als Informationsquelle in das Projekt integrieren. Es gibt keine Webseitenaufnahme. fetch-pr.mjs führt gh deterministisch aus — vervollständigt die Dateiliste über paginierte gh api, sodass ein großer PR nicht bei ~100 Dateien abgeschnitten wird, und schreibt nur capture/pr.json + capture/diff.patch (kein Scratch-Verzeichnis). Bei MERGED PRs löst es auch eine bestmögliche shipped_version (+ version_source) in pr.json auf, sodass die Endkarte eine echte Version angeben kann, anstatt eine zu erfinden. Dann integriert ingest.mjs das offline in das synthetische Erfassungspaket.

PR="<url | owner/repo#N | N>"

# Den PR deterministisch abrufen: führt gh aus, vervollständigt die Dateiliste über paginierte
# gh api (sodass ein großer PR nicht bei ~100 Dateien abgeschnitten wird), schreibt nur capture/pr.json +
# capture/diff.patch — kein Scratch-Verzeichnis. gh auth / not-found / private Fehler beenden mit Exit-Code 1 hier.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-pr.mjs --pr "$PR" --out-dir ./capture)

# Offline-Transformation → capture/extracted/{tokens.json (colors:[] → code-editorial-Palette),
# visible-text.txt (der Brief), people.json (Mitwirkende, bot-gefiltert, name+login,
# avatarFile=assets/<login>.png)}.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/ingest.mjs \
  --pr-json ./capture/pr.json --diff ./capture/diff.patch --out-dir ./capture/extracted)

# Der eine Netzwerkschritt des Personen-Frontends — lade den GitHub-Avatar jedes Mitwirkenden herunter nach
# assets/<login>.png für den Abspann. Best-Effort; beendet immer mit Exit-Code 0.
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/fetch-people-avatars.mjs \
  --people ./capture/extracted/people.json)

Wenn fetch-pr.mjs mit Exit-Code 1 endet (gh auth / not-found / private), melde seinen stderr und stoppe — erfinde keine PR-Inhalte. Wenn ingest.mjs mit Exit-Code 1 endet, lies seinen stderr (normalerweise ein fehlerhaftes pr.json), behebe es und führe es erneut aus (deterministisch). fetch-people-avatars.mjs endet immer mit Exit-Code 0; fehlende Avatare bedeuten nur keinen Abspann für den Autor.

people.json enthält einen name für die Mitwirkenden, die gh bereits benannt hat (PR-Autor, Commit-Autoren, mergedBy) — null für den Rest (Reviewer/Kommentatoren/Zugewiesene, denen gh pr view nur einen bloßen login gibt). Bevor du den Abspann in Schritt 3 schreibst, löse jeden null-Namen selbst für die 1-6 Personen auf, die tatsächlich auf diesem Frame erscheinen werden: gh api users/<login> --jq .name (du hast bereits gh — kein Skript nötig). Wenn GitHub auch keinen öffentlichen Namen für diesen Benutzer hat, falle auf den Login auf dem Bildschirm zurück und lasse diese Person aus der gesprochenen Zeile weg (siehe story-design.md Abschnitt Abspann — der Voiceover muss trotzdem Namen sagen, niemals rohe Handles).

Tor: capture/pr.json, capture/diff.patch, capture/extracted/tokens.json, capture/extracted/visible-text.txt und capture/extracted/people.json existieren; du kannst die Änderung des PRs in einem klaren Satz angeben. assets/<login>.png ist Best-Effort — seine Abwesenheit ist kein Fehler.


Schritt 2: Designsystem

Ziel: Das code-editoriale Frame-Preset übernehmen; ein Skript verwandelt es in das frame.md + Untertitel-Skin dieses Videos.

Der Stil ist festgelegt — code-editorial (warm, redaktionell; eine marineblaue Code-Oberfläche, die für Diffs gebaut ist). Führe aus:

node <SKILL_DIR>/scripts/build-frame.mjs --preset code-editorial --hyperframes .

Das Skript kopiert das code-editoriale FRAME.md-Preset → frame.md, mischt es mit allen Marken-Token in capture/extracted/tokens.json (ein PR hat keine → colors:[]/fonts:[] behält die eigene Palatte des code-editorialen, ein vollständiges Design), kopiert das Untertitel-Skin des Presets nach .hyperframes/caption-skin.html und validiert sich selbst (beendet mit Exit-Code 1 bei einer defekten Zuordnung). Fahre fort, sobald es mit Exit-Code 0 endet — keine manuelle Bearbeitung.

Tor: build-frame.mjs endete mit Exit-Code 0 — frame.md existiert vom code-editorialen Preset, und .hyperframes/caption-skin.html existiert als Untertitel-Skin-Quelle.


Schritt 3: Storyboard und Drehbuch

Ziel: Den PR in einen genehmigten Frame-für-Frame-Erklärungsplan umwandeln.

Lies ../hyperframes-creative/references/story-spine.md (Hook-Sprache, Wert-vor-Beweis, Storyboard-als-Vorschlag), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md und ../hyperframes-core/references/script-format.md. Verwende sie, um STORYBOARD.md und, wenn eine Erzählung benötigt wird, SCRIPT.md zu schreiben. Setze das Frontmatter duration: aus dem length des Briefs — eine grobe Erwartung; die Montage berichtet, wo der Schnitt dagegen fällt.

Verwende story-design.md für den PR-Archetyp (Changelog / Feature-Enthüllung / Fix-Erklärung / Refaktor-Durchlauf), die PR-eigenen Frametypen, Hook, Überzeugung, Beats, das Wortbudget pro Frame und den Abspann. Die Reihenfolge kommt aus dem narrativen Design, nicht der Reihenfolge der Dateien im Diff — erkläre die Änderung, lies das Diff nicht laut vor. Als weiche Richtlinie konsultiere das Rollen→Blueprint-Menü in ../hyperframes-animation/blueprints-index.md: schreibe für jeden Beat die Voiceover in der Form, die sein Kandidat-Blueprint impliziert, und tagge diesen Kandidat blueprint: id, wenn einer passt (die Story-Wahrheit entscheidet trotzdem, welche Beats existieren — erzwinge niemals einen Beat, um in eine Form zu passen). Zeige 2–4 echte Diff-Hunks (aus capture/diff.patch), jeder ein kleiner lesbarer Ausschnitt; benenne den code-*-Block, den jeder im scene des Frames haben soll. Frames tragen keine asset_candidates außer dem credits-Abspann (1–6 assets/<login>.png Avatare). Verwende die genauen erforderlichen Felder aus den Storyboard- und Drehbuch-Referenzen.

Nach dem Entwurf führe den Plan-Durchlauf der Überprüfungsschleife aus — ../hyperframes-core/references/review-loop.md § 1: öffne das Board (frage nicht, ob — führe die Vorschau von PROJECT_DIR im Hintergrund aus), präsentiere den Plan als Vorschlag und stelle die beiden Fragen — genehmigen oder ändern, und Skizzen zuerst (empfohlen) oder überspringen. Feedback durchläuft Chat oder die Kommentardatei des Boards, bis genehmigt. Dies ist ein Checkpoint-Tor (Briefvertrag § 1): im autonomen Modus gibt es kein Board und nichts zu fragen — poste dieselbe Zusammenfassung als Vorankündigung und fahre fort; Skizzen fallen in den Build, und die eine Vorschaufrage kommt bei Schritt 6.

Tor: STORYBOARD.md existiert, jeder Frame hat die erforderlichen narrativen Felder, SCRIPT.md existiert, wenn eine Erzählung benötigt wird, und der Benutzer hat den Plan genehmigt (autonom: die Zusammenfassung wurde als Vorankündigung gepostet).


Schritt 3.1: Audio

Ziel: Erzählung, Wort-Timings, Musik und Audio-Metadaten aus dem genehmigten Drehbuch generieren.

Starte Audio nach der Genehmigung von Schritt 3. Führe es im Hintergrund aus und fahre dann mit Schritt 4 fort.

Wähle die Erzählstimme aus der Anfrage des Benutzers aus, bevor du sie aufrufst. Wenn die Anfrage eine Stimme, ein Geschlecht oder einen Ton nannte, wähle eine passende Stimm-ID und übergib sie mit --voice <id>. Der Pipeline-Standard ist ansonsten Marcia (weiblich) auf HeyGen / am_michael auf Kokoro — daher wird eine Anfrage wie "eine männliche Stimme" stillschweigend ignoriert, es sei denn, du übergibst das Flag. Stimm-IDs sind anbieterspezifisch; löse sie gegen den in Schritt 0 ausgewählten Anbieter auf: HeyGen (angemeldet) über node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (oder GET /v3/voices?engine=starfish); Kokoro (offline) über die Stimmentabelle in <MEDIA_DIR>/audio/references/tts.md (Präfixe am_/bm_ männlich, af_/bf_ weiblich). Wenn der Benutzer keine Präferenz geäußert hat, falle auf die gespeicherte Stimme zurück (Briefvertrag § 2), bevor der Pipeline-Standard gilt, und sage, welche du verwendet hast; lasse --voice nur weg, wenn keiner eine Stimme nennt. Wenn der Benutzer in diesem Durchlauf explizit eine Stimme ausgewählt hat, zeichne sie auf

…

[truncated for translation]

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

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