media-use : Avant de sourcer l'audio/les images, appelez
/media-usepour résoudre BGM/SFX/images depuis le catalogue HeyGen. Exécutez--adoptd'abord pour enregistrer les assets existants. Voir le skill/media-use.
Site Web vers HyperFrames
Capturez un site Web, puis produisez une vidéo professionnelle à partir de celui-ci.
Confirmez la route avant l'étape 0. Ce skill crée une vidéo d'un / à partir d'un site général. Si l'utilisateur fait vraiment du marketing / lancement / promotion d'un produit (même à partir de cette URL, même "promo pour notre site") →
/product-launch-video. Un explicateur de sujet sans site →/faceless-explainer; une PR GitHub →/pr-to-video; recouper / recolorier / réorganiser un fichier vidéo existant → hors de portée. Routé ici sur un vague "faire une vidéo", ou incertain entre lancement et site général ? Lisez/hyperframesd'abord (table de routage complète + § Ce que HyperFrames ne peut pas faire).
Les utilisateurs disent des choses comme :
- "Transforme ce site Web en un clip social de 15 secondes pour Instagram"
- "Fais une visite de site / démonstration de 30 secondes à partir de https://..."
- "Capture notre page d'accueil et construis une vidéo à partir de ses propres visuels"
Le workflow comporte 7 étapes. Chacune produit un artefact qui conditionne la suivante. Par défaut, il est collaboratif — les étapes marquées 💬 s'arrêtent et demandent à l'utilisateur. Si l'utilisateur signale un mode autonome ("décide pour moi", "surprends-moi"), les étapes 💬 liées aux préférences utilisateur sont ignorées ; voir step-2-brief.md pour la propagation.
Le mode autonome ne signifie PAS "ignorer toutes les vérifications". Le mode automatique couvre les questions de préférence utilisateur (fournisseur TTS, voix, accent de couleur, nombre de temps, musique oui/non, sous-titres oui/non — où l'agent décide pour l'utilisateur). Il ne couvre PAS les étapes de vérification de qualité. Les éléments suivants restent non ignorables en mode automatique :
- Audit des assets (Étape 3) — visualisation des planches contact et justification UTILISER/IGNORER pour chaque asset
- Lecture HTML par temps (Étape 5) — bloc de preuve structuré par temps
- Checklist DoD (Étape 6) — incluant la carte d'animation, la vérification WCAG par avertissement, la lecture audio/mouvement
- Section de divulgation honnête (Étape 6) — "Ce que je n'ai PAS vérifié" doit apparaître dans votre résumé final
Si vous vous surprenez à raisonner "le mode automatique dit de privilégier l'action, donc je vais ignorer X" — et que X est une étape de vérification, pas une question de préférence — ce raisonnement est erroné. Privilégier l'action s'applique à décider quoi construire, pas à décider si vérifier.
Étape 0 : Capture et Compréhension de la Marque
Lisez : references/step-0-capture.md
Capturez le site, puis lisez les données extraites pour comprendre la marque et le produit — ce qu'il fait, pour qui, quelle voix il utilise, dans quelle ambiance il évolue. Les assets capturés sont une boîte à outils de marque pour plus tard, pas les éléments de base à partir desquels la vidéo est fabriquée.
Affichez le statut de connexion avant le brief — exécutez npx hyperframes auth status et retransmettez sa sortie textuellement (ne paraphrasez pas et ne réécrivez pas). Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, lorsqu'il n'est pas connecté, comment se connecter. S'il n'est pas connecté, ARRÊTEZ-VOUS et attendez que l'utilisateur choisisse — se connecter, ou dire "go"/"offline" pour continuer avec les moteurs locaux — avant de demander le brief ou quoi que ce soit d'autre. Traitez-le comme un véritable point de décision, pas comme une note de passage ; n'intégrez pas le choix dans la question du brief, et n'écrivez pas les clés dans un .env par dépôt. (En mode autonome, notez le statut et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les instructions canoniques.
Point de contrôle : Résumé du site imprimé — stratégie d'abord (ce que le produit fait, pour qui, voix de la marque) avant l'inventaire des assets / couleurs / polices ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).
Étape 1 : Identité de Marque
Lisez : references/step-1-design.md
Écrivez DESIGN.md — une fiche de référence de la marque couvrant l'identité visuelle : couleurs, typographie, styles de composants, principes de mise en page. Utilisez design-styles.json pour les valeurs calculées exactes.
Option rapide : Pour les vidéos au rythme rapide (panneau d'affichage par temps), DESIGN.md peut être un résumé de 50 lignes des couleurs + polices + à faire/à ne pas faire — pas un document de 300 lignes. Le prompt du sous-agent à l'Étape 5 colle directement les valeurs de la marque, donc la profondeur de DESIGN.md n'a d'importance que pour les compositions complexes.
Point de contrôle : DESIGN.md existe (quelle que soit la longueur) avec au minimum : palette de couleurs, choix de polices, et à faire/à ne pas faire.
Étape 2 : Stratégie et Messagerie
Lisez : references/step-2-brief.md, references/capabilities.md (parcourez la Table des Matières — sections approfondies uniquement si nécessaire)
Alignez-vous avec l'utilisateur sur ce que la vidéo doit communiquer avant de parler de visuels ou d'assets. Analysez le prompt de l'utilisateur — il vous a probablement déjà donné le type et le style de la vidéo. Ne demandez que ce qui manque : la SEULE chose que cette vidéo doit dire, l'arc narratif, et le public.
Point de contrôle : Le type de vidéo, la durée, le format et — crucialement — le message et l'arc narratif sont verrouillés. Sans cela, l'Étape 3 ne peut pas écrire un storyboard axé sur le concept.
Étape 3 : Storyboard + Script 💬
Lisez : references/step-3-storyboard.md
Écrivez le storyboard concept d'abord : message → arc narratif → temps qui servent l'arc → techniques par temps → touches de marque à la fin. Écrivez ensuite le script de narration correspondant. Présentez les deux à l'utilisateur avec un résumé temps par temps. Itérez jusqu'à approbation.
Point de contrôle : STORYBOARD.md + SCRIPT.md existent ET l'utilisateur a approuvé le plan.
Étape 4 : VO, Timing + Sous-titres 💬
Lisez : references/step-4-vo.md
Si l'Étape 2 a dit pas de narration — demandez pour la musique de fond, puis passez à l'Étape 5. Sinon : demandez à l'utilisateur quel fournisseur TTS (HeyGen TTS, ElevenLabs ou Kokoro), générez l'audio, transcrivez, mappez les horodatages aux temps. Demandez ensuite pour les sous-titres.
Point de contrôle : Soit (a) aucune narration n'a été demandée et le storyboard a des timings de temps manuels, soit (b) narration.wav + transcript.json existent et les timings des temps sont mis à jour avec les durées réelles.
Étape 5 : Construction des Compositions
Lisez : Le skill hyperframes (chargez-le — chaque règle compte)
Lisez : references/step-5-build.md
Construisez index.html et les compositions en suivant l'architecture et le rythme choisis dans le storyboard (Étape 3). Les sous-agents exécutent hyperframes lint et hyperframes snapshot sur chaque temps avant de faire leur rapport.
Point de contrôle : Chaque compositions/beat-N.html a été lu de haut en bas par l'agent principal par rapport à DESIGN.md et STORYBOARD.md. La checklist par temps se trouve dans step-5-build.md.
Étape 6 : Valider et Livrer
Lisez : references/step-6-validate.md
Lintez, validez, prenez des instantanés à l'échelle de la longueur de la vidéo (formule : max(temps × 3, ceil(durée_secondes / 2))), et examinez chacun d'eux. Corrigez les problèmes avant de livrer. Livrez l'URL du projet Studio localhost — ne rendez en MP4 que sur demande explicite de l'utilisateur. Présentez cette URL Studio uniquement à la livraison — c'est l'aperçu stable final ; les instantanés de la phase de construction sont sans tête, donc ne faites pas apparaître un aperçu en cours de construction.
Livrez quelque chose dont vous êtes fier. Avant de remettre, demandez-vous : est-ce que je publierais ceci sur les réseaux sociaux avec mon nom ? Si non, corrigez ce qui ne va pas.
Point de contrôle : npx hyperframes lint et npx hyperframes validate passent avec zéro erreur, et la réponse finale inclut l'URL du projet Studio actif.
Référence Rapide
Types de Vidéos
Contraintes typiques par type de vidéo — à utiliser comme point de départ, pas comme formule. Le nombre de temps doit découler du contenu et de la narration, pas d'une plage cible.
| Type | Durée typique | Pilote de durée | Narration |
|---|---|---|---|
| Publicité sociale (IG/TikTok) | 10–15s | Limite de la plateforme | Optionnelle |
| Démo produit | 30–60s | Longueur du script | Narration complète |
| Annonce de fonctionnalité | 15–30s | Complexité de la fonctionnalité | Narration complète |
| Bande de marque | 20–45s | Piste musicale | Optionnelle, focus musique |
| Teaser de lancement | 10–20s | Énergie du crochet | Minimale |
Le nombre de temps n'est pas intentionnellement dans ce tableau — il doit venir du storyboard, pas de "publicité sociale = 3-4 temps." Une publicité sociale pour un produit complexe pourrait nécessiter 5 temps bien chronométrés. Une bande de marque avec une thèse visuelle forte pourrait n'en nécessiter que 3.
Format
- Paysage : 1920x1080 (par défaut)
- Portrait : 1080x1920 (Instagram Stories, TikTok)
- Carré : 1080x1080 (flux Instagram)
Fichiers de Référence
| Fichier | Quand lire |
|---|---|
| step-0-capture.md | Étape 0 — capturer, comprendre la marque et le produit, écrire un résumé du site axé sur la stratégie |
| step-1-design.md | Étape 1 — écrire la fiche de référence DESIGN.md de la marque (5 sections, 250-350 lignes ; chemin rapide de 50 lignes pour les publicités sociales de type panneau d'affichage) |
| step-2-brief.md | Étape 2 — s'aligner sur le message, l'arc narratif, le public avec l'utilisateur |
| capabilities.md | Étapes 2 & 5 — inventaire complet de ce que HyperFrames peut faire (24 sections). Parcourez la TdM pendant le brief, plongez dans les sections spécifiques pendant la construction |
| step-3-storyboard.md | Étape 3 — storyboard + script (combiné) avec point de contrôle de révision utilisateur |
| step-4-vo.md | Étape 4 — choix du fournisseur TTS, génération, timing |
| step-5-build.md | Étape 5 — construire index.html + compositions |
| step-6-validate.md | Étape 6 — linter, valider, instantanés (à l'échelle de la longueur de la vidéo), aperçu |
| techniques.md | Étapes 3 & 5 — 13 techniques d'animation primitives avec des modèles de code (adaptez, ne copiez-collez pas) |
| html-in-canvas-patterns.md | Étape 5 — modèles de code complets pour les effets HTML-dans-Canvas (réside dans le skill hyperframes) |