media-use : Avant de sourcer des fichiers audio/images, appelez
/media-usepour obtenir les BGM/SFX/images du catalogue HeyGen. Exécutez d'abord--adoptpour enregistrer les ressources existantes. Voir la compétence/media-use.
Lancement de produit vers HyperFrames
Utilisez cette compétence pour capturer un produit, comprendre sa marque, planifier une vidéo de lancement et la construire image par image dans HyperFrames.
Confirmez la route avant l'étape 0. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa porte, et seulement ensuite passez à l'étape suivante. Cette compétence est destinée à un produit en cours de marketing, de lancement, de promotion ou de révélation, y compris les demandes telles que « promo pour notre site » lorsque le but est promotionnel. Acheminez les autres intentions ailleurs : une visite générale de site web non liée à un lancement ->
/website-to-video; un sujet explicatif sans produit ->/faceless-explainer; une PR GitHub ->/pr-to-video; des légendes sur des séquences existantes ->/embedded-captions; un court motion design sans narration ->/motion-graphics. Si l'utilisateur dit seulement « fais une vidéo » ou si la route est incertaine, lisez d'abord/hyperframes.
Vous êtes l'orchestrateur. Travaillez dans videos/<projet>/. Exécutez les étapes dans l'ordre et passez chaque porte avant de continuer. Les étapes avec porte utilisateur sont l'étape 0, l'étape 3 et l'étape 6. Faites chaque étape vous-même, sauf l'étape 5, où vous déléguez un sous-agent par image. Ne mettez pas de règles de conception ou de mouvement ici ; celles-ci résident dans le sous-agent de travail d'image, les ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ locaux de cette compétence, et hyperframes-creative.
Workflow : Étape 0 configuration -> hyperframes.json ; Étape 1 capture -> capture/ ; Étape 2 système de conception -> frame.md ; Étape 3 storyboard/script -> STORYBOARD.md et SCRIPT.md ; Étape 3.1 audio -> audio_meta.json ; Étape 4 conception visuelle -> STORYBOARD.md enrichi ; Étape 5 images -> compositions/frames/NN-*.html et index.html ; Étape 6 rendu final -> renders/video.mp4.
Étape 0 : Configuration et Brief
Objectif : Verrouiller le brief vidéo principal et créer le projet HyperFrames si nécessaire.
Initialisez uniquement si hyperframes.json est manquant. Nommez <projet> à partir de la marque ou du domaine en kebab-case, par exemple acme-promo ; n'utilisez jamais le nom de l'espace de travail ou un horodatage.
npx hyperframes init "videos/<projet>" --non-interactive --example=blank — init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si l'une d'entre elles est obsolète.
Affichez l'état de connexion avant le brief — exécutez npx hyperframes auth status et relayez sa sortie textuellement (ne la paraphrasez pas et ne la réécrivez pas). Il indique si la voix/BGM utilisera les moteurs HeyGen ou 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"/"hors ligne" 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 une note de passage ; n'intégrez pas le choix dans la question du brief et n'écrivez pas de clés dans un .env par dépôt. (En mode autonome, notez l'état et continuez hors ligne.) Voir ../hyperframes-media → Preflight pour les conseils canoniques.
Porte : hyperframes.json existe, et l'angle, la durée, le rapport d'aspect et la langue sont verrouillés ; l'état de connexion a été affiché (connecté ou continuant hors ligne).
Étape 1 : Capturer les ressources
Objectif : Collecter le matériel source, les signaux de marque et les ressources utilisables pour la vidéo.
Classez l'entrée et choisissez le chemin. URL explicite -> capturez-la et utilisez le site pour la narration et les ressources. Script/brief collé -> enregistrez-le textuellement comme user_script.txt, demandez une fois "l'utiliser textuellement ou le restructurer ?", stockez la réponse comme VO_MODE, puis résolvez la cible de capture : URL dans le texte -> utilisez-la ; nom de marque uniquement -> WebSearch, confirmez l'URL en une ligne, puis explorez ; pas d'URL/site -> chemin sans capture.
Exécutez la capture avec : npx hyperframes capture "<URL>" -o ./capture
Si GEMINI_API_KEY, GOOGLE_API_KEY ou une clé OpenRouter existe, la capture sous-titre automatiquement les ressources dans capture/extracted/asset-descriptions.md. Ce n'est pas une porte de révision. Sans clé de vision, utilisez le contexte DOM et continuez.
Chemin sans capture : créez capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md et capture/assets/ manuellement. tokens.json doit être { "title": "", "description": "", "colors": [], "fonts": [] } ; remplissez le titre/la description à partir du brief lorsque c'est possible. visible-text.txt contient le brief complet ou le script. asset-descriptions.md doit indiquer qu'aucune ressource n'a été capturée, sauf si l'utilisateur a fourni des notes sur les ressources.
Porte : capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md et capture/assets/ existent ; vous pouvez énoncer la marque en une phrase claire. Traitez asset-descriptions.md comme l'inventaire principal des ressources. S'il manque après une capture réelle, arrêtez-vous et signalez une capture incomplète. Si capture/BLOCKED.md existe, suivez-le.
Étape 2 : Système de conception
Objectif : Choisir un préréglage d'image livré ; un script le transforme en frame.md + skin de légende pour cette vidéo.
Vous faites le seul jugement — quel préréglage. Lisez ../hyperframes-creative/references/design-spec.md et choisissez le préréglage dont l'apparence correspond le mieux à la marque et au brief. Exécutez ensuite :
node <SKILL_DIR>/scripts/build-frame.mjs --preset <nom> --hyperframes .
Le script fait le reste de manière déterministe : copie le FRAME.md du préréglage → frame.md et le remixe sur les jetons de marque dans capture/extracted/tokens.json (les couleurs de la marque mappées sur les clés de couleur du préréglage par rôle — encre, toile, accents — en conservant les clés/structure/composants ; les polices d'affichage + de corps du préréglage remplacées par celles de la marque), copie le skin de légende du préréglage dans .hyperframes/caption-skin.html, et s'auto-valide (sort avec 1 en cas de mapping cassé). Passez à l'étape suivante dès qu'il sort avec 0 — pas de modification manuelle de la spécification.
tokens.json sans couleurs/polices de marque (par exemple, pas de capture) → le script conserve la propre palette du préréglage, un design livrable complet. Si le brief nomme des couleurs/polices de marque que la capture a manquées, ajoutez-les à capture/extracted/tokens.json avant d'exécuter (ou utilisez le design.md de l'utilisateur pour le peupler) ; ne modifiez frame.md manuellement qu'après coup si un mapping en a vraiment besoin.
Porte : build-frame.mjs est sorti avec 0 — frame.md existe à partir d'un préréglage nommé, et (lorsque le préréglage en livre un) .hyperframes/caption-skin.html existe comme source du skin de légende.
Étape 3 : Storyboard et Script
Objectif : Transformer le brief et le matériel capturé en un plan narratif approuvé, image par image.
Lisez references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md et ../hyperframes-core/references/script-format.md. Utilisez-les pour écrire STORYBOARD.md et, lorsque la narration est nécessaire, SCRIPT.md.
Utilisez story-design.md pour le plan narratif, l'accroche, la logique de persuasion, les séquences, le VO_MODE et les choix de ressources. En tant que guide souple, consultez le menu rôle→plan dans ../hyperframes-animation/blueprints-index.md : pour chaque séquence, notez un identifiant de plan candidat lorsqu'il convient. La vérité de l'histoire décide toujours quelles séquences existent — ne forcez jamais une séquence à correspondre à un plan, et n'inventez jamais une séquence simplement parce qu'une forme éprouvée est disponible. Choisissez les asset_candidates de chaque image visuelle à partir de capture/extracted/asset-descriptions.md (l'inventaire canonique) — ne parcourez pas les capture/assets/ bruts. Ne demandez pas à l'utilisateur de choisir des ressources à moins que cet inventaire ne soit manquant ou inutilisable. Utilisez les champs requis exacts des références de storyboard et de script.
Après la rédaction, montrez un résumé image par image. Dans ce même message, posez deux questions à l'utilisateur : (a) approuver ou demander des modifications, et (b) s'il souhaite un aperçu en direct de l'échafaudage du storyboard (npx hyperframes preview) — ouvrez-le uniquement sur un oui. Itérez jusqu'à approbation et reportez le choix d'aperçu à l'étape 6.
Porte : STORYBOARD.md existe, chaque image visuelle a des asset_candidates, SCRIPT.md existe lorsque la narration est nécessaire, et l'utilisateur a approuvé le plan image par image.
Étape 3.1 : Audio
Objectif : Générer la narration, les temporisations de mots, la musique et les métadonnées audio à partir du script approuvé.
Commencez l'audio après l'approbation de l'étape 3. Lancez-le en arrière-plan, puis continuez à l'étape 4.
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json &
Le script audio gère la narration, les temporisations de mots, la recherche de BGM dans la bibliothèque musicale de HeyGen et les métadonnées de temporisation. L'ambiance BGM provient du champ music: du storyboard. Ceci utilise l'API audio HeyGen pour la récupération, pas la génération, et utilise les mêmes identifiants ~/.heygen que le TTS. Pour les détails du fournisseur, lisez ../hyperframes-media/references/tts.md.
S'il n'y a pas de narration et pas de SCRIPT.md, sautez la génération vocale. Le BGM peut toujours être exécuté si le storyboard a une ambiance musicale.
Porte : la tâche audio a démarré, ou le projet est marqué comme silencieux.
Étape 4 : Conception visuelle des images
Objectif : Ajouter la direction visuelle, l'intention de mise en page et les choix de mouvement à chaque image du storyboard.
Modifiez STORYBOARD.md sur place. Ne créez pas un autre storyboard. Utilisez frame.md comme source de vérité pour la couleur, la typographie, la sensation de mise en page et le style.
Lisez references/visual-design.md, ../hyperframes-animation/blueprints-index.md, references/motion-language.md et ../hyperframes-animation/rules-index.md. Utilisez visual-design.md pour la méthode (la séquence de plans avec code temporel, le vocabulaire de mise en page en ligne et le bloc ## Video direction requis). Utilisez ../hyperframes-animation/blueprints-index.md pour choisir la forme de plan de chaque image. Utilisez motion-language.md (le vocabulaire de mouvement + la doctrine de mouvement) et ../hyperframes-animation/rules-index.md (noms de règles valides) pour le mouvement — n'inventez pas de noms de mouvement.
Pour chaque image visuelle, écrivez une séquence de plans avec code temporel dans STORYBOARD.md selon la méthode de visual-design.md : choisissez le plan de l'image (ou composez), instanciez-le avec le contenu de CE produit, et rythmez la révélation de chaque scène sur la voix off afin que l'image se développe sur toute sa durée au lieu de tout dévoiler d'un coup puis de se figer. Indiquez la mise en page et le mouvement en ligne par scène (vocabulaires dans visual-design.md et motion-language.md). Ajoutez un bloc ## Video direction à l'échelle de la vidéo.
Ne modifiez pas l'histoire, le script, les choix de ressources, les asset_candidates, les transition_in ou le matériel source capturé. N'écrivez pas de HTML à cette étape.
Étalez les ressources nommées après que la conception visuelle est verrouillée :
node <SKILL_DIR>/scripts/stage-assets.mjs --storyboard ./STORYBOARD.md --hyperframes .
Porte : chaque image visuelle a une séquence de plans avec code temporel dont les révélations sont rythmées sur la voix off (pas de dévoilement précoce) ; ## Video direction existe ; assets/ contient les ressources nommées.
Étape 5 : Construire les images
Objectif : Construire chaque image du storyboard en tant que composition HTML et assembler la vidéo lisible.
Attendez que l'audio de l'étape 3.1 se termine si l'audio a été démarré. Ensuite, synchronisez les durées et récupérez les SFX ; sautez les deux si silencieux.
node <SKILL_DIR>/scripts/audio.mjs sync-durations --audio-meta ./audio_meta.json --storyboard ./STORYBOARD.md
node <SKILL_DIR>/scripts/audio.mjs fetch-sfx --storyboard ./STORYBOARD.md --hyperframes .
La synchronisation des durées est mécanique : la durée vocale réelle gagne ; les images silencieuses conservent les estimations ; ne modifiez jamais manuellement les durées synchronisées.
Avant la distribution, lisez sub-agents/frame-worker.md et ../hyperframes-core/references/subagent-dispatch.md. Distribuez un sous-agent par image, en parallèle si possible ; sinon, exécutez les travailleurs par vagues. Chaque travailleur reçoit exactement une image.
Le contexte de chaque travailleur doit inclure PROJECT_DIR, frame_id, la taille du canvas, l'état des légendes et la bande de réserve si les légendes sont activées, et RULES_DIR comme chemin absolu vers ../hyperframes-animation/rules/ de cette compétence. Chaque travailleur lit frame.md, son propre bloc ## Image N de STORYBOARD.md, la recette de règle locale (../hyperframes-animation/rules/<id>.md) pour chaque mouvement cité, et le modèle de plan de l'image (../hyperframes-animation/blueprints/<id>.md). Chaque travailleur écrit uniquement compositions/frames/NN-*.html. Les travailleurs ne doivent jamais modifier STORYBOARD.md.
Au retour de chaque travailleur, l'orchestrateur marque cette image comme animée dans STORYBOARD.md.
Une fois les temporisations audio existantes, construisez les légendes en arrière-plan et assemblez l'index :
node <SKILL_DIR>/scripts/captions.mjs build --storyboard ./STORYBOARD.md --audio-meta ./audio_meta.json --hyperframes . --out ./caption_groups.json &
node <SKILL_DIR>/scripts/assemble-index.mjs --storyboard ./STORYBOARD.md --hyperframes .
captions.mjs utilise le .hyperframes/caption-skin.html du projet (copié à l'étape 2) comme apparence de légende, injectant les jetons de marque de frame.md ; sans skin présent, il rend la pastille intégrée par défaut. caption: ignoré (<raison>) est valide. Continuez sans légendes lorsqu'elles sont explicitement ignorées.
Porte : chaque image est marquée comme animée, index.html existe, et les légendes sont construites ou explicitement ignorées.
Étape 6 : Finalisation
Objectif : Vérifier la vidéo assemblée, obtenir l'approbation de l'utilisateur et rendre le MP4 final.
Injectez les transitions, exécutez les vérifications, faites une pause pour révision, puis effectuez le rendu.
node <SKILL_DIR>/scripts/transitions.mjs inject --storyboard ./STORYBOARD.md --hyperframes .
node <SKILL_DIR>/scripts/transitions.mjs verify --storyboard ./STORYBOARD.md --index ./index.html
npx hyperframes lint
npx hyperframes validate
npx hyperframes inspect
npx hyperframes snapshot --at <milieux-des-images>
snapshot assemble les images capturées en une seule planche-contact (snapshots/contact-sheet.jpg). Jetez-y un coup d'œil ; si rien n'est manifestement cassé, passez à autre chose — ne vous attardez pas ici.
Si une commande échoue, affichez la sortie d'erreur et arrêtez-vous — n'empilez pas de commandes de récupération. Réparez-la vous-même : la modification sécurisée la moins coûteuse de compositions/frames/NN-*.html, puis relancez la vérification échouée.
Après que les vérifications réussissent, faites une pause pour la révision utilisateur. La vidéo est assemblée, visible et modifiable dans Studio. Gérez l'aperçu une seule fois entre l'étape 3 et l'étape 6 : ouvrez-le si l'utilisateur l'a demandé plus tôt, proposez-le s'il l'a refusé plus tôt, et ne demandez pas à nouveau s'il examine déjà dans Studio.
Aperçu : npx hyperframes preview
Rendu
…
[tronqué pour la traduction]