Communitygithub.com

KingBridgeSS/sakugacut

Erstellen Sie Videokompositionen, Animationen, Titelsequenzen, Overlays, Untertitel, Sprachaufnahmen, audio-reaktive Visualisierungen und Szenenübergänge in HyperFrames HTML.

Was ist sakugacut?

Diese Fähigkeit befähigt KI-Agenten (wie Claude Code, Cursor oder Codex), komplexe Videoproduktionen direkt über HTML zu erstellen und zu steuern. Der Kernansatz ist 'HTML als Quelle der Wahrheit': Eine Komposition ist eine HTML-Datei, die mit `data-*`-Attributen das Timing, einer GSAP-Timeline die Animation und CSS das visuelle Erscheinungsbild definiert. Die Fähigkeit führt durch einen strukturierten Workflow: Zuerst wird ein Designsystem (Farben, Schriftarten) aus einer `design.md`-Datei ermittelt oder über eine interaktive Auswahl erstellt. Danach erfolgt eine 'Prompt Expansion', um die Benutzerintention zu schärfen. Der Workflow betont die 'Layout-vor-Animation'-Methode, bei der zuerst der Endzustand einer Szene als statisches CSS positioniert wird, um Überlappungen zu vermeiden, bevor Bewegungen mit `gsap.from()` und `gsap.to()` hinzugefügt werden. Die Fähigkeit unterstützt Unterkompositionen, parametrisierte Kompositionen mit Variablen und eine strikte Datenattribut-Struktur für präzises Timing und Tracks.

Funktioniert mit~Claude Code✓Codex CLI✓Cursor
npx skills add https://github.com/KingBridgeSS/sakugacut/tree/HEAD/hyperframes_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 Animation und CSS für das Erscheinungsbild. Das Framework kümmert sich um Clip-Sichtbarkeit, Medienwiedergabe und Zeitleisten-Synchronisation.

Ansatz

Erkundung (nur für explorative Anfragen)

Für offene Anfragen ("Erstelle mir ein Produktlaunch-Video", "Erstelle etwas für unsere Marke"), bei denen der Benutzer sich noch nicht festgelegt hat, verstehe die Absicht, bevor du Farben auswählst:

  • Zielgruppe — Wer sieht sich das an? Entwickler? Führungskräfte? Allgemeine Verbraucher?
  • Plattform — Wo wird es abgespielt? Social Media (15s), Website-Hero, Produktdemo, intern?
  • Priorität — Was ist am wichtigsten? Bewegungsqualität? Inhaltsgenauigkeit? Markentreue? Geschwindigkeit?
  • Variationen — Möchte der Benutzer Optionen oder einen einzigen besten Versuch?

Bei spezifischen Anfragen ("Füge eine Titelsequenz hinzu", "Korrigiere das Timing in Szene 3") überspringe die Erkundung.

Erwäge bei explorativen Anfragen, 2-3 Variationen anzubieten, die sich sinnvoll unterscheiden — nicht nur Farbtausch, sondern unterschiedliches Tempo, Energieniveaus oder strukturelle Ansätze. Eine sichere/erwartete, eine ambitionierte. Erzwinge dies nicht — es ist ein Werkzeug, das bei Bedarf zur Verfügung steht.

Schritt 1: Designsystem

Wenn design.md oder DESIGN.md im Projekt existiert, lese sie zuerst (überprüfe beide Schreibweisen — es sind auf Linux unterschiedliche Dateien). Sie ist die Quelle der Wahrheit für Markenfarben, Schriftarten und Einschränkungen. Verwende ihre exakten Werte — erfinde keine Farben oder ersetze keine Schriftarten. Jedes Format ist zulässig (YAML-Frontmatter, Prosa, Tabellen — extrahiere einfach die Werte).

Wenn sie Schriftarten nennt, die du lokal nicht finden kannst (kein fonts/-Verzeichnis mit .woff2-Dateien, keine integrierte Schriftart), warne den Benutzer, bevor du HTML schreibst: „design.md gibt die Schriftart [Schriftartname] vor, aber es wurden keine Schriftdateien gefunden. Bitte fügen Sie .woff2-Dateien zu fonts/ hinzu, oder ich verwende als Fallback die nächstgelegene integrierte Alternative.“

Wenn keine design.md existiert, biete dem Benutzer eine Auswahl an:

  1. Hat der Benutzer einen Stil oder eine Stimmung genannt? → Lese visual-styles.md für die 8 benannten Voreinstellungen. Wähle die beste Übereinstimmung.
  2. Möchte der Benutzer visuelle Optionen durchstöbern? → Führe die Design-Auswahl aus: Lese references/design-picker.md für den vollständigen Workflow. Dies stellt eine visuelle Auswahlseite bereit. Der Benutzer konfiguriert Stimmung, Palette, Typografie und Bewegung im Browser, kopiert dann die generierte design.md und fügt sie zurück in die Konversation ein.
  3. Möchte der Benutzer überspringen und schnell fortfahren? → Frage: Stimmung, hell oder dunkel, irgendwelche Markenfarben/Schriftarten? Wähle dann eine Palette aus house-style.md.

design.md definiert die Marke. Sie definiert keine Videokompositionsregeln. Diese stammen aus references/video-composition.md und house-style.md. Verwende Markenfarben in einer für Video geeigneten Größenordnung — nicht in der Deckkraft von Web-UI.

Schritt 2: Prompt-Erweiterung

Führe dies immer bei jeder Komposition durch (außer bei Ein-Szenen-Stücken und trivialen Bearbeitungen). Dieser Schritt verankert die Absicht des Benutzers anhand von design.md und house-style.md und erzeugt ein konsistentes Zwischenprodukt, das jeder nachgelagerte Agent auf die gleiche Weise liest.

Lese references/prompt-expansion.md für den vollständigen Prozess und das Ausgabeformat.

Schritt 3: Plan

Bevor du HTML schreibst, denke auf hohem Niveau:

  1. Was — Was soll der Zuschauer erleben? Identifiziere den narrativen Bogen, Schlüsselmomente und emotionale Schwerpunkte.
  2. Struktur — Wie viele Kompositionen, welche sind Unterkompositionen vs. inline, welche Spuren tragen was (Video, Audio, Overlays, Untertitel).
  3. Rhythmus — Gib deinen Szenenrhythmus an, bevor du ihn implementierst. Welche Szenen sind schnelle Treffer, welche sind Halte, wo landen Shader, wo ist der Energiehöhepunkt. Benenne das Muster: schnell-schnell-LANGSAM-schnell-SHADER-Halte. Lese references/beat-direction.md für Rhythmusvorlagen.
  4. Timing — Welche Clips bestimmen die Dauer, wo landen Übergänge, wie ist das Tempo.
  5. Layout — Baue zuerst den Endzustand. Siehe „Layout vor Animation“ unten.
  6. Animieren — Füge dann Bewegung mit den folgenden Regeln hinzu.

Baue das, was gefragt wurde. Eine Anfrage nach „einer Titelsequenz“ ist keine Anfrage nach „einer Titelsequenz + 3 unterstützenden Szenen + Hintergrundmusik + Untertiteln.“ Jede Szene, jedes Element, jeder Tween sollte seinen Platz verdienen. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlage sie vor — füge sie nicht einfach hinzu.

Bei kleinen Bearbeitungen (eine Farbe korrigieren, Timing anpassen, ein Element hinzufügen) springe direkt zu den Regeln.

Layout vor Animation

Positioniere jedes Element dort, wo es in seinem sichtbarsten Moment sein soll — dem Frame, in dem es vollständig eingetreten, korrekt platziert und noch nicht im Begriff ist zu verlassen. Schreibe dies zuerst als statisches HTML+CSS. Noch kein GSAP.

Warum das wichtig ist: Wenn du Elemente in ihrem animierten Startzustand positionierst (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und sie dorthin tweenst, wo du denkst, dass sie landen sollen, rätst du das endgültige Layout. Überlappungen bleiben unsichtbar, bis das Video gerendert wird. Indem du zuerst den Endzustand baust, kannst du Layout-Probleme sehen und beheben, bevor du Bewegung hinzufügst.

Der Prozess

  1. Identifiziere den Helden-Frame für jede Szene — den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Dieses Layout baust du.
  2. Schreibe statisches CSS für diesen Frame. Der .scene-content-Container MUSS die gesamte Szene ausfüllen, indem er width: 100%; height: 100%; padding: Npx; mit display: flex; flex-direction: column; gap: Npx; box-sizing: border-box verwendet. Verwende Padding, um Inhalt nach innen zu drücken — verwende NIEMALS position: absolute; top: Npx auf einem Inhaltscontainer. Absolut positionierte Inhaltscontainer laufen über, wenn der Inhalt höher ist als der verbleibende Platz. Behalte position: absolute nur für dekorative Elemente vor.
  3. Füge Eingänge mit gsap.from() hinzu — animiere VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position. Die CSS-Position ist die Grundwahrheit; der Tween beschreibt den Weg dorthin. (Bei Unterkompositionen, die über data-composition-src geladen werden, bevorzuge gsap.fromTo() — siehe tragende GSAP-Regeln in references/motion-principles.md.)
  4. Füge Ausgänge mit gsap.to() hinzu — animiere ZU außerhalb des Bildschirms/unsichtbar VON der CSS-Position.

Beispiel

/* scene-content füllt die Szene, Padding positioniert den Inhalt */
.scene-content {
  display: flex;
  flex-direction: column;
  justify-content: center;
  width: 100%;
  height: 100%;
  padding: 120px 160px;
  gap: 24px;
  box-sizing: border-box;
}
.title {
  font-size: 120px;
}
.subtitle {
  font-size: 42px;
}
/* Container füllt jede Szenengröße (1920x1080, 1080x1920, etc.).
   Padding positioniert Inhalt. Flex + Gap handhabt Abstände. */

FALSCH — fest codierte Abmessungen und absolute Positionierung:

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Schritt 3: IN diese Positionen animieren
tl.from(".title", { y: 60, opacity: 0, duration: 0.6, ease: "power3.out" }, 0);
tl.from(".subtitle", { y: 40, opacity: 0, duration: 0.5, ease: "power3.out" }, 0.2);
tl.from(".logo", { scale: 0.8, opacity: 0, duration: 0.4, ease: "power2.out" }, 0.3);

// Schritt 4: AUS diesen Positionen animieren
tl.to(".title", { y: -40, opacity: 0, duration: 0.4, ease: "power2.in" }, 3);
tl.to(".subtitle", { y: -30, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.1);
tl.to(".logo", { scale: 0.9, opacity: 0, duration: 0.3, ease: "power2.in" }, 3.2);

Wenn Elemente sich Raum über die Zeit teilen

Wenn Element A verlässt, bevor Element B in denselben Bereich eintritt, sollten beide korrekte CSS-Positionen für ihre jeweiligen Helden-Frames haben. Die Zeitleisten-Reihenfolge garantiert, dass sie nie visuell koexistieren — aber wenn du den Layout-Schritt überspringst, wirst du den Fall nicht bemerken, in dem sie aufgrund eines Timing-Fehlers versehentlich überlappen.

Was als beabsichtigte Überlappung gilt

Überlagerte Effekte (Glühen hinter Text, Schattenelemente, Hintergrundmuster) und Z-Stack-Designs (Kartenstapel, Tiefenschichten) sind beabsichtigt. Der Layout-Schritt dient dazu, unbeabsichtigte Überlappungen zu erkennen — zwei Überschriften, die aufeinander landen, eine Statistik, die ein Label bedeckt, Inhalt, der aus dem Frame läuft.

Datenattribute

Alle Clips

AttributErforderlichWerte
idJaEindeutiger Bezeichner
data-startJaSekunden oder Clip-ID-Referenz ("el-1", "intro + 2")
data-durationErforderlich für img/div/compositionsSekunden. Video/Audio standardmäßig Mediendauer.
data-track-indexJaGanzzahl. Clips auf demselben Track dürfen sich nicht überlappen.
data-media-startNeinZuschneide-Offset in die Quelle (Sekunden)
data-volumeNein0-1 (Standard 1)

data-track-index hat keinen Einfluss auf die visuelle Schichtung — verwende CSS z-index.

Kompositions-Clips

AttributErforderlichWerte
data-composition-idJaEindeutige Kompositions-ID
data-startJaStartzeit (Root-Komposition: verwende "0")
data-durationJaHat Vorrang vor der GSAP-Zeitleistendauer
data-width / data-heightJaPixelmaße (1920x1080 oder 1080x1920)
data-composition-srcNeinPfad zur externen HTML-Datei
data-variable-valuesNeinJSON-Objekt mit instanzspezifischen Variablenüberschreibungen auf einem Sub-Comp-Host

Auf dem Root-<html>-Element:

AttributErforderlichWerte
data-composition-variablesNeinJSON-Array deklarierter Variablen (id/type/label/default) — steuert die Studio-Bearbeitungs-UI und stellt Standardwerte für getVariables() bereit

Kompositionsstruktur

Unterkompositionen, die über data-composition-src geladen werden, verwenden einen <template>-Wrapper. Eigenständige Kompositionen (die main index.html) verwenden KEINEN <template> — sie setzen das data-composition-id-Div direkt in <body>. Die Verwendung von <template> in einer eigenständigen Datei verbirgt den gesamten Inhalt vor dem Browser und unterbricht das Rendern.

Unterkompositionsstruktur:

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- Inhalt -->
    <style>
      [data-composition-id="my-comp"] {
        /* bereichsbezogene Stile */
      }
    </style>
    <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
    <script>
      window.__timelines = window.__timelines || {};
      const tl = gsap.timeline({ paused: true });
      // tweens...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Laden im Root: <div id="el-1" data-composition-id="my-comp" data-composition-src="compositions/my-comp.html" data-start="0" data-duration="10" data-track-index="1"></div>

Variablen (Parametrisierte Kompositionen)

Rendere dieselbe Komposition mit unterschiedlichem Inhalt — Titel, Themenfarbe, Preise, Untertitel — ohne die HTML-Quelle zu bearbeiten.

Drei-Schritt-Muster:

  1. Deklariere Variablen auf dem <html>-Root der Komposition mit data-composition-variables. Jeder Eintrag benötigt id, type (einer von string, number, color, boolean, enum), label und default. Enum-Einträge benötigen auch options: [{value, label}, ...].
  2. Lese die aufgelösten Werte im Skript der Komposition mit window.__hyperframes.getVariables(). Gibt das zusammengeführte Ergebnis aus deklarierten Standardwerten + instanzspezifischen Überschreibungen + CLI-Überschreibungen zurück.
  3. Überschreibe zur Renderzeit mit npx hyperframes render --variables '{...}' (oberste Ebene) oder mit data-variable-values='{...}' auf dem Host-Element (pro Instanz für Sub-Comps).
<!doctype html>
<html
  data-composition-variables='[
  {"id":"title","type":"string","label":"Titel","default":"Hallo"},
  {"id":"theme","type":"enum","label":"Thema","default":"light","options":[
    {"value":"light","label":"Hell"},
    {"value":"dark","label":"Dunkel"}
  ]}
]'
>
  <body>
    <div data-composition-id="root" data-width="1920" data-height="1080">
      <h1 id="hero" class="clip" data-start="0" data-duration="3"></h1>
      <script>
        const { title, theme } = window.__hyperframes.getVariables();
        document.getElementById("hero").textContent = title;
        document.body.dataset.theme = theme;
      </script>
    </div>
  </body>
</html>
# Dev-Vorschau verwendet deklarierte Standardwerte
npx hyperframes preview

# Rendern mit Überschreibungen
npx hyperframes render --variables '{"title":"Q4-Bericht","theme":"dark"}' --output q4.mp4

# Oder aus einer JSON-Datei
npx hyperframes render --variables-file ./vars.json

Instanzspezifische Werte für Unterkompositionen: Die gleiche getVariables() funktioniert innerhalb von Sub-Comps, die über data-composition-src geladen werden. Jedes Host-Element übergibt seine eigenen Werte:

<div
  data-composition-id="card-pro"
  data-composition-src="compositions/card.html"
  data-variable-values='{"title":"Pro","price":"29€"}'
></div>
<div
  data-composition-id="card-enterprise"
  data-composition-src="compositions/card.html"

...

[im Folgenden zur Übersetzung abgeschnitten]

Verwandte Skills