media-use : Avant de sourcer l'audio/les images, appelez
/media-usepour résoudre la BGM/SFX/les images du catalogue HeyGen. Exécutez--adoptd'abord pour enregistrer les actifs existants. Voir le skill/media-use.
general-video — workflow vidéo général
Confirmez la route avant de construire. Ceci est le repli pour l'écriture de compositions personnalisées. Si l'entrée correspond clairement à un workflow spécialisé, préférez-le : produit commercialisé →
/product-launch-video; site général →/website-to-video; explicatif de sujet →/faceless-explainer; PR GitHub →/pr-to-video; séquences existantes →/embedded-captions·/talking-head-recut; court graphisme animé sans narration →/motion-graphics; portage Remotion →/remotion-to-hyperframes. Hors périmètre : données en direct/au moment du rendu, montage de type NLE d'une vidéo terminée, ou production de séquences qu'HyperFrames ne peut pas capturer. Pas sûr ? Lisez/hyperframesd'abord.
Construisez exactement ce qui a été demandé. Une carte-titre est une carte-titre — pas une carte-titre + trois scènes de support + musique d'ambiance + sous-titres. Si des scènes ou éléments supplémentaires amélioreraient réellement 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 allez directement à la construction.
Approche
Découverte — demandes ouvertes uniquement
Pour les demandes vagues et exploratoires ("crée quelque chose pour notre marque", "une intro sympa") — comprenez l'intention avant de choisir les couleurs :
- Audience — qui regarde ? développeurs / cadres / consommateurs généraux ?
- Plateforme — où est-ce diffusé ? social (15s) / page d'accueil du site / démo produit / interne ?
- Priorité — qu'est-ce qui compte le plus ? qualité du mouvement / exactitude 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 changements de couleur) ?
Pour les demandes spécifiques ("ajoute une carte-titre", "corrige le timing de la scène 3"), sautez la découverte.
É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 (précédence frame.md → design.md → DESIGN.md ; traitez-le comme une vérité de marque — couleurs, polices, contraintes exactes).
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 la demande / générer du contenu réel", la liste des valeurs par défaut paresseuses et la recette des calques ; video-composition.md donne les règles de densité / échelle / détails de premier plan (barres de données, repères, métadonnées en 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 document est l'erreur la plus courante — video-composition.md est celui que les agents sautent, et c'est exactement celui qui empêche une sortie plate, centrée et ressemblant à une page web. N'inventez pas vous-même une palette et ne sautez pas ces documents ; passer dans hyperframes-creative est obligatoire ici, pas une branche optionnelle. À partir 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, sans 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ériphérique / gâchettes de serrure ; une app de méditation → marée, souffle, lueur de lumière lente. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'une restylisation littérale. C'est le substitut bon marché à l'expansion de prompt (Étape 2) pour les pièces à scène unique, où l'expansion est correctement ignorée — et c'est la différence entre un concept conçu et un logo générique sur un dégradé.
Étape 2 — Expansion du prompt → hyperframes-creative
Exécutez pour toute composition multi-scène (ignorez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges de design + le style maison dans un intermédiaire cohérent que le travail en aval lit 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.
- Structure — combien de compositions, sous-comp vs inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour l'appel entre fichier monolithique unique et 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 fichier). - Rythme — nommez le motif avant de l'implémenter (par exemple
rapide-rapide-LENT-SHADER-tenue) ; voirhyperframes-creative/references/beat-direction.md. - Timing — quels clips déterminent la durée, où se placent les transitions, le rythme.
- Mise en page — construisez d'abord l'état final (voir ci-dessous).
- Animation — ajoutez ensuite le mouvement via
hyperframes-animation.
Mise en page avant Animation
Positionnez chaque élément là 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 jusqu'à 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 résolvez les problèmes de mise en page avant d'ajouter du mouvement.
- Identifiez le cadre héro pour chaque scène — le moment où le plus grand nombre d'éléments sont simultanément visibles. C'est la mise en page que vous construisez.
- Écrivez le CSS statique pour ce cadre. Le conteneur de contenu doit remplir la scène avec du remplissage (padding), pas des décalages absolus :
.scene-content {
display: flex;
flex-direction: column;
justify-content: center;
width: 100%;
height: 100%;
padding: 120px 160px; /* le remplissage positionne le contenu ; remplit toute 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 haut 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 toute enveloppe entre lui et.scene-contentdoivent être dimensionnés (position: relative; width: 1920px; height: 1080pxsur la racine — voirhyperframes-core→ "La racine doit être dimensionnée"). Sautez 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èmes. Et gardez toujours lepadding(≥80px) sur.scene-content: c'est la marge de sécurité du titre. Ne le remplacez jamais par un 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'interpolation est le voyage vers elle. - Les sorties sont gérées par la transition — 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 cadres héro respectifs — l'ordre dans la timeline 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 concerne la détection des collisions non intentionnelles (deux titres l'un sur l'autre, contenu débordant du cadre).
Construction — déléguez aux skills de domaine
Cela cartographie la surface complète du skill (voir la description) vers 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), hyperframes-media (audio/sous-titres). La première ligne est ADDITIVE — lisez-la ET votre ligne d'intention, pas l'une ou l'autre.
| En train de construire… | 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 bloqué à l'Étape 1 / HARD-GATE ; 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 |
| Carte-titre / tiers-inférieur / superposition / PiP / texte-derrière-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 (tracé) + 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 |
| Produit / app / démo 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 (pré-extraire les bandes ; mapper au mouvement) |
| Narré / voix-off / musique / SFX / sous-titres | hyperframes-media → le moteur audio partagé scripts/audio.mjs (un appel = TTS + BGM + SFX → audio_meta.json) ; écriture des sous-titres + placement des actifs via hyperframes-core. Voir Audio ci-dessous. |
| Multi-scène / transitions | hyperframes-animation/transitions/overview.md puis transitions/catalog.md (vous n'avez pas fini après la vue d'ensemble — la recette GSAP est dans le catalogue) |
| Modulaire / sous-compositions | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Audio : un moteur (TTS · BGM · SFX)
Uniquement lorsque la pièce le demande (selon "construisez exactement ce qui a été demandé" — pas de musique d'ambiance sur une carte-titre). N'écrivez pas vous-même du TTS ou ne faites pas appel à un fournisseur avec une copie : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement selon un commutateur — identifiant HeyGen présent → TTS HeyGen + récupération de musique/SFX ; absent → TTS ElevenLabs/Kokoro, génération de BGM Lyria/MusicGen, et la bibliothèque SFX groupée. Liste complète des drapeaux + schéma requête/méta : le commentaire d'en-tête de hyperframes-media/scripts/audio.mjs.
// audio_request.json — une ligne par segment narré ; `id` est le vôtre (relie audio_meta)
{
"lines": [
{ "id": "s1", "text": "Votre première ligne.", "sfx": ["whoosh"] },
{ "id": "s2", "text": "La prochaine mesure." },
],
"bgm": { "query": "calme underscore cinématique" }, // omettre "mode" → auto (récupérer si HeyGen, sinon générer) ; "none" pour désactiver
}
# <MEDIA_DIR> = le répertoire du skill hyperframes-media installé (voisin de ce skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
Lisez ensuite audio_meta.json : montez chaque voices[].path + (bgm.path, sfx[]) en tant que pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + écriture des sous-titres). Si la BGM a emprunté le chemin de génération (bgm_pending: true), exécutez hyperframes-media/scripts/wait-bgm.mjs avant le rendu final.
Liste de vérification de sortie → hyperframes-cli
- …
[Le contenu a été tronqué pour la traduction, mais la structure et les instructions clés sont conservées.]