Communitygithub.com

libz-renlab-ai/TeamBrain

Installieren und Verdrahten von Registry-Blöcken und -Komponenten in HyperFrames-Kompositionen. Verwenden Sie dies beim Ausführen von `hyperframes add`, beim Installieren eines Blocks oder einer Komponente, beim Verdrahten eines installierten Elements in `index.html` oder beim Arbeiten mit `hyperframes.json`. Deckt den Befehl `add`, Installationspfade, Block-Unterkompositions-Verdrahtung, Komponenten-Snippet-Zusammenführung und Registry-Erkennung ab.

Was ist TeamBrain?

Diese Fähigkeit (Skill) dient der Verwaltung und Integration von wiederverwendbaren Blöcken und Komponenten aus der HyperFrames-Registry. Sie ist speziell für Entwickler konzipiert, die mit dem `hyperframes add` Befehl arbeiten, um fertige Bausteine in ihre Video-Kompositionen einzufügen. Der Skill unterstützt zwei Haupttypen: Blöcke, die eigenständige Unterkompositionen mit eigener Zeitachse sind und über `data-composition-src` in eine Host-Komposition eingebunden werden, und Komponenten, die als Effekt-Snippets direkt in den HTML-Code einer Komposition eingefügt werden. Die KI kann mit dieser Fähigkeit Installationspfade in der `hyperframes.json` konfigurieren, die Ausgabe des `add` Befehls interpretieren und die korrekte Verdrahtung (Wiring) von Attributen wie `data-composition-id`, `data-start` und `data-track-index` für Blöcke vornehmen. Zudem ermöglicht sie die Erkundung der Registry per `curl`-Befehl, um verfügbare Items nach Name, Typ und Tags zu filtern. Zusammengefasst automatisiert dieser Skill die zeitaufwändigen manuellen Schritte beim Hinzufügen und Integrieren von Registry-Inhalten in HyperFrames-Projekte, was die Effizienz erheblich steigert.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

HyperFrames Registry

Die Registry bietet wiederverwendbare Blöcke und Komponenten, die über hyperframes add <name> installiert werden können.

  • Blöcke — eigenständige Unterkompositionen (eigene Dimensionen, Dauer, Zeitachse). Über data-composition-src in eine Host-Komposition eingebunden.
  • Komponenten — Effekt-Snippets (keine eigenen Dimensionen). Direkt in den HTML-Code einer Host-Komposition eingefügt.

Wann dieser Skill verwendet werden sollte

  • Der Benutzer erwähnt hyperframes add, "Block", "Komponente" oder hyperframes.json
  • Die Ausgabe von hyperframes add erscheint in der Sitzung (Dateipfade, Zwischenablage-Snippet)
  • Sie müssen ein installiertes Element in eine bestehende Komposition einbinden
  • Sie möchten entdecken, was in der Registry verfügbar ist

Kurzreferenz

hyperframes add data-chart              # Installiert einen Block
hyperframes add grain-overlay           # Installiert eine Komponente
hyperframes add shimmer-sweep --dir .   # Ziel ein bestimmtes Projekt
hyperframes add data-chart --json       # Maschinenlesbare Ausgabe
hyperframes add data-chart --no-clipboard  # Überspringt die Zwischenablage (CI/headless)

Nach der Installation gibt die CLI aus, welche Dateien geschrieben wurden und ein Snippet, das in Ihre Host-Komposition eingefügt werden muss. Das Snippet ist ein Ausgangspunkt – Sie müssen beim Verdrahten von Blöcken die Attribute data-composition-id (muss mit der internen Kompositions-ID des Blocks übereinstimmen), data-start und data-track-index hinzufügen.

Hinweis: hyperframes add funktioniert nur für Blöcke und Komponenten. Für Beispiele verwenden Sie stattdessen hyperframes init <dir> --example <name>.

Installationsorte

Blöcke werden standardmäßig in compositions/<name>.html installiert. Komponenten werden standardmäßig in compositions/components/<name>.html installiert.

Diese Pfade sind in hyperframes.json konfigurierbar:

{
  "registry": "https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry",
  "paths": {
    "blocks": "compositions",
    "components": "compositions/components",
    "assets": "assets"
  }
}

Vollständige Details finden Sie unter install-locations.md.

Verdrahten von Blöcken

Blöcke sind eigenständige Kompositionen – binden Sie sie über data-composition-src in Ihre Host-index.html ein:

<div
  data-composition-id="data-chart"
  data-composition-src="compositions/data-chart.html"
  data-start="2"
  data-duration="15"
  data-track-index="1"
  data-width="1920"
  data-height="1080"
></div>

Wichtige Attribute:

  • data-composition-src — Pfad zur HTML-Datei des Blocks
  • data-composition-id — muss mit der internen ID des Blocks übereinstimmen
  • data-start — wann der Block in der Host-Zeitleiste erscheint (Sekunden)
  • data-duration — wie lange der Block abgespielt wird
  • data-width / data-height — Block-Canvas-Dimensionen
  • data-track-index — Ebenenreihenfolge (höher = weiter vorne)

Vollständige Details finden Sie unter wiring-blocks.md.

Verdrahten von Komponenten

Komponenten sind Snippets – fügen Sie ihr HTML in das Markup Ihrer Komposition, ihr CSS in Ihren Style-Block und ihr JS in Ihr Skript (falls vorhanden) ein:

  1. Lesen Sie die installierte Datei (z. B. compositions/components/grain-overlay.html)
  2. Kopieren Sie die HTML-Elemente in das <div data-composition-id="..."> Ihrer Komposition
  3. Kopieren Sie den <style>-Block in die Styles Ihrer Komposition
  4. Kopieren Sie alle <script>-Inhalte in das Skript Ihrer Komposition (vor Ihrem Timeline-Code)
  5. Wenn die Komponente eine GSAP-Timeline-Integration bereitstellt (siehe Kommentarblock im Snippet), fügen Sie diese Aufrufe in Ihre Timeline ein

Vollständige Details finden Sie unter wiring-components.md.

Erkennung

Durchsuchen Sie verfügbare Elemente:

# Lesen des Registry-Manifests
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Jedes registry-item.json enthält: Name, Typ, Titel, Beschreibung, Tags, Dimensionen (nur Blöcke), Dauer (nur Blöcke) und Dateiliste.

Details zum Filtern nach Typ und Tags finden Sie unter discovery.md.

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

Create video compositions, animations, title cards, overlays, captions, voiceovers, audio-reactive visuals, and scene transitions in HyperFrames HTML. Use when asked to build any HTML-based video content, add captions or subtitles synced to audio, generate text-to-speech narration, create audio-reactive animation (beat sync, glow, pulse driven by music), add animated text highlighting (marker sweeps, hand-drawn circles, burst lines, scribble, sketchout), or add transitions between scenes (crossfades, wipes, reveals, shader transitions). Covers composition authoring, timing, media, and the full video production workflow. For CLI commands (init, lint, preview, render, transcribe, tts) see the hyperframes-cli skill.

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