media-use : Avant de sourcer de l'audio/des images, appelez
/media-usepour trouver BGM/SFX/images depuis le catalogue HeyGen. Exécutez d'abord--adoptpour enregistrer les assets 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 la création 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; sujet explicatif →/faceless-explainer; PR GitHub →/pr-to-video; images existantes →/embedded-captions·/talking-head-recut; court motion design 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 d'images 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 soutien + 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 en silence. 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 — uniquement pour les demandes ouvertes
Pour les demandes vagues et exploratoires (« faites quelque chose pour notre marque », « une intro cool ») — comprenez l'intention avant de choisir les couleurs :
- Public — qui regarde ? développeurs / dirigeants / consommateurs généraux ?
- Plateforme — où est-ce diffusé ? social (15s) / bannière de site web / démo produit / interne ?
- Priorité — quelle est la chose la plus importante ? qualité du mouvement / précision du contenu / fidélité à la marque / rapidité ?
- Variations — une seule meilleure prise, ou 2-3 options significativement différentes (rythme, énergie ou structure différents — pas seulement des changements de couleur) ?
Pour les demandes spécifiques (« ajoutez une carte-titre », « corrigez 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 design, lisez-le (priorité frame.md → design.md → DESIGN.md ; traitez-le comme la vérité de la marque — couleurs, polices et 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 le prompt / générer du contenu réel », la liste des valeurs par défaut paresseuses et la recette des couches ; video-composition.md donne la densité / échelle / détail du premier plan (barres de données, marques d'enregistrement, métadonnées monospace, « 8-10 éléments, dont deux que l'utilisateur n'a pas demandés ») qui distingue le « produit » du « généré ». Lire un seul est l'erreur la plus courante — video-composition.md est celui que les agents oublient, et c'est exactement celui qui empêche une sortie plate, centrée et ressemblant à une page web. Ne vous inventez pas une palette et ne les sautez pas ; entrer dans hyperframes-creative est obligatoire ici, pas une branche facultative. À partir de là, tirez également un style/ambiance nommé → references/visual-styles.md, ou le sélecteur interactif → references/design-picker.md, si nécessaire. 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 scan de périmètre / gâches de serrure ; une application de méditation → marée, souffle, éclosion lumineuse lente. Lisez le sens du sujet, pas seulement ses lettres ; choisissez un angle concret plutôt qu'un restylage littéral. C'est le substitut peu coûteux de l'expansion de prompt (É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 designé et un logo générique sur un dégradé.
Étape 2 — Expansion du prompt → hyperframes-creative
Exécutez pour chaque composition multi-scènes (sautez pour les pièces à scène unique et les modifications triviales). Ancrez la demande par rapport au cahier des charges 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 haut niveau :
- Quoi — l'expérience du spectateur : arc narratif, moments clés, battements émotionnels.
- Structure — combien de compositions, sous-composition vs inline, quelles pistes portent la vidéo / l'audio / les superpositions / les sous-titres. Pour la décision fichier-monolithique-unique vs sous-composition 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 courte pièce à scène unique reste un seul fichier). - Rythme — nommez le motif avant de l'implémenter (par ex.
rapide-rapide-LENT-SHADER-tenu) ; voirhyperframes-creative/references/beat-direction.md. - Timing — quels clips déterminent la durée, où atterrissent 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à où il se trouve à son moment le plus visible — complètement entré, correctement placé, pas encore en sortie. Écrivez cela comme HTML + CSS statique d'abord. 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 superpositions restent invisibles jusqu'au rendu. Construisez l'état final d'abord et vous voyez et corrigez les problèmes de mise en page avant d'ajouter du mouvement.
- Identifiez le plan héro de 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 ce plan. Le conteneur de contenu doit remplir la scène avec un padding, 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 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 quand le contenu est plus haut que l'espace. Réservez le positionnement absolu pour les éléments décoratifs.
⚠ Le
width/height: 100%ci-dessus ne fonctionne que si chaque ancêtre a une hauteur résolue. La racine<div data-composition-id>et tout wrapper entre elle 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 chemin vers elle. - 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 plans héro respectifs — l'ordre de la timeline les empêche de coexister, et l'étape de mise en page rattrape les chevauchements accidentels. Les lueurs/ombres superposées et la profondeur en z-stack sont des chevauchements intentionnels ; l'étape vise à détecter les collisions non intentionnelles (deux titres l'un sur l'autre, contenu débordant de l'image).
Construction — déléguez aux skills de domaine
Ceci mappe la surface complète du skill (voir la description) à ses références — non exhaustif ; quand une intention n'est pas listée, acheminez via hyperframes-creative (apparence/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.
| Construction… | Lire en premier (dans l'ordre) |
|---|---|
| TOUJOURS — toute pièce non triviale, en plus de votre ligne d'intention ci-dessous | hyperframes-creative/references/house-style.md + references/video-composition.md (également exigé à l'Étape 1 / HARD-GATE ; le détail de premier plan « produit, pas généré ») |
| Typographie cinétique / textes en avant | 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 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 (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) ; rédaction des sous-titres + placement des assets 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) |
| Modulaires / sous-compositions | hyperframes-core/references/composition-patterns.md + references/sub-compositions.md |
Audio : un seul moteur (TTS · BGM · SFX)
Uniquement quand la pièce l'exige (selon « construisez exactement ce qui a été demandé » — pas de musique d'ambiance sur une carte-titre). N'écrivez pas votre propre TTS et ne fournissez pas de copie vendeur : écrivez un audio_request.json neutre et appelez le moteur partagé dans hyperframes-media. Il se dégrade automatiquement selon un interrupteur : credential HeyGen présent → TTS HeyGen + récupération musique/SFX ; absent → TTS ElevenLabs/Kokoro, génération BGM Lyria/MusicGen et bibliothèque SFX fournie. Liste complète des drapeaux + schéma de demande/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": "Le prochain battement." },
],
"bgm": { "query": "calme cinématographique soutenu" }, // omettez "mode" → auto (récupère si HeyGen, sinon génère) ; "none" pour désactiver
}
# <MEDIA_DIR> = le répertoire du skill hyperframes-media installé (au même niveau que ce skill)
node <MEDIA_DIR>/scripts/audio.mjs --request ./audio_request.json --hyperframes . --out ./audio_meta.json
Ensuite, lisez audio_meta.json : montez chaque voices[].path + (bgm.path, sfx[]) comme pistes <audio> et utilisez voices[].words pour les sous-titres, le tout selon hyperframes-core (pistes audio + rédaction des sous-titres). Si BGM a pris le chemin de génération (bgm_pending: true), exécutez hyperframes-media/scripts/wait-bgm.mjs avant le rendu final.
Liste de contrôle de sortie → hyperframes-cli
... [tronqué pour la traduction]