Communitygithub.com

libz-renlab-ai/TeamBrain

Erstellen Sie Videokompositionen, Animationen, Titelcards, Overlays, Untertitel, Voiceovers, audio-reaktive Visualisierungen und Szenenübergänge in HyperFrames HTML. Verwenden Sie dies, wenn Sie aufgefordert werden, HTML-basierte Videoinhalte zu erstellen, Untertitel oder Bildunterschriften synchron zum Audio hinzuzufügen, Text-to-Speech-Erzählungen zu generieren, audio-reaktive Animationen (Beat-Sync, Glühen, Puls getrieben von Musik) zu erzeugen, animierte Texthervorhebungen (Marker-Streiche, handgezeichnete Kreise, Burst-Linien, Gekritzel, Skizzen) hinzuzufügen oder Übergänge zwischen Szenen (Crossfades, Wipes, Reveals, Shader-Übergänge) einzufügen. Deckt die Kompositionserstellung, das Timing, Medien und den gesamten Videoproduktions-Workflow ab. Für CLI-Befehle (init, lint, preview, render, transcribe, tts) siehe das hyperframes-cli-Skill.

Was ist TeamBrain?

Die `libz-renlab-ai/TeamBrain`-Fähigkeit (Skill) ermöglicht es KI-Agenten wie Claude Code, Cursor oder Codex, komplexe HTML-basierte Videoinhalte innerhalb des HyperFrames-Frameworks zu erstellen und zu bearbeiten. Sie deckt den gesamten Videoproduktions-Workflow ab: von der anfänglichen Entdeckung und Designsystem-Definition über die Erstellung von Kompositionen mit präzisem Timing mithilfe von GSAP-Animationen bis hin zu Untertiteln, Voiceovers und audio-reaktiven Effekten. Die Stärke liegt in der Strukturierung des kreativen Prozesses durch klare Schritte: Design-System definieren, Prompt-Erweiterung, Planung und dann die Implementierung mit strikten Regeln für Layout, Animation und Timing. Die Fähigkeit setzt auf ein deterministisches System ohne Zufallsfaktoren und verwendet CSS und GSAP-Timelines, um vorhersagbare, reproduzierbare Videokompositionen zu erstellen. Sie unterstützt verschiedene Sub-Kompositionen, Szenenübergänge und Medienformate und ist besonders nützlich für die automatisierte Videoproduktion in Entwicklungsumgebungen, in denen HTML die Quelle der Wahrheit für das Video darstellt.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/libz-renlab-ai/TeamBrain/tree/HEAD/.agents/skills/hyperframes

In Ihrer bevorzugten KI fragen

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

Vorschau

Aus dem Skill-README

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 die Animation und CSS für die Darstellung. Das Framework übernimmt die Sichtbarkeit von Clips, die Medienwiedergabe und die Synchronisation der Timeline.

Ansatz

Entdeckung (nur für explorative Anfragen)

Bei offenen Anfragen ("Mach mir ein Produktlaunch-Video", "Erstell etwas für unsere Marke"), bei denen der Benutzer sich noch nicht auf eine Richtung festgelegt hat, verstehen Sie die Absicht, bevor Sie Farben auswählen:

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

Bei spezifischen Anfragen ("Füge eine Titelcard hinzu", "Korrigiere das Timing in Szene 3") überspringen Sie die Entdeckung.

Erwägen Sie bei explorativen Anfragen, 2-3 Varianten anzubieten, die sich sinnvoll unterscheiden – nicht nur Farbwechsel, sondern unterschiedliche Tempi, Energieniveaus oder strukturelle Ansätze. Eine sichere/erwartete, eine ambitionierte. Erzwingen Sie dies nicht – es ist ein Werkzeug, das bei Bedarf eingesetzt wird.

Schritt 1: Designsystem

Wenn design.md oder DESIGN.md im Projekt existiert, lesen Sie es zuerst (überprüfen Sie beide Schreibweisen – es sind auf Linux unterschiedliche Dateien). Es ist die Quelle der Wahrheit für Markenfarben, Schriftarten und Einschränkungen. Verwenden Sie dessen genaue Werte – erfinden Sie keine Farben oder ersetzen Sie Schriftarten. Jedes Format funktioniert (YAML-Frontmatter, Prosa, Tabellen – extrahieren Sie einfach die Werte).

Wenn es Schriftarten nennt, die Sie lokal nicht finden können (kein fonts/-Verzeichnis mit .woff2-Dateien, keine integrierte Schriftart), warnen Sie den Benutzer vor dem Schreiben von HTML: "design.md spezifiziert [Schriftartname], aber es wurden keine Schriftdateien gefunden. Bitte fügen Sie .woff2-Dateien zum fonts/-Verzeichnis hinzu, oder ich falle auf [nächstgelegene integrierte Alternative] zurück."

Wenn keine design.md existiert, bieten Sie dem Benutzer eine Auswahl:

  1. Hat der Benutzer einen Stil oder eine Stimmung genannt? → Lesen Sie visual-styles.md für die 8 benannten Voreinstellungen. Wählen Sie die nächstgelegene Übereinstimmung.
  2. Möchten Sie Optionen visuell durchstöbern? → Führen Sie den Design-Picker aus: Lesen Sie references/design-picker.md für den vollständigen Workflow. Dies liefert eine visuelle Auswahlseite. Der Benutzer konfiguriert Stimmung, Palette, Typografie und Bewegung im Browser, kopiert dann das generierte design.md und fügt es zurück in das Gespräch ein.
  3. Möchten Sie überspringen und schnell vorgehen? → Fragen Sie: Stimmung, hell oder dunkel, irgendwelche Markenfarben/Schriftarten? Wählen Sie dann eine Palette aus house-style.md.

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

Schritt 2: Prompt-Erweiterung

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

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

Schritt 3: Plan

Denken Sie vor dem Schreiben von HTML auf hohem Niveau:

  1. Was – Was soll der Betrachter erleben? Identifizieren Sie den narrativen Bogen, die Schlüsselmomente und die emotionalen Schläge.
  2. Struktur – Wie viele Kompositionen, welche sind Unterkompositionen vs. Inline, welche Spuren transportieren was (Video, Audio, Overlays, Untertitel).
  3. Rhythmus – Geben Sie Ihren Szenen-Rhythmus vor der Implementierung an. Welche Szenen sind schnelle Treffer, welche sind Haltepunkte, wo landen Shader, wo erreicht die Energie ihren Höhepunkt. Nennen Sie das Muster: schnell-schnell-LANGSAM-schnell-SHADER-Halt. Lesen Sie references/beat-direction.md für Rhythmusvorlagen.
  4. Timing – Welche Clips bestimmen die Dauer, wo liegen die Übergänge, wie ist das Tempo.
  5. Layout – Bauen Sie zuerst den Endzustand. Siehe "Layout vor Animation" unten.
  6. Animieren – Fügen Sie dann Bewegung mit den folgenden Regeln hinzu.

Bauen Sie, wonach gefragt wurde. Eine Anfrage nach "einer Titelcard" ist keine Anfrage nach "einer Titelcard + 3 unterstützenden Szenen + Hintergrundmusik + Untertiteln." Jede Szene, jedes Element, jedes Tween sollte seinen Platz verdienen. Wenn zusätzliche Szenen oder Elemente das Stück tatsächlich verbessern würden, schlagen Sie sie vor – fügen Sie sie nicht hinzu.

Für kleine Bearbeitungen (Farbe korrigieren, Timing anpassen, ein Element hinzufügen) springen Sie direkt zu den Regeln.

Layout vor Animation

Positionieren Sie jedes Element dort, wo es an seinem sichtbarsten Moment sein sollte – dem Frame, in dem es vollständig eingetreten, korrekt platziert und noch nicht verlassen wird. Schreiben Sie dies zuerst als statisches HTML+CSS. Noch kein GSAP.

Warum das wichtig ist: Wenn Sie Elemente in ihrem animierten Startzustand positionieren (außerhalb des Bildschirms, auf 0 skaliert, Deckkraft 0) und sie dorthin tweenen, wo Sie glauben, dass sie landen sollen, raten Sie die endgültige Anordnung. Überlappungen sind unsichtbar, bis das Video gerendert wird. Indem Sie zuerst den Endzustand bauen, können Sie Layout-Probleme sehen und beheben, bevor Sie eine Bewegung hinzufügen.

Der Prozess

  1. Identifizieren Sie den Helden-Frame für jede Szene – den Moment, in dem die meisten Elemente gleichzeitig sichtbar sind. Dies ist das Layout, das Sie bauen.
  2. Schreiben Sie statisches CSS für diesen Frame. Der .scene-content-Container MUSS die gesamte Szene mit width: 100%; height: 100%; padding: Npx; und display: flex; flex-direction: column; gap: Npx; box-sizing: border-box ausfüllen. Verwenden Sie Padding, um Inhalt nach innen zu drücken – NIEMALS position: absolute; top: Npx auf einem Inhaltscontainer. Absolut positionierte Inhaltscontainer laufen über, wenn der Inhalt höher als der verbleibende Platz ist. Reservieren Sie position: absolute nur für dekorative Elemente.
  3. Fügen Sie Eingänge mit gsap.from() hinzu – animieren Sie VON außerhalb des Bildschirms/unsichtbar ZUR CSS-Position. Die CSS-Position ist die Grundwahrheit; das Tween beschreibt die Reise dorthin. (In Unterkompositionen, die über data-composition-src geladen werden, bevorzugen Sie gsap.fromTo() – siehe lasttragende GSAP-Regeln in references/motion-principles.md.)
  4. Fügen Sie Ausgänge mit gsap.to() hinzu – animieren Sie ZU außerhalb des Bildschirms/unsichtbar VON der CSS-Position.

Beispiel

/* scene-content füllt die Szene aus, 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 den Inhalt. Flex + Gap handhabt den Abstand. */

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 über die Zeit einen Raum teilen

Wenn Element A verlässt, bevor Element B im selben Bereich eintritt, sollten beide korrekte CSS-Positionen für ihre jeweiligen Helden-Frames haben. Die Timeline-Reihenfolge stellt sicher, dass sie nie visuell koexistieren – aber wenn Sie den Layout-Schritt überspringen, werden Sie den Fall nicht bemerken, wenn sie aufgrund eines Timing-Fehlers versehentlich überlappen.

Was als beabsichtigte Überlappung gilt

Geschichtete Effekte (Glühen hinter Text, Schattenelemente, Hintergrundmuster) und Z-gestapelte Designs (Kartenstapel, Tiefenschichten) sind beabsichtigt. Beim Layout-Schritt geht es darum, unbeabsichtigte Überlappungen zu erkennen – zwei Überschriften, die aufeinander landen, eine Statistik, die ein Etikett bedeckt, Inhalt, der aus dem Rahmen läuft.

Datenattribute

Alle Clips

AttributErforderlichWerte
idJaEindeutige Kennung
data-startJaSekunden oder Clip-ID-Referenz ("el-1", "intro + 2")
data-durationErforderlich für img/div/compositionsSekunden. Video/Audio standardmäßig auf Mediendauer.
data-track-indexJaGanzzahl. Clips auf derselben Spur können sich nicht überlappen.
data-media-startNeinTrim-Offset in Quelle (Sekunden)
data-volumeNein0-1 (Standard 1)

data-track-index beeinflusst nicht die visuelle Schichtung – verwenden Sie CSS z-index.

Kompositions-Clips

AttributErforderlichWerte
data-composition-idJaEindeutige Kompositions-ID
data-startJaStartzeit (Hauptkomposition: "0" verwenden)
data-durationJaHat Vorrang vor der GSAP-Timeline-Dauer
data-width / data-heightJaPixelabmessungen (1920x1080 oder 1080x1920)
data-composition-srcNeinPfad zur externen HTML-Datei

Kompositionsstruktur

Unterkompositionen, die über data-composition-src geladen werden, verwenden einen <template>-Wrapper. Eigenständige Kompositionen (die Haupt-index.html) verwenden KEIN <template> – sie setzen das data-composition-id-div direkt in <body>. Die Verwendung von <template> bei einer eigenständigen Datei verbirgt alle Inhalte vor dem Browser und bricht das Rendering.

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"] {
        /* skalierte 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 in der Wurzel: <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>

Video und Audio

Video muss muted playsinline sein. Audio ist immer ein separates <audio>-Element:

<video
  id="el-v"
  data-start="0"
  data-duration="30"
  data-track-index="0"
  src="video.mp4"
  muted
  playsinline
></video>
<audio
  id="el-a"
  data-start="0"
  data-duration="30"
  data-track-index="2"
  src="video.mp4"
  data-volume="1"
></audio>

Timeline-Vertrag

  • Alle Timelines starten mit { paused: true } – der Player steuert die Wiedergabe
  • Jede Timeline registrieren: window.__timelines["<composition-id>"] = tl
  • Das Framework verschachtelt Unter-Timelines automatisch – NICHT manuell hinzufügen
  • Die Dauer stammt von data-duration, nicht von der GSAP-Timeline-Länge
  • Nie leere Tweens erstellen, um die Dauer festzulegen

Regeln (Nicht verhandelbar)

Deterministisch: Kein Math.random(), Date.now() oder zeitbasierte Logik. Verwenden Sie einen gesäten PRNG, wenn Sie pseudo-zufällige Werte benötigen (z.B. mulberry32).

GSAP: Nur visuelle Eigenschaften animieren (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, Transformationen). Nicht visibility, display animieren oder video.play()/audio.play() aufrufen.

Animationskonflikte: Niemals dieselbe Eigenschaft am selben Element von mehreren Timelines gleichzeitig animieren.

Kein repeat: -1: Unendlich wiederholte Timelines zerstören die Erfassungs-Engine. Berechnen Sie die genaue Wiederholungsanzahl aus der Kompositionsdauer: repeat: Math.ceil(duration / cycleDuration) - 1.

Synchrone Timeline-Konstruktion: Niemals Timelines innerhalb von async/await, setTimeout oder Promises bauen. Die Erfassungs-Engine liest window.__timelines synchron nach dem Laden der Seite. Schriftarten werden vom Compiler eingebettet, sind also sofort verfügbar – kein Warten auf das Laden von Schriftarten nötig.

Niemals tun:

  1. window.__timelines-Registrierung vergessen
  2. Video für Audio verwenden – immer stummgeschaltetes Video + separates <audio>
  3. Video in einem zeitgesteuerten div verschachteln – einen nicht zeitgesteuerten Wrapper verwenden
  4. data-layer verwenden (data-track-index verwenden) oder data-end (data-duration verwenden)
  5. Video-Elementabmessungen animieren – einen Wrapper-div animieren
  6. Play/Pause/Seek auf Medien aufrufen – das Framework besitzt die Wiedergabe
  7. Einen Container der obersten Ebene ohne data-composition-id erstellen
  8. repeat: -1 auf einer Timeline oder einem Tween verwenden – immer endliche Wiederholungen
  9. Timelines asynchron bauen (innerhalb von async, setTimeout, Promise)
  10. gsap.set() auf Clip-Elementen von späteren Szenen verwenden – sie existieren nicht im DOM beim Laden der Seite. Verwenden Sie stattdessen tl.set(selector, vars, timePosition) innerhalb der Timeline zu oder nach der data-start-Zeit des Clips.
  11. <br> in Inhaltstext verwenden – erzwungene Zeilenumbrüche berücksichtigen nicht die tatsächliche gerenderte Schriftbreite. Text, der auf natürliche Weise umbricht + ein <br> erzeugt einen zusätzlichen unerwünschten Umbruch, was zu Überlappungen führt. Lassen Sie den Text stattdessen über max-width umbrechen. Ausnahme: kurze Anzeigetitel, bei denen jedes Wort absichtlich auf einer eigenen Zeile steht (z.B. "THE\nIMMORTAL\nGAME" bei 130px).

Szenenübergänge (Nicht verhandelbar)

Jede Multiszenen-Komposition MUSS ALLE diese Regeln befolgen. Die Verletzung einer einzigen von ihnen ist eine kaputte Komposition.

  1. **

…

Individual skills in this repo

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

libz-renlab-ai/TeamBrain

Asset preprocessing for HyperFrames compositions — text-to-speech narration (Kokoro), audio/video transcription (Whisper), and background removal for transparent overlays (u2net). Use when generating voiceover from text, transcribing speech for captions, removing the background from a video or image to use as a transparent overlay, choosing a TTS voice or whisper model, or chaining these (TTS → transcribe → captions). Each command downloads its own model on first run.

libz-renlab-ai/TeamBrain

Install and wire registry blocks and components into HyperFrames compositions. Use when running hyperframes add, installing a block or component, wiring an installed item into index.html, or working with hyperframes.json. Covers the add command, install locations, block sub-composition wiring, component snippet merging, and registry discovery.

libz-renlab-ai/TeamBrain

Translate an existing Remotion (React-based) video composition into a HyperFrames HTML composition. Use ONLY when the user explicitly asks to port, convert, migrate, translate, or rewrite a Remotion composition as HyperFrames — for example "port my Remotion project to HyperFrames", "convert this Remotion code to HyperFrames", "migrate from Remotion", "translate this Remotion comp", or "rewrite this as HyperFrames HTML". Do NOT use when (a) the user is authoring a NEW HyperFrames composition, even if they have or are A/B-testing a similar Remotion video; (b) the user mentions Remotion in passing without asking for migration; (c) the user shares Remotion code as reference material rather than asking for a translation; (d) the user asks for "the same video as my Remotion one" without explicitly asking to migrate the source — treat that as a fresh HyperFrames build. When in doubt, default to authoring a native HyperFrames composition with the `hyperframes` skill instead. Skill detects unsupported patterns (use...

libz-renlab-ai/TeamBrain

Capture a website and create a HyperFrames video from it. Use when: (1) a user provides a URL and wants a video, (2) someone says "capture this site", "turn this into a video", "make a promo from my site", (3) the user wants a social ad, product tour, or any video based on an existing website, (4) the user shares a link and asks for any kind of video content. Even if the user just pastes a URL — this is the skill to use.

libz-renlab-ai/TeamBrain

HyperFrames CLI tool — hyperframes init, lint, inspect, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use when scaffolding a project, linting, validating, inspecting visual layout in compositions, previewing in the studio, rendering to video, transcribing audio, generating TTS, or troubleshooting the HyperFrames environment.

Verwandte Skills