Communitygithub.com

libz-renlab-ai/TeamBrain

Installer et connecter les blocks et composants du registre dans les compositions HyperFrames. Utilisez-le lors de l'exécution de `hyperframes add`, de l'installation d'un block ou composant, du câblage d'un élément installé dans `index.html`, ou du travail avec `hyperframes.json`. Couvre la commande `add`, les emplacements d'installation, le câblage de sous-composition de block, la fusion de snippets de composants, et la découverte du registre.

Qu'est-ce que TeamBrain ?

Ce skill automatise le processus d'installation et d'intégration de blocks et composants réutilisables issus du registre HyperFrames. Il est utile pour les développeurs utilisant HyperFrames, car il fournit des instructions précises pour utiliser la commande `hyperframes add`, comprendre les emplacements d'installation, et câbler correctement les éléments installés dans des compositions hôtes. Le skill est conçu pour des agents IA qui interagissent avec des projets HyperFrames, en interprétant les sorties de la CLI, en suggérant les attributs de câblage nécessaires (comme `data-composition-id`, `data-start`, `data-track-index`), et en guidant l'intégration des composants (HTML, CSS, JS). Il supporte les blocks (sous-compositions autonomes) et les composants (snippets d'effets) et utilise des fichiers de référence (install-locations.md, wiring-blocks.md, wiring-components.md, discovery.md) pour des cas d'usage avancés. L'agent doit utiliser ce skill chaque fois que l'utilisateur mentionne 'block', 'component', 'hyperframes add', 'hyperframes.json', ou que des sorties de ces commandes apparaissent dans la session.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Registre HyperFrames

Le registre fournit des blocks et composants réutilisables installables via hyperframes add <nom>.

  • Blocks — sous-compositions autonomes (dimensions, durée, timeline propres). Inclus via data-composition-src dans une composition hôte.
  • Composants — snippets d'effets (pas de dimensions propres). Collés directement dans le HTML d'une composition hôte.

Quand utiliser ce skill

  • L'utilisateur mentionne hyperframes add, "block", "composant", ou hyperframes.json
  • La sortie de hyperframes add apparaît dans la session (chemins de fichiers, snippet dans le presse-papier)
  • Vous devez câbler un élément installé dans une composition existante
  • Vous souhaitez découvrir ce qui est disponible dans le registre

Référence rapide

hyperframes add data-chart              # installer un block
hyperframes add grain-overlay           # installer un composant
hyperframes add shimmer-sweep --dir .   # cibler un projet spécifique
hyperframes add data-chart --json       # sortie lisible par machine
hyperframes add data-chart --no-clipboard  # ignorer le presse-papier (CI/sans tête)

Après l'installation, la CLI affiche les fichiers écrits et un snippet à coller dans votre composition hôte. Le snippet est un point de départ — vous devrez ajouter les attributs data-composition-id (doit correspondre à l'ID interne du block), data-start, et data-track-index lors du câblage des blocks.

Remarque : hyperframes add fonctionne uniquement pour les blocks et composants. Pour les exemples, utilisez hyperframes init <dossier> --example <nom> à la place.

Emplacements d'installation

Les blocks s'installent dans compositions/<nom>.html par défaut. Les composants s'installent dans compositions/components/<nom>.html par défaut.

Ces chemins sont configurables dans hyperframes.json :

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

Voir install-locations.md pour les détails complets.

Câblage des blocks

Les blocks sont des compositions autonomes — incluez-les via data-composition-src dans votre index.html hôte :

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

Attributs clés :

  • data-composition-src — chemin vers le fichier HTML du block
  • data-composition-id — doit correspondre à l'ID interne du block
  • data-start — quand le block apparaît dans la timeline hôte (en secondes)
  • data-duration — durée de lecture du block
  • data-width / data-height — dimensions du canvas du block
  • data-track-index — ordre des couches (plus élevé = devant)

Voir wiring-blocks.md pour les détails complets.

Câblage des composants

Les composants sont des snippets — collez leur HTML dans le balisage de votre composition, leur CSS dans votre bloc de styles, et leur JS dans votre script (le cas échéant) :

  1. Lisez le fichier installé (ex. : compositions/components/grain-overlay.html)
  2. Copiez les éléments HTML dans votre <div data-composition-id="...">
  3. Copiez le bloc <style> dans les styles de votre composition
  4. Copiez tout contenu <script> dans le script de votre composition (avant votre code de timeline)
  5. Si le composant expose une intégration de timeline GSAP (voir le bloc de commentaire dans le snippet), ajoutez ces appels à votre timeline

Voir wiring-components.md pour les détails complets.

Découverte

Parcourez les éléments disponibles :

# Lire le manifeste du registre
curl -s https://raw.githubusercontent.com/heygen-com/hyperframes/main/registry/registry.json

Chaque registry-item.json contient : nom, type, titre, description, tags, dimensions (blocks uniquement), durée (blocks uniquement), et liste de fichiers.

Voir discovery.md pour les détails sur le filtrage par type et tags.

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.

Skills associés