Communitygithub.com

libz-renlab-ai/TeamBrain

Créez des compositions vidéo, des animations, des cartons-titres, des incrustations, des sous-titres, des voiceovers, des visuels réactifs à l'audio et des transitions de scène en HTML avec HyperFrames. Utilisez cette compétence pour toute demande de contenu vidéo basé sur HTML, d'ajout de sous-titres synchronisés à l'audio, de génération de narration par synthèse vocale, de création d'animations réactives à l'audio (synchronisation sur le rythme, lueur, impulsion pilotée par la musique), de mise en évidence de texte animée (balayages de marqueur, cercles dessinés à la main, lignes d'éclatement, gribouillis, esquisse) ou d'ajout de transitions entre les scènes (fondus enchaînés, balayages, révélations, transitions par shader). Couvre la création de compositions, le timing, les médias et le flux de production vidéo complet. Pour les commandes CLI (init, lint, preview, render, transcribe, tts), consultez la compétence hyperframes-cli.

Qu'est-ce que TeamBrain ?

Cette compétence spécialisée permet à un agent IA de créer des compositions vidéo complètes en utilisant HyperFrames, où le code HTML est la source de vérité pour la vidéo. Elle guide l'agent à travers un processus en trois étapes : d'abord, établir un système de design basé sur un fichier `design.md` ou les préférences de l'utilisateur ; ensuite, développer l'intention de l'utilisateur pour définir le rythme, la structure et le timing de la vidéo ; enfin, construire la composition en s'arrangeant d'abord sur la disposition statique avant d'ajouter des animations avec GSAP. La compétence impose des règles strictes : pas de valeurs aléatoires, pas d'animations asynchrones, et une gestion précise des pistes médias et des transitions. Elle prend en charge les sous-titres, les voiceovers, les incrustations, les animations réactives à l'audio, et les transitions de scène, offrant ainsi un pipeline de production vidéo complet et déterministe pour les agents IA. L'agent peut également proposer des variations de style ou utiliser un sélecteur de design visuel pour les demandes exploratoires.

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

Demander à votre IA préférée

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

Aperçu

Depuis le README du skill

Documentation

HyperFrames

L'HTML est la source de vérité pour la vidéo. Une composition est un fichier HTML avec des attributs data-* pour le timing, une timeline GSAP pour l'animation, et du CSS pour l'apparence. Le framework gère la visibilité des clips, la lecture des médias et la synchronisation de la timeline.

Approche

Découverte (uniquement pour les demandes exploratoires)

Pour les demandes ouvertes (« fais-moi une vidéo de lancement de produit », « crée quelque chose pour notre marque ») lorsque l'utilisateur ne s'est pas engagé dans une direction, comprenez l'intention avant de choisir les couleurs :

  • Public — qui regarde ça ? Des développeurs ? Des cadres dirigeants ? Des consommateurs grand public ?
  • Plateforme — où est-ce diffusé ? Sur les réseaux sociaux (15s), site web hero, démo produit, interne ?
  • Priorité — qu'est-ce qui compte le plus ? La qualité du mouvement ? La précision du contenu ? La fidélité à la marque ? La rapidité ?
  • Variations — l'utilisateur veut-il des options, ou une seule meilleure proposition ?

Pour les demandes spécifiques (« ajoute un carton-titre », « corrige le timing de la scène 3 »), sautez la phase de découverte.

Pour les demandes exploratoires, envisagez de proposer 2 à 3 variations qui diffèrent significativement — pas seulement des changements de couleur, mais des rythmes, des niveaux d'énergie ou des approches structurelles différents. Une version sûre/prévue, une ambitieuse. Ne le rendez pas obligatoire — c'est un outil disponible quand c'est approprié.

Étape 1 : Système de design

Si design.md ou DESIGN.md existe dans le projet, lisez-le d'abord (vérifiez les deux casses — ce sont des fichiers différents sous Linux). C'est la source de vérité pour les couleurs de la marque, les polices et les contraintes. Utilisez ses valeurs exactes — n'inventez pas de couleurs et ne substituez pas de polices. N'importe quel format fonctionne (frontmatter YAML, prose, tableaux — extrayez simplement les valeurs).

S'il nomme des polices que vous ne trouvez pas localement (pas de répertoire fonts/ avec des fichiers .woff2, pas de police intégrée), avertissez l'utilisateur avant d'écrire du HTML : « design.md spécifie [nom de la police] mais aucun fichier de police trouvé. Veuillez ajouter des fichiers .woff2 dans fonts/ ou je vais utiliser [alternative intégrée la plus proche]. »

Si aucun design.md n'existe, proposez à l'utilisateur un choix :

  1. L'utilisateur a nommé un style ou une ambiance ? → Lisez visual-styles.md pour les 8 préréglages nommés. Choisissez la correspondance la plus proche.
  2. Souhaite parcourir les options visuellement ? → Lancez le sélecteur de design : lisez references/design-picker.md pour le flux de travail complet. Cela sert une page de sélection visuelle. L'utilisateur configure l'ambiance, la palette, la typographie et le mouvement dans le navigateur, puis copie le design.md généré et le colle dans la conversation.
  3. Souhaite passer rapidement ? → Demandez : ambiance, clair ou sombre, des couleurs/polices de marque ? Choisissez ensuite une palette dans house-style.md.

design.md définit la marque. Il ne définit pas les règles de composition vidéo. Celles-ci proviennent de references/video-composition.md et house-style.md. Utilisez les couleurs de la marque à une échelle appropriée à la vidéo — pas à l'opacité d'une interface web.

Étape 2 : Expansion de l'invite

Toujours exécutée sur chaque composition (sauf pour les pièces à scène unique et les modifications triviales). Cette étape ancre l'intention de l'utilisateur par rapport à design.md et house-style.md et produit un intermédiaire cohérent que tout agent en aval lit de la même manière.

Lisez references/prompt-expansion.md pour le processus complet et le format de sortie.

Étape 3 : Planification

Avant d'écrire du HTML, réfléchissez à un haut niveau :

  1. Quoi — que doit vivre le spectateur ? Identifiez l'arc narratif, les moments clés et les battements émotionnels.
  2. Structure — combien de compositions, lesquelles sont des sous-compositions vs en ligne, quelles pistes transportent quoi (vidéo, audio, incrustations, sous-titres).
  3. Rythme — déclarez votre rythme de scène avant de l'implémenter. Quelles scènes sont des hits rapides, lesquelles sont des poses, où les shaders atterrissent, où l'énergie atteint son pic. Nommez le motif : rapide-rapide-LENT-rapide-SHADER-pose. Lisez references/beat-direction.md pour les modèles de rythme.
  4. Timing — quels clips déterminent la durée, où les transitions atterrissent, quel est le rythme.
  5. Disposition — construisez d'abord l'état final. Voir « Disposition avant animation » ci-dessous.
  6. Animer — ajoutez ensuite du mouvement en utilisant les règles ci-dessous.

Construisez ce qui a été demandé. Une demande pour « un carton-titre » n'est pas une demande pour « un carton-titre + 3 scènes d'accompagnement + musique d'ambiance + sous-titres. » Chaque scène, chaque élément, chaque tween doit mériter sa place. Si des scènes ou éléments supplémentaires amélioreraient vraiment la pièce, proposez-les — ne les ajoutez pas.

Pour les petites modifications (corriger une couleur, ajuster un timing, ajouter un élément), passez directement aux règles.

Disposition avant animation

Positionnez chaque élément là où il doit être à son moment le plus visible — l'image où il est complètement entré, correctement placé et pas encore en train de sortir. Écrivez cela d'abord en HTML+CSS statique. Pas encore de GSAP.

Pourquoi c'est important : Si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle 0, opacité 0) et que vous les animez jusqu'à l'endroit où vous pensez qu'ils doivent atterrir, vous devinez la disposition finale. Les chevauchements sont invisibles jusqu'à ce que la vidéo soit rendue. En construisant d'abord l'état final, vous pouvez voir et corriger les problèmes de disposition avant d'ajouter tout mouvement.

Le processus

  1. Identifiez l'image héroïque pour chaque scène — le moment où le plus d'éléments sont visibles simultanément. C'est la disposition que vous construisez.
  2. Écrivez du CSS statique pour cette image. Le conteneur .scene-content DOIT remplir la scène entière en utilisant width: 100%; height: 100%; padding: Npx; avec display: flex; flex-direction: column; gap: Npx; box-sizing: border-box. Utilisez le padding pour pousser le contenu vers l'intérieur — JAMAIS position: absolute; top: Npx sur un conteneur de contenu. Les conteneurs de contenu en position absolue débordent lorsque le contenu est plus haut que l'espace restant. Réservez position: absolute uniquement pour les éléments décoratifs.
  3. Ajoutez les entrées avec gsap.from() — animez DEPUIS hors écran/invisible VERS la position CSS. La position CSS est la vérité de référence ; le tween décrit le voyage pour y arriver. (Dans les sous-compositions chargées via data-composition-src, préférez gsap.fromTo() — voir les règles GSAP porteuses de charge dans references/motion-principles.md.)
  4. Ajoutez les sorties avec gsap.to() — animez VERS hors écran/invisible DEPUIS la position CSS.

Exemple

/* scene-content remplit la scène, le padding positionne le contenu */
.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;
}
/* Le conteneur remplit toute taille de scène (1920x1080, 1080x1920, etc.).
   Le padding positionne le contenu. Flex + gap gère l'espacement. */

FAUX — dimensions codées en dur et positionnement absolu :

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Étape 3 : Animer VERS ces positions
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);

// Étape 4 : Animer HORS de ces positions
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);

Lorsque des éléments partagent l'espace dans le temps

Si l'élément A sort avant que l'élément B n'entre dans la même zone, les deux doivent avoir des positions CSS correctes pour leurs images héroïques respectives. L'ordre de la timeline garantit qu'ils ne coexistent jamais visuellement — mais si vous sautez l'étape de disposition, vous ne détecterez pas le cas où ils se chevauchent accidentellement en raison d'une erreur de timing.

Ce qui est considéré comme un chevauchement intentionnel

Les effets de calque (lueur derrière le texte, éléments d'ombre, motifs de fond) et les conceptions empilées en Z (piles de cartes, couches de profondeur) sont intentionnels. L'étape de disposition consiste à détecter les chevauchements non intentionnels — deux titres atterrissant l'un sur l'autre, une statistique couvrant une étiquette, un contenu débordant du cadre.

Attributs de données

Tous les clips

AttributRequisValeurs
idOuiIdentifiant unique
data-startOuiSecondes ou référence d'ID de clip ("el-1", "intro + 2")
data-durationRequis pour img/div/compositionsSecondes. La vidéo/audio par défaut est la durée du média.
data-track-indexOuiEntier. Les clips de la même piste ne peuvent pas se chevaucher.
data-media-startNonDécalage de coupe dans la source (secondes)
data-volumeNon0-1 (par défaut 1)

data-track-index n'affecte pas le calque visuel — utilisez CSS z-index.

Clips de composition

AttributRequisValeurs
data-composition-idOuiID de composition unique
data-startOuiHeure de début (composition racine : utilisez "0")
data-durationOuiPrioritaire sur la durée de la timeline GSAP
data-width / data-heightOuiDimensions en pixels (1920x1080 ou 1080x1920)
data-composition-srcNonChemin vers un fichier HTML externe

Structure de la composition

Les sous-compositions chargées via data-composition-src utilisent un wrapper <template>. Les compositions autonomes (le fichier index.html principal) n'utilisent PAS <template> — elles placent la div data-composition-id directement dans <body>. Utiliser <template> sur un fichier autonome cache tout le contenu du navigateur et casse le rendu.

Structure d'une sous-composition :

<template id="my-comp-template">
  <div data-composition-id="my-comp" data-width="1920" data-height="1080">
    <!-- contenu -->
    <style>
      [data-composition-id="my-comp"] {
        /* styles limités à ce composant */
      }
    </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>

Chargement dans la racine : <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>

Vidéo et Audio

La vidéo doit être muted playsinline. L'audio est toujours un élément <audio> séparé :

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

Contrat de timeline

  • Toutes les timelines commencent { paused: true } — le lecteur contrôle la lecture
  • Enregistrez chaque timeline : window.__timelines["<id-de-la-composition>"] = tl
  • Le framework imbrique automatiquement les sous-timelines — ne les ajoutez PAS manuellement
  • La durée provient de data-duration, pas de la longueur de la timeline GSAP
  • Ne créez jamais de tweens vides pour définir la durée

Règles (Non-négociables)

Déterministe : Pas de Math.random(), Date.now() ou logique basée sur le temps. Utilisez un PRNG ensemencé si vous avez besoin de valeurs pseudo-aléatoires (par exemple mulberry32).

GSAP : Animez uniquement les propriétés visuelles (opacity, x, y, scale, rotation, color, backgroundColor, borderRadius, transformations). N'animez PAS visibility, display, et n'appelez pas video.play()/audio.play().

Conflits d'animation : N'animez jamais la même propriété sur le même élément à partir de plusieurs timelines simultanément.

Pas de repeat: -1 : Les timelines à répétition infinie cassent le moteur de capture. Calculez le nombre exact de répétitions à partir de la durée de la composition : repeat: Math.ceil(duration / cycleDuration) - 1.

Construction synchrone de timeline : Ne construisez jamais de timelines à l'intérieur de async/await, setTimeout ou de Promesses. Le moteur de capture lit window.__timelines de manière synchrone après le chargement de la page. Les polices sont intégrées par le compilateur, donc elles sont disponibles immédiatement — pas besoin d'attendre le chargement des polices.

Ne jamais faire :

  1. Oublier l'enregistrement window.__timelines
  2. Utiliser la vidéo pour l'audio — toujours vidéo muette + <audio> séparé
  3. Imbriquer une vidéo dans une div minutée — utilisez un wrapper non minuté
  4. Utiliser data-layer (utilisez data-track-index) ou data-end (utilisez data-duration)
  5. Animer les dimensions d'un élément vidéo — animez une div wrapper
  6. Appeler play/pause/seek sur un média — le framework possède la lecture
  7. Créer un conteneur de premier niveau sans data-composition-id
  8. Utiliser repeat: -1 sur une timeline ou un tween — toujours des répétitions finies
  9. Construire des timelines de manière asynchrone (dans async, setTimeout, Promise)
  10. Utiliser gsap.set() sur des éléments de clip de scènes ultérieures — ils n'existent pas dans le DOM au chargement de la page. Utilisez plutôt tl.set(selector, vars, timePosition) à l'intérieur de la timeline au moment ou après le data-start du clip.
  11. Utiliser <br> dans le texte du contenu — les sauts de ligne forcés ne tiennent pas compte de la largeur de police réellement rendue. Le texte qui se met à la ligne naturellement + un <br> produit un saut supplémentaire non désiré, provoquant un chevauchement. Laissez plutôt le texte se mettre à la ligne via max-width. Exception : les titres courts d'affichage où chaque mot est délibérément sur sa propre ligne (par exemple, « THE\nIMMORTAL\nGAME » à 130px).

Transitions de scène (Non-négociables)

Chaque composition multi-scène DOIT suivre TOUTES ces règles. En violer une seule rend la composition cassée.

  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.

Skills associés