Communitygithub.com

GanQiao1990/skills_2026

Créez des compositions vidéo, animations, cartons-titres, incrustations, sous-titres, voix off, visuels réactifs à l'audio et transitions de scène en HTML avec HyperFrames. À utiliser pour toute demande de contenu vidéo HTML, ajout de sous-titres synchronisés avec l'audio, génération de narration text-to-speech, création d'animations réactives à l'audio (synchronisation sur le beat, lueur, pulsation entraînée par la musique), ajout de surlignages animés (traits de marqueur, cercles dessinés à la main, lignes d'éclatement, gribouillis, esquisses), ou ajout de transitions entre les scènes (fondus, volets, révélations, transitions shader). Couvre la rédaction de compositions, le timing, les médias et l'ensemble du workflow de production vidéo. Pour les commandes CLI (init, lint, preview, render, transcribe, tts), voir la compétence hyperframes-cli.

Qu'est-ce que skills_2026 ?

Cette compétence technique avancée permet à un agent IA (comme Claude Code, Cursor ou Codex) de créer et manipuler des compositions vidéo entièrement en HTML via le framework HyperFrames. Elle couvre l'ensemble du pipeline de production vidéo : structure des compositions, gestion du timing, animations avec GSAP, création de sous-titres synchronisés, overlay, transitions entre scènes (fondus, volets, révélations) et effets visuels réactifs à l'audio (beat sync, glow, pulse). La compétence impose des règles strictes pour garantir des résultats déterministes et fiables : pas de `Math.random()`, pas de répétitions infinies (`repeat: -1` interdit), construction synchrone des timelines, et séparation stricte entre l'audio et les vidéos (vidéo toujours en `muted playsinline`, audio dans un élément `<audio>` dédié). Elle inclut un "Visual Identity Gate" qui force la définition d'une identité visuelle (couleurs, typographie, règles de style) avant toute écriture de code HTML, et privilégie une approche "Layout Before Animation" où l'état final de chaque scène est d'abord construit en CSS pur avant d'ajouter les animations d'entrée/sortie. Le guide détaille également les attributs `data-*` essentiels (start, duration, track-index, composition-id, etc.), la structure des sous-compositions via des balises `<template>`, ainsi que de nombreux pièges de production (chemins non-ASCII, échecs d'encodage MP4, conteneurs cachés en `display: none`, dépendances CDN). L'objectif est de fournir à l'agent un cadre complet et non-négociable pour produire des vidéos HTML de qualité professionnelle, sans approximation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/GanQiao1990/skills_2026/tree/HEAD/openclaw-imports/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

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.

Portée générale et workflows étroits absorbés

Cette compétence est le niveau général pour la rédaction HyperFrames. Elle couvre la structure de la composition, le timing, l'animation, l'identité visuelle, les sous-titres, les visuels réactifs à l'audio et la construction de scènes de qualité production. Utilisez la compétence hyperframes-cli pour la référence des commandes, et utilisez website-to-hyperframes lorsque la source est un site Web existant. Les notes étroites de production/débogage pour une seule session ont été rétrogradées en références de support ici.

Sous-section : pièges du workflow de production

Les notes de production historiques mettaient en évidence quelques pièges d'environnement qui restent utiles :

  • Préférez les chemins de projet/sortie en ASCII lors du rendu ; les chemins non-ASCII peuvent casser Chrome sans tête ou les sous-processus du moteur de rendu.
  • Si l'encodage MP4 échoue sous Conda FFmpeg, forcez le FFmpeg système avec export PATH=/usr/bin:$PATH ou effectuez le rendu en WebM comme solution de repli.
  • Lorsque des objets de timeline personnalisés sont utilisés à la place de GSAP, ils doivent exposer les méthodes duration(), pause() et seek(time) compatibles GSAP.
  • Si la vidéo finale semble noire ou vide, vérifiez d'abord si un conteneur .clip minuté a été masqué alors que seuls ses enfants étaient animés. Une classe utilitaire comme .hidden { display: none; } sur les wrappers de scène produit le mode d'échec classique : le rendu audio s'effectue, l'arrière-plan s'affiche, mais aucun texte/carton n'apparaît jamais car la scène parente n'entre jamais en mise en page/peinture. Pour les wrappers de scène minutés, masquez avec opacity: 0 ou une opacité contrôlée par timeline au lieu de display: none.
  • Pour le JS d'exécution critique tel que GSAP, préférez conserver une copie locale dans le projet (par exemple assets/gsap.min.js) plutôt que de compter sur les récupérations en direct du CDN lors du rendu.
  • Ajoutez <link rel="icon" href="data:,"> aux compositions autonomes pour supprimer le bruit des erreurs 404 de favicon du navigateur sans tête lorsqu'aucun favicon ne fait partie du projet.
  • Vérifiez visuellement en extrayant des images avec FFmpeg et en inspectant les captures d'écran, ne vous fiez pas uniquement à un code de sortie de rendu réussi.

Références de support rétrogradées

  • references/hyperframes-video-production.md
  • references/hyperframes-workflow.md

Approche

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. Timing — quels clips déterminent la durée, où se situent les transitions, quel est le rythme.
  4. Mise en page — construisez d'abord l'état final. Voir « Mise en page avant animation » ci-dessous.
  5. Animer — ajoutez ensuite le mouvement en utilisant les règles ci-dessous.

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

Porte d'identité visuelle

Vérifiez dans cet ordre :

  1. DESIGN.md existe dans le projet ? → Lisez-le. Utilisez ses couleurs, polices, règles de mouvement et contraintes « Ce qu'il ne faut PAS faire » exactes.
  2. visual-style.md existe ? → Lisez-le. Appliquez son style_prompt_full et ses champs structurés. (Remarque : visual-style.md est un fichier spécifique au projet. visual-styles.md est la bibliothèque de styles avec 8 préréglages nommés — fichiers différents.)
  3. L'utilisateur a nommé un style (par exemple, « Swiss Pulse », « sombre et technique », « marque de luxe ») ? → Lisez visual-styles.md pour les 8 préréglages nommés. Générez un DESIGN.md minimal avec : ## Style Prompt (un paragraphe), ## Colors (3 à 5 valeurs hexadécimales avec rôles), ## Typography (1 à 2 familles de polices), ## What NOT to Do (3 à 5 anti-patrons).
  4. Aucun des cas ci-dessus ? → Posez 3 questions avant d'écrire du HTML :
    • Quelle est l'ambiance ? (explosive / cinématographique / fluide / technique / chaotique / chaleureuse)
    • Toile claire ou sombre ?
    • Y a-t-il des couleurs, polices ou références visuelles de marque spécifiques ? Générez ensuite un DESIGN.md minimal à partir des réponses.

Chaque composition doit faire remonter sa palette et sa typographie à un DESIGN.md, un visual-style.md ou une direction utilisateur explicite. Si vous utilisez #333, #3b82f6 ou Roboto — vous avez sauté cette étape.

Pour les valeurs par défaut de mouvement, le dimensionnement, les motifs d'entrée et l'assouplissement — suivez house-style.md. Le style maison gère COMMENT les choses bougent. Le DESIGN.md gère À QUOI ressemblent les choses.

Mise en page 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 devraient atterrir, vous devinez la mise en page 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 mise en page avant d'ajouter du mouvement.

Le processus

  1. Identifiez l'image vedette pour chaque scène — le moment où le plus d'éléments sont visibles simultanément. C'est la mise en page que vous construisez.
  2. Écrivez du CSS statique pour cette image. Le conteneur .scene-content DOIT remplir toute la scène 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 positionnés en absolu 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 des entrées avec gsap.from() — animez DEPUIS l'état hors écran/invisible VERS la position CSS. La position CSS est la vérité de base ; l'interpolation décrit le voyage pour y arriver.
  4. Ajoutez des sorties avec gsap.to() — animez VERS l'état 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. */

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

.scene-content {
  position: absolute;
  top: 200px;
  left: 160px;
  width: 1920px;
  height: 1080px;
  display: flex; /* ... */
}
// Étape 3 : Animez 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 : Animez DEPUIS 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 vedettes respectives. L'ordre de la timeline garantit qu'ils ne coexistent jamais visuellement — mais si vous sautez l'étape de mise en page, vous ne détecterez pas le cas où ils se chevauchent accidentellement en raison d'une erreur de timing.

Ce qui constitue un chevauchement intentionnel

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

Attributs de données

Tous les clips

AttributeRequiredValues
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 prend par défaut la durée du média.
data-track-indexOuiEntier. Les clips d'une 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 le CSS z-index.

Clips de composition

AttributeRequiredValues
data-composition-idOuiID de composition unique
data-startOuiHeure de début (composition racine : utilisez "0")
data-durationOuiPrime 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>. L'utilisation de <template> sur un fichier autonome cache tout le contenu au 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 */
      }
    </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 });
      // interpolations...
      window.__timelines["my-comp"] = tl;
    </script>
  </div>
</template>

Chargez 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["<composition-id>"] = 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 d'interpolations 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 la 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, elles sont donc disponibles immédiatement — pas besoin d'attendre le chargement des polices.

Ne faites jamais :

  1. Oublier l'enregistrement de window.__timelines
  2. Utiliser une 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 une interpolation — 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 à ou après l'heure 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 réelle de la police rendue. Le texte qui se met à la ligne naturellement + <br> produit un saut supplémentaire indésirable, provoquant un chevauchement. Laissez le texte se mettre à la ligne via max-width à la place. Exception : les titres d'affichage courts 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 est une composition cassée.

  1. Utilisez TOUJOURS des transitions entre les scènes. Pas de coupes franches. Aucune exception.
  2. Utilisez TOUJOURS des animations d'entrée sur chaque scène. Chaque élément s'anime DEPUIS gsap.from(). Aucun élément ne peut apparaître complètement formé. Si une scène

…

[tronqué pour la traduction]

Skills associés