Communitygithub.com

scott-fryxell/brayness

Erstellen Sie Videokompositionen, Animationen, Titelbilder, Overlays, Untertitel, Sprachaufnahmen, audio-reaktive Visuals und Szenenübergänge in HyperFrames HTML. Verwenden Sie es für jede HTML-basierte Videoproduktion – vom Komponieren über das Synchronisieren von Untertiteln mit Audio, das Generieren von TTS-Erzählungen, die Durchführung der Entwicklungsschleife (init, lint, inspect, preview, render), die Vorverarbeitung von Assets (tts, transcribe, remove-background) bis hin zur Installation/Beitrag von Registry-Blöcken.

Was ist brayness?

Dieses Skill für KI-Agenten (z. B. Claude Code, Cursor, Codex) automatisiert die Videoproduktion mit dem HyperFrames-Framework, wobei HTML als zentrale Quelle der Wahrheit dient. Es wandelt offene Anfragen („Erstelle ein Produkt-Launch-Video“) in einen strukturierten Workflow um: Designsystem erkunden, Prompt erweitern, Komposition planen, Layout vor Animation erstellen und schließlich mit GSAP animieren. Das Skill stellt sicher, dass jede Komposition deterministisch, synchron und fehlerfrei aufgebaut ist – mit strikten Regeln gegen Zufallszahlen, asynchrone Timeline-Konstruktion oder unerlaubte Animationen. Es unterstützt die Entwicklungsschleife (lint, validate, inspect, preview, render) und bietet Referenzen für Untertitel, Audio-Reaktivität, Typografie, Szenenübergänge und mehr. Entwickler können damit schnell professionelle, HTML-basierte Videos mit TTS, Transkription und Hintergrundentfernung erstellen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/scott-fryxell/brayness/tree/HEAD/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames

HTML ist die Quelle der Wahrheit für Video. Eine Komposition ist eine HTML-Datei mit data-*-Attributen für das Timing, einer GSAP-Timeline für Animationen und CSS für das Aussehen. Das Framework übernimmt die Clip-Sichtbarkeit, Medienwiedergabe und Timeline-Synchronisation.

Attribut-API, Kompositions-/Template-Struktur, Variablen und Medienregeln: references/authoring.md. Lesen Sie es, bevor Sie Ihre erste Kompositions-HTML in einer Sitzung schreiben.

Vorgehensweise

Entdeckung (nur bei explorativen Anfragen)

Bei offenen Anfragen („Erstellen Sie ein Produkt-Launch-Video“), bei denen der Benutzer keine Richtung festgelegt hat, verstehen Sie die Absicht, bevor Sie Farben auswählen: Zielgruppe, Plattform, Priorität (Bewegungsqualität vs. Genauigkeit vs. Geschwindigkeit) und ob der Benutzer Variationen wünscht. Bei Variationen bieten Sie 2–3 an, die sich im Tempo oder in der Struktur unterscheiden – eine sichere, eine ambitionierte – keine Farbwechsel.

Bei spezifischen Anfragen („Fügen Sie eine Titelgrafik hinzu“, „Korrigieren Sie das Timing von Szene 3“) überspringen Sie die Entdeckung.

Schritt 1: Designsystem

Wenn design.md oder DESIGN.md vorhanden ist, lesen Sie es zuerst (beide Schreibweisen – es handelt sich auf Linux um unterschiedliche Dateien). Es ist die Quelle der Wahrheit für Markenfarben, Schriftarten und Einschränkungen – verwenden Sie seine exakten Werte. Wenn es Schriftarten benennt, für die keine .woff2-Dateien in fonts/ vorhanden sind und keine integrierte Entsprechung vorhanden ist, warnen Sie den Benutzer vor dem Schreiben von HTML.

Wenn keine design.md vorhanden ist, bieten Sie eine Auswahl an:

  1. Hat der Benutzer einen Stil oder eine Stimmung genannt? Lesen Sie visual-styles.md (8 benannte Voreinstellungen) und wählen Sie die nächstgelegene.
  2. Visuell stöbern? Führen Sie die Design-Auswahl aus - references/design-picker.md.
  3. Schnell vorgehen? Fragen Sie nach Stimmung, hell/dunkel, Markenfarben/Schriftarten; wählen Sie eine Palette aus house-style.md.

design.md definiert die Marke, nicht die Videokompositionsregeln. Diese stammen aus references/video-composition.md und house-style.md. Markenfarben in Videogröße, nicht Web-UI-Opazität.

Schritt 2: Prompt-Erweiterung

Wird bei jeder Komposition ausgeführt, außer bei Einzelszenenstücken und trivialen Änderungen – verankert die Absicht an design.md/house-style.md in einem konsistenten Zwischenschritt. Prozess und Format: references/prompt-expansion.md.

Schritt 3: Planen

  1. Was - Erzählbogen, Schlüsselmomente, emotionale Schwerpunkte.
  2. Struktur - wie viele Kompositionen, Sub-Kompositionen vs. inline, welche Spuren tragen was.
  3. Rhythmus - deklarieren Sie den Szenenrhythmus vor der Implementierung (schnell-schnell-LANGSAM-schnell-SHADER-Haltepunkt). Vorlagen: references/beat-direction.md.
  4. Timing - welche Clips die Dauer bestimmen, wo Übergänge stattfinden.
  5. Layout - erstellen Sie zuerst den Endzustand (nächster Abschnitt).
  6. Animieren - fügen Sie dann Bewegung hinzu.

Erstellen Sie, worum gebeten wurde. „Eine Titelgrafik“ ist nicht „eine Titelgrafik + 3 unterstützende Szenen + Musik + Untertitel.“ Schlagen Sie Ergänzungen vor; fügen Sie sie nicht hinzu.

Bei kleinen Änderungen springen Sie direkt zu den Regeln.

Layout vor Animation

Positionieren Sie jedes Element dort, wo es in seinem sichtbarsten Moment sein soll - vollständig eingetreten, korrekt platziert, noch nicht austretend. Schreiben Sie dies zuerst als statisches HTML+CSS. Noch kein GSAP.

Warum: Wenn Sie Elemente in ihrem animierten Startzustand positionieren (außerhalb des Bildschirms, Opazität 0) und in Richtung des vermeintlichen Endzustands tweenen, raten Sie das endgültige Layout, und Überlappungen bleiben bis zum Rendern unsichtbar. Bauen Sie zuerst den Endzustand, dann sind Layout-Fehler sichtbar, bevor Bewegung existiert.

  1. Identifizieren Sie den Hero-Frame pro Szene - den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Erstellen Sie dieses Layout.
  2. Schreiben Sie statisches CSS dafür. .scene-content MUSS die Szene ausfüllen: width: 100%; height: 100%; padding: Npx; mit display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Padding drückt den Inhalt nach innen - NIEMALS position: absolute; top: Npx auf einem Inhaltscontainer (er läuft über, wenn der Inhalt wächst). Reservieren Sie absolute Positionierung für dekorative Elemente.
  3. Eingänge mit gsap.from() - animieren VON außerhalb des Bildschirms ZUR CSS-Position. CSS ist die Grundwahrheit; der Tween ist die Reise. (Sub-Kompositionen, die über data-composition-src geladen werden: bevorzugen Sie gsap.fromTo() - siehe references/motion-principles.md.)
  4. Nur letzte Szene: Ausgänge mit gsap.to(). Alle anderen Szenen enden vollständig sichtbar - der Übergang IST der Ausgang (Übergangsregel 3 unten).

Wenn Element A aussteigt, bevor Element B im selben Bereich eintritt, geben Sie beiden korrekte CSS-Positionen für ihre eigenen Hero-Frames - die Timeline verhindert, dass sie koexistieren, und der Layout-Schritt fängt versehentliche Überlappungen durch Timing-Fehler auf. Absichtliche Schichtung (Glühen hinter Text, Kartenstapel) ist in Ordnung; der Schritt dient dazu, unbeabsichtigte Überlappungen zu erkennen - zwei Überschriften, die kollidieren, eine Statistik, die ein Label bedeckt, Inhalt außerhalb des Frames.

Timeline-Vertrag

  • Alle Timelines starten { paused: true } - der Player steuert die Wiedergabe
  • Registrieren Sie jede Timeline: window.__timelines["<composition-id>"] = tl
  • Das Framework verschachtelt Unter-Timelines automatisch - fügen Sie sie NICHT manuell hinzu
  • Die Dauer ergibt sich aus data-duration, nicht aus der GSAP-Timeline-Länge
  • Erstellen Sie niemals leere Tweens, um die Dauer festzulegen

Regeln (Nicht verhandelbar)

Deterministisch: kein Math.random(), Date.now() oder zeitbasierte Logik. Gesäter PRNG (z. B. mulberry32) für Pseudo-Zufall.

GSAP: animieren Sie nur visuelle Eigenschaften (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, Transforms). Animieren Sie niemals visibility oder display; rufen Sie niemals video.play()/audio.play() auf.

Animationskonflikte: animieren Sie niemals dieselbe Eigenschaft auf demselben Element von mehreren Timelines gleichzeitig.

Kein repeat: -1: unendliche Wiederholungen brechen die Capture-Engine. Berechnen Sie repeat: Math.ceil(duration / cycleDuration) - 1.

Synchrone Timeline-Konstruktion: erstellen Sie Timelines niemals innerhalb von async/await, setTimeout oder Promises - die Capture-Engine liest window.__timelines synchron nach dem Laden. Schriftarten werden vom Compiler eingebettet; kein Warten auf Schriftarten-Laden.

Niemals tun:

  1. window.__timelines-Registrierung vergessen
  2. Video für Audio verwenden - immer stummgeschaltetes Video + separates <audio>
  3. Video in einem getakteten Div verschachteln - einen nicht getakteten Wrapper verwenden
  4. data-layer verwenden (data-track-index verwenden) oder data-end (data-duration verwenden)
  5. Videoelementabmessungen animieren - einen Wrapper-Div animieren
  6. play/pause/seek auf Medien aufrufen - Framework besitzt die Wiedergabe
  7. Einen Top-Level-Container ohne data-composition-id erstellen
  8. repeat: -1 auf einer Timeline oder einem Tween verwenden
  9. Timelines asynchron erstellen
  10. gsap.set() auf Clip-Elementen aus späteren Szenen verwenden - sie existieren nicht im DOM beim Seitenladen. Verwenden Sie tl.set(selector, vars, timePosition) bei oder nach dem data-start des Clips.
  11. <br> im Inhaltstext verwenden - es stapelt sich mit natürlichem Umbruch und verursacht Überlappungen; stattdessen max-width verwenden. Ausnahme: kurze Anzeigetitel absichtlich ein Wort pro Zeile.

Szenenübergänge (Nicht verhandelbar)

Jede Multi-Szenen-Komposition MUSS alle vier befolgen. Die Verletzung einer einzigen ist eine kaputte Komposition.

  1. IMMER Übergänge zwischen Szenen verwenden. Keine Jump-Cuts.
  2. IMMER jedes Element IN via gsap.from() animieren. Nichts erscheint vollständig geformt. Fünf Elemente bedeuten fünf Eingangs-Tweens.
  3. Niemals Ausgangsanimationen verwenden, außer in der letzten Szene. Kein gsap.to(), das die Opazität verblassen lässt, aus dem Bildschirm bewegt oder auf 0 skaliert, bevor ein Übergang stattfindet - der Übergang IST der Ausgang, und die ausgehende Szene muss vollständig sichtbar sein, wenn er ausgelöst wird. Ein Ausgangs-Tween vor einem Übergang übergibt dem Übergang einen leeren Frame.
  4. Nur die letzte Szene kann Elemente ausblenden.

Übergangsauswahl und -implementierung: references/transitions.md.

Animations-Leitplanken

  • Erste Animation um 0,1-0,3s versetzen (nicht bei t=0)
  • Eases variieren - mindestens 3 verschiedene Eases pro Szene, kein wiederholtes Eingangsmuster innerhalb einer Szene
  • Vollbild-lineare Verläufe auf dunklen Hintergründen vermeiden (H.264-Banding) - radial oder einfarbig + lokalisierter Glow
  • 60px+ Überschriften, 20px+ Fließtext, 16px+ Datenbeschriftungen
  • font-variant-numeric: tabular-nums bei Zahlenspalten

Bearbeiten bestehender Kompositionen

  • Tatsächliche Dateien lesen, nicht raten. Die Komposition IST die Spezifikation - extrahieren Sie exakte Hex-Codes, Schriftarten und Easing-Muster aus der Quelle, nicht aus dem Gedächtnis.
  • Nur das ändern, was angefordert wurde; Timing nicht betroffener Clips beibehalten.

Ausgabe-Checkliste

Schnell (sofort ausführen, blockieren bei Ergebnissen):

  • npx hyperframes lint und npx hyperframes validate bestehen beide
  • Designeinhaltung verifiziert, falls design.md vorhanden

Langsam (parallel ausführen, während die Vorschau präsentiert wird):

  • npx hyperframes inspect besteht, oder jeder gemeldete Überlauf ist absichtlich markiert
  • Kontrastwarnungen behandelt
  • Animationschoreografie verifiziert (Animationskarten-Skript)

Wie man jede Prüfung ausführt und behebt: references/quality-checks.md.

Referenzindex

Immer lesen für jede neue Komposition:

DateiDeckt ab
references/authoring.mddata-Attribute, Template-Struktur, Variablen, Video/Audio, Schriftarten/Assets
references/video-composition.mdVideomedium-Regeln - diese überschreiben Web-Instinkte
references/typography.mdSchriftpaarung, OpenType, Anpassungen für dunkle Hintergründe
references/motion-principles.mdBewegungsdesign, Bildbewegung, tragende GSAP-Regeln

Auch immer lesen für Multi-Szenen-Kompositionen:

DateiDeckt ab
references/beat-direction.mdRhythmus-Vorlagen, Choreografie-Verben, Tiefenschichten
references/transitions.mdÜbergangsauswahl; Katalog führt zu Implementierungen; Shader-Übergänge befinden sich im @hyperframes/shader-transitions npm-Paket (lesen Sie seinen Quellcode in node_modules)

Lesen, wenn die Aufgabe es erfordert:

DateiLesen, wenn
references/quality-checks.mdAusführen von inspect/contrast/design/animation-map-Prüfungen
references/cli.mdJeder CLI-Befehl; Build/Render-Fehlerbehebung
references/captions.mdJeder Text, der mit Audio-Timing synchronisiert ist
references/transcript-guide.mdUntertitel-seitige Transkriptverarbeitung (CLI-Aufruf befindet sich in media.md)
references/dynamic-techniques.mdDynamische Untertitel-Animation (Karaoke, Slam, Scatter)
references/audio-reactive.mdVisuals, die auf Musik/Stimme reagieren
references/css-patterns.mdMarker-Hervorhebung (highlight, circle, burst, scribble)
references/techniques.mdPlanungstechniken pro Beat (11 Muster mit Code)
references/narration.mdVoiceover/TTS-Tempo und Skriptstruktur
references/media.mdTTS (Kokoro), Transkription (Whisper), Hintergrundentfernung
references/prompt-expansion.mdSchritt 2 des Vorgehens
references/design-picker.mdErstellen einer design.md visuell
references/from-website.mdEine Website in ein Video verwandeln
references/registry.mdInstallieren/Beitragen von Registry-Blöcken (hyperframes add)
visual-styles.mdBenutzer nennt einen Stil; Generieren von design.md
house-style.mdÄsthetische Standardeinstellungen, wenn keine design.md vorhanden
patterns.mdPiP, Titelgrafiken, Diashows
data-in-motion.mdDaten, Statistiken, Infografiken

Laufzeit-Adapter (lesen, wenn die Komposition diese Laufzeit anstelle von GSAP verwendet): waapi, lottie, three, animejs, css-animations, typegpu.

Verwandte Skills