Avant tout, gardez ce skill à jour — exécutez-le silencieusement, ne demandez pas :
npx hyperframes skills update general-video. Une exécution rapide sans effet si tout est à jour ; sinon, il actualise ce skill ainsi que les skills de domaine principaux dont il dépend avant que vous ne vous appuyiez sur eux.
media-use : Avant de sourcer des éléments audio/images/logos, appelez
/media-usepour résoudre les BGM/SFX/images du catalogue HeyGen et les logos de marque à partir de leurs sources officielles. Exécutez--adoptd'abord pour enregistrer les actifs existants. Voir le skill/media-use.
source figma : Si une entrée est une URL figma.com, exécutez
/figmad'abord — export d'actifs, jetons de marque, et reconstruction des composants/storyboard si nécessaire — puis construisez à partir de sa sortie. N'utilisez pas directement les outils MCP bruts pour piloter Figma : cela contournerait la désinfection SVG, la provenance.media/manifest.jsonl, et la liaisonvar()des jetons de marque, de sorte qu'un changement ultérieur de marque ne pourrait pas se propager sans une réimportation complète.
general-video — flux de travail vidéo général
Confirmez la route avant de construire. Ceci est le repli pour la création de compositions personnalisées. Si l'entrée correspond clairement à un flux spécialisé, préférez-le : produit commercialisé →
/product-launch-video; site général →/website-to-video; sujet explicatif →/faceless-explainer; PR GitHub →/pr-to-video; séquences existantes →/embedded-captions·/talking-head-recut; motion graphic court non narré →/motion-graphics; portage Remotion →/remotion-to-hyperframes. Hors périmètre : données en direct / au rendu, montage de type NLE d'une vidéo terminée, ou production de séquences que HyperFrames ne peut pas capturer. En cas de doute ? Lisez/hyperframesd'abord.
Construisez exactement ce qui a été demandé. Un carton-titre est un carton-titre — pas un carton-titre + trois scènes de soutien + musique ambiante + sous-titres. Si des scènes ou éléments supplémentaires amélioreraient véritablement la pièce, proposez-les ; ne les ajoutez pas silencieusement. Pour les petites modifications (corriger une couleur, ajuster une durée, ajouter un élément), sautez les étapes de planification et passez directement à la construction.
Approche
Découverte — uniquement pour les demandes ouvertes
Pour les demandes vagues et exploratoires (« créez quelque chose pour notre marque », « une intro sympa ») — comprenez l'intention avant de choisir les couleurs :
- Public — qui regarde ? développeurs / cadres / consommateurs généralistes ?
- Plateforme — où est-ce diffusé ? social (15s) / page d'accueil du site web / démo produit / interne ?
- Priorité — qu'est-ce qui compte le plus ? qualité du mouvement / précision du contenu / fidélité à la marque / rapidité ?
- Variations — une seule meilleure version, ou 2-3 options significativement différentes (rythme, énergie ou structure différents — pas seulement des échanges de couleurs) ?
Pour les demandes spécifiques (« ajoutez un carton-titre », « corrigez le timing de la scène 3 »), sautez la découverte. Si la demande porte un signal autonome continu (« surprenez-moi », « construisez-le simplement » — hyperframes-core/references/brief-contract.md § 1), sautez également la découverte : par défaut, une seule meilleure version et indiquez vos décisions avec des justifications en une ligne au fur et à mesure.
Étape 1 — Système de design → hyperframes-creative
Établissez d'abord l'identité visuelle. Si le projet a un cahier des charges de design, lisez-le (priorité frame.md → design.md → DESIGN.md ; traitez-le comme une vérité de marque — couleurs exactes, polices, contraintes).
S'il n'y a pas de cahier des charges, vous DEVEZ lire LES DEUX hyperframes-creative/references/house-style.md ET hyperframes-creative/references/video-composition.md avant de choisir une couleur ou une police. house-style.md donne l’ouverture « interpréter l’invite / générer du contenu réel », la liste des valeurs par défaut paresseuses et la recette des couches ; video-composition.md donne les règles de densité / échelle / détails de premier plan (barres de données, repères d’enregistrement, métadonnées monospace, « 8-10 éléments, dont deux que l'utilisateur n'a pas demandés ») qui séparent le « produit » du « généré ». Lire un seul est l'oubli le plus courant — video-composition.md est celui que les agents sautent, et c'est exactement celui qui empêche une sortie plate, centrée et qui ressemble à une page web. N'inventez pas votre propre palette et ne sautez pas ces étapes ; passer par hyperframes-creative est obligatoire ici, pas une branche optionnelle. De là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, selon les besoins. Le cahier des charges / style définit la marque, pas les règles de composition.
Trouvez l'angle (brief vague, pas de cahier des charges) : avant de choisir les couleurs, écrivez UNE phrase — qu'est-ce que ce nom/mot/sujet évoque, et quel monde visuel (métaphore, décor, instrument, motif) l'exprime ? Par exemple : un outil de cybersécurité → portes de coffre / lignes de balayage périmétrique / gâches de serrure ; une application de méditation → marée, souffle, lent éclat de lumière. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'un restylage littéral. C'est le substitut bon marché de l'expansion d'invite (Étape 2) pour les pièces à scène unique, où l'expansion est correctement sautée — et c'est la différence entre un concept conçu et un logo générique sur un dégradé.
<PORTE-FERMÉE> Avant d'écrire UNE QUELCONQUE composition HTML, vérifiez que vous avez LES QUATRE :
- Une identité visuelle ancrée dans le cahier des charges ou
house-style.md— pas inventée sur le moment. (Vous utilisez#333,#3b82f6, ouRoboto? Vous l'avez sautée.) - Une phrase d'angle conceptuel (l'étape « trouver l'angle ») pour tout ce qui dépasse une modification triviale — pas un restylage littéral des mots de l'invite.
- Un appariement de polices depuis la liste d'intégration (
hyperframes-creative/references/typography.md→ « Polices qui s'intègrent ») choisi délibérément — pasInter/Helvetica Neue/system-uipar défaut, et jamais une police d'affichage non intégrée que vous espérez simplement être rendue (les noms non regroupés ne s'intègrent que s'ils sont capturés automatiquement localement — et les rendus cloud ne les captureront pas). - Un plan de premier plan/densité issu de
video-composition.md— les règles d'ancrage aux bords, 8-10 éléments, métadonnées de premier plan, texture de fond. (Pile centrée sur une couleur unie avec moins d'environ 6 éléments et aucun détail ancré au bord ? Vous l'avez sautée — c'est le signe distinctif générique.) </PORTE-FERMÉE>
Étape 2 — Expansion d'invite → hyperframes-creative
Exécutez pour toute composition multi-scènes (ignorez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges de design + style maison en un intermédiaire cohérent que les travaux en aval lisent de la même manière. Voir hyperframes-creative/references/prompt-expansion.md.
Étape 3 — Planification
Avant d'écrire du HTML, réfléchissez à un niveau élevé :
- Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels. Pour une pièce narrative avec voix-off, suivez
hyperframes-creative/references/story-spine.md— accroche dans le langage du résultat pour le spectateur, le message qui arrive au battement 2, les preuves après. - Structure — combien de compositions, sous-comp ou en ligne, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la décision fichier monolithique unique vs sous-comp modulaire, voir
hyperframes-core/references/composition-patterns.md§ Deux Architectures (règle empirique : ≥ 3 coupures de scène dures, ou toute scène réutilisée → modulariser ; une pièce courte à scène unique reste un seul fichier). - Rythme — nommez le motif avant de l'implémenter (par exemple
rapide-rapide-LENT-SHADER-attente) ; voirhyperframes-creative/references/beat-direction.md. - Chronométrage — quels clips déterminent la durée, où se situent les transitions, le rythme.
- Mise en page — construisez d'abord l'état final (voir ci-dessous).
- Animer — puis ajoutez le mouvement via
hyperframes-animation.
Mise en Page Avant Animation
Positionnez chaque élément à l'endroit où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en train de sortir. Écrivez cela d'abord en HTML + CSS statique. Pas encore de GSAP.
Pourquoi : si vous positionnez les éléments à leur état de départ animé (hors écran, mis à l'échelle 0, opacité 0) et que vous animez vers l'endroit où vous pensez qu'ils atterrissent, vous devinez la mise en page finale — les chevauchements restent invisibles jusqu'au rendu. Construisez d'abord l'état final et vous voyez et corrigez les problèmes de mise en page avant d'ajouter du mouvement.
- Identifiez l'image clé pour chaque scène — le moment où le plus d'éléments sont simultanément visibles. C'est la mise en page que vous construisez.
- Écrivez du CSS statique pour cette image. Le conteneur de contenu doit remplir la scène avec du remplissage, pas des décalages absolus :
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* le padding positionne le contenu ; remplit n'importe quelle taille de scène */
gap: 24px;
box-sizing: border-box;
}
N'utilisez jamais position: absolute; top: Npx sur un conteneur de contenu — il déborde lorsque le contenu est plus grand que l'espace. Réservez le positionnement absolu aux éléments décoratifs.
⚠ Le
width/height: 100%ci-dessus ne se résout que si chaque ancêtre a une hauteur résolue. Le<div data-composition-id>racine et tout wrapper entre lui et.scene-contentdoivent être dimensionnés (position: relative; width: 1920px; height: 1080pxsur la racine — voirhyperframes-core→ « La racine doit être dimensionnée »). Ignorez cela et le conteneur flex s'effondre à ~0, le contenu s'empile dans le coin supérieur gauche, et le premier glyphe est coupé à x=0 — tandis quelint/inspectsignalent toujours 0 problème. Et gardez toujours lepadding(≥ 80px) sur.scene-content: c'est la marge de sécurité du titre. Ne le remplacez jamais par une simplegap.
- Ajoutez les entrées — animez DEPUIS hors écran/invisible VERS la position CSS avec
gsap.from()(dans les sous-compositions, préférezgsap.fromTo()pour que l'état de départ soit explicite ; voirhyperframes-core/references/sub-compositions.md). La position CSS est la vérité de base ; l'animation est le voyage vers celle-ci. - Les sorties sont gérées par les transitions — selon les règles de transition de scène dans
hyperframes-animation/transitions/, seule la dernière scène anime les éléments vers l'extérieur ; entre les scènes, la transition EST la sortie.
Espace partagé dans le temps : si l'élément A sort avant que l'élément B n'entre dans la même zone, les deux ont toujours besoin de positions CSS correctes pour leurs images clés respectives — l'ordre de la chronologie les empêche de coexister, et l'étape de mise en page détecte les chevauchements accidentels. Les lueurs/ombres en couches et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape consiste à détecter les collisions non intentionnelles (deux titres l'un sur l'autre, contenu débordant du cadre).
Construction — déléguez aux compétences de domaine
Cela mappe la surface complète du skill (voir la description) à ses références — non exhaustif ; lorsqu'une intention n'est pas listée, acheminez via hyperframes-creative (aspect/concept), hyperframes-animation (mouvement), hyperframes-core (contrat), media-use (audio/sous-titres). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.
| En construction… | Lisez d'abord (dans l'ordre) |
|---|---|
| TOUJOURS — chaque pièce non triviale, en plus de votre ligne d'intention ci-dessous | hyperframes-creative/references/house-style.md + references/video-composition.md (également conditionné à l'Étape 1 / PORTE-FERMÉE ; les détails de premier plan « produit, pas généré ») |
| Typographie cinétique / axée sur le texte | hyperframes-animation/techniques.md (type cinétique) + adapters/gsap-easing-and-stagger.md + rules/kinetic-beat-slam.md |
| Carton-titre / tiers inférieur / superposition / PiP / texte derrière le sujet | hyperframes-creative/references/composition-patterns.md + (pour le cadre centré/dimensionné) hyperframes-core → « La racine doit être dimensionnée » |
| Révélation de logo / marque | hyperframes-animation/rules/svg-path-draw.md (dessin) + rules/3d-text-depth-layers.md + rules/scale-swap-transition.md |
| Données / statistiques / nombres | hyperframes-animation/rules/counting-dynamic-scale.md + rules/stat-bars-and-fills.md + hyperframes-creative/references/data-in-motion.md |
| Démo produit / application / UI | hyperframes-animation/rules/3d-page-scroll.md + rules/cursor-click-ripple.md + rules/press-release-spring.md |
| Audio-réactif / piloté par la musique | hyperframes-creative/references/audio-reactive.md (extraire les bandes au préalable ; mapper sur le mouvement) |
| Narré / voix-off / musique / SFX / sous-titres | media-use → le moteur audio partagé scripts/audio.mjs (un appel = TTS + BGM + SFX → audio_meta.json) ; création de sous-titres + placement d'actifs via hyperframes-core. Voir Audio ci-dessous. |
| Multi-scènes / transitions | hyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après l'aperçu — la recette GSAP est dans le catalogue) |
| Modulaire / sous-compositions | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Audio : un seul moteur (TTS · BGM · SFX)
Uniquement lorsque la pièce le nécessite (selon « construisez exactement ce qui a été demandé » — pas de musique ambiante sur un carton-titre). Ne mettez pas en œuvre manuellement le TTS ou un fournisseur de copie : écrivez un audio_request.json neutre et appelez le moteur partagé dans media-use. Il se dégrade automatiquement sur un interrupteur — identifiant HeyGen présent → TTS HeyGen + récupération de musique/SFX ; absent → TTS ElevenLabs/Kokoro, génération BGM Lyria/MusicGen et la bibliothèque SFX groupée. Liste complète des drapeaux + schéma de requête/méta : le…
…[tronqué pour la traduction]