Installation du plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'installation du plugin lorsque ce skill se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Tout d'abord, maintenez ce skill à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update product-launch-video. Une opération rapide sans impact quand tout est à jour ; sinon, il actualise ce skill ainsi que les skills de base dont il dépend avant que vous ne les utilisiez.
media-use : Avant de rechercher des audio/images/logos, appelez
/media-usepour obtenir BGM/effets sonores/images du catalogue HeyGen et les logos de marque de leurs sources officielles. Exécutez d'abord--adoptpour enregistrer les assets existants. Voir le skill/media-use. Lorsque l'application hôte fournit ses propres outils de musique ou d'effets sonores, utilisez-les pour la musique et les effets sonores.
source figma : Si la source est une URL figma.com, exécutez d'abord
/figma— exportation d'assets, jetons de marque, et reconstruction des composants/storyboard si nécessaire — puis construisez ce workflow à partir de sa sortie. Ne pilotez pas Figma directement via des outils MCP bruts : cela contourne 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 peut pas se propager sans une réimportation complète.
Lancement produit vers HyperFrames
Utilisez ce skill pour capturer un produit, comprendre sa marque, planifier une vidéo de lancement, et la construire image par image dans HyperFrames.
La porte d'entrée est
/hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa validation, et continuez uniquement après. Ce skill est destiné à un produit en cours de commercialisation, de lancement, de promotion ou de dévoilement, y compris les demandes telles que « promo pour notre site » lorsque l'objectif est promotionnel. Une demande de visite guidée / présentation du site reste ici :BRIEF.mdporte l'intention de montrer tel quel, et les captures d'écran deviennent les assets que la vidéo présente. Toute autre intention, un simple « faire une vidéo », ou toute incertitude → lisez d'abord/hyperframes— la couche d'intention possède toutes les décisions d'acheminement, et une création fraîche arrivant ici sansBRIEF.mdpasse de toute façon par là (règle d'ouverture de Setup).
Vous êtes l'orchestrateur. Travaillez dans videos/<project>/. Exécutez les étapes dans l'ordre et passez chaque validation avant de continuer. Les étapes avec validation utilisateur sont les étapes 0, 3 et 6. Lisez ../hyperframes/references/brief-contract.md avant l'étape 0 — il définit les types de validation et comment flow/storyboard de BRIEF.md dérivent le mode qui régit les validations des étapes 3/4/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 design ou d'animation ici ; celles-ci vivent dans le sous-agent de travail de l'image, les ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ locaux de ce skill, et hyperframes-creative.
Workflow : Étape 0 configuration -> hyperframes.json ; Étape 1 capture -> capture/ ; Étape 2 système de design -> frame.md ; Étape 3 storyboard/script -> STORYBOARD.md et SCRIPT.md ; Étape 3.1 audio -> audio_meta.json ; Étape 4 design visuel -> STORYBOARD.md enrichi ; Étape 5 images -> compositions/frames/NN-*.html et index.html ; Étape 6 rendu final -> renders/video.mp4.
Étape 0 : Configuration
Objectif : Entrer avec un brief confirmé, créer le projet HyperFrames, et rendre le brief persistant.
Le brief est confirmé par la couche d'intention, pas par des questions posées ici. Règle d'ouverture, dans l'ordre : (1) BRIEF.md existe → lisez-le et ne posez aucune question — le brief est établi, et son flow/storyboard dérivent le mode (contrat brief § 1). (2) Pas de BRIEF.md mais le projet existe (hyperframes.json / STORYBOARD.md sur le disque) → reprenez à partir du frontmatter du storyboard et des préférences enregistrées ; ne réinterrogez jamais un projet à moitié construit. (3) Aucun des deux — une demande de création fraîche arrivée ici directement → lisez /hyperframes et exécutez sa couche d'intention (references/intent-interview.md) : elle vérifie les recettes et les valeurs par défaut mémorisées, mène les questions de cette route (../hyperframes/references/routes/product-launch-video.md), et renvoie le brief verrouillé. Les demandes de modification ignorent tout cela — allez faire la modification.
Initialisez seulement si hyperframes.json est manquant. Nommez <project> à 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/<project>" --non-interactive --example=blank --skill=product-launch-video — init vérifie les skills installés par rapport aux derniers sur GitHub et met à jour l'ensemble global si certains sont obsolètes.
Après init, laissez <PROJECT_ROOT> être videos/<project> et exécutez chaque commande de chemin relatif ultérieure avec ce répertoire comme répertoire de travail. Dans les commandes ci-dessous, . signifie <PROJECT_ROOT> ; n'écrivez jamais .media, capture ou des fichiers de sortie dans le répertoire de l'appelant.
Écrivez BRIEF.md immédiatement après init (jamais avant — init refuse un répertoire non vide) : le brief verrouillé de la couche d'intention, format selon ../hyperframes/references/brief-format.md. Résolvez <MEDIA_DIR> comme le répertoire du skill /media-use installé. Ensuite, enregistrez chaque réponse basée sur une préférence avec node <MEDIA_DIR>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomme le sous-ensemble). Si la couche d'intention a adopté une recette, exécutez node <MEDIA_DIR>/scripts/recipe.mjs use --hyperframes . --name <nom> ; elle copie son frame.md dans le projet (l'étape 2 est alors ignorée) et renvoie les squelettes à partir desquels l'étape 3 rédige. Une recette remplit les réponses, pas les approbations ; les validations de révision s'exécutent toujours.
Affichez le statut de connexion avant de passer la configuration — exécutez npx hyperframes auth status et relayez sa sortie textuellement. Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, lorsqu'il est déconnecté, comment se connecter. Notez le contrat de code de sortie : auth status sort avec le code 1 lorsqu'il n'est pas connecté (et lorsque les informations d'identification stockées sont rejetées) — ce code de sortie non nul est l'état normal de déconnexion, pas un échec de commande, donc ne le traitez pas comme une erreur, ne réessayez pas et ne l'enchaînez pas avec &&/set -e d'une manière qui interromprait le workflow. Appliquez une branche :
- Collaborative : attendez que l'utilisateur se connecte ou choisisse explicitement
offline/go. - Autonome : indiquez le statut et continuez via les moteurs locaux disponibles.
N'omettez pas silencieusement une capacité requise lorsqu'aucun fournisseur hors ligne n'existe ; signalez le bloqueur. Ne transformez pas cette décision en une autre question et n'écrivez pas de clés dans un .env par dépôt. Propriété de l'authentification et replis hors ligne : /media-use references/setup-providers.md § Fournisseurs.
Validation : hyperframes.json et BRIEF.md existent ; les réponses basées sur les préférences ont été enregistrées (contrat brief § 2) ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).
Étape 1 : Capture d'actifs
Objectif : Collecter le matériel source, les signaux de marque et les actifs 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 actifs. Script/brief collé -> sauvegardez-le textuellement comme user_script.txt ; VO_MODE (textuel ou restructuré) vient de BRIEF.md — la couche d'intention le demande lorsqu'un script arrive (demandez ici une seule fois seulement si le brief manque). Ensuite, 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 (ou le brief dit de ne pas gratter) -> chemin sans capture.
Exécutez la capture avec : npx hyperframes capture "<URL>" -o ./capture --json. Conservez le budget post-navigation par défaut à moins que l'appelant n'ait un délai plus court ; passez alors un --capture-budget <millisecondes> positif qui laisse du temps pour le travail en aval. --timeout contrôle uniquement la navigation de la page. Utilisez --skip-vision uniquement lorsque le sous-titrage d'image facultatif est intentionnellement désactivé.
Inspectez immédiatement le résultat de la commande et le répertoire de sortie. Un code de sortie non nul, JSON ok: false, ou capture/BLOCKED.md est un arrêt définitif pour le chemin de capture : signalez la raison enregistrée et ne consommez pas de captures d'écran partielles, de DOM, de jetons ou d'actifs. Ne fabriquez pas de repli synthétique sans capture après un échec de capture d'URL. Continuez via le chemin sans capture uniquement lorsque le brief original a fourni le matériel source, ou lorsque l'utilisateur passe explicitement à une capture d'écran ou un brief fourni après l'échec.
Les avertissements tels que « très peu de contenu textuel » accompagnés d'un catalogue d'actifs vide ne sont pas une preuve d'une page utilisable. Pour un brief de visite guidée ou de présentation tel quel, exigez une structure capturée fiable ou une capture d'écran fournie ; si aucun des deux n'existe, arrêtez-vous. N'inventez pas et ne reconstruisez pas la page simplement parce que la capture est inutilisable.
Pour un brief de visite guidée ou de présentation tel quel, la page capturée est la source de vérité visuelle. Utilisez la capture d'écran réelle au lieu de reconstruire le site Web complet en HTML. Si la capture a besoin de mouvement interne, conservez la capture d'écran comme base et superposez les actifs capturés réels à des positions mesurées, ou ne reconstruisez que le composant qui bouge. Pour une capture de défilement, animez la fenêtre d'affichage sur capture/screenshots/full-page.png — la plaque 1x du document entier, au pixel près pour une fenêtre d'affichage de 1920 de large se déplaçant vers le bas. Elle est absente lorsque la page était trop longue pour être capturée en une seule fois ; revenez aux captures de position de défilement qui se chevauchent dans le même répertoire. Un zoom avant au-delà du 1:1 nécessite sa propre capture 2x de cette région, car la plaque n'a pas de marge au-dessus du 1x. Ne recréez la page entière que lorsque l'utilisateur demande explicitement une interprétation stylisée ; une capture inutilisable seule n'est pas une autorisation.
Si GEMINI_API_KEY, GOOGLE_API_KEY ou une clé OpenRouter existe, la capture sous-titre automatiquement les actifs dans capture/extracted/asset-descriptions.md. Ce n'est pas une validation 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 ou le script complet. asset-descriptions.md doit indiquer qu'aucun actif n'a été capturé, sauf si l'utilisateur a fourni des notes sur les actifs.
Validation : le JSON de capture a signalé ok: true ; capture/BLOCKED.md n'existe pas ; capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md et capture/assets/ existent ; et vous pouvez énoncer la marque en une phrase claire. Traitez asset-descriptions.md comme l'inventaire principal des actifs. S'il manque après une capture réelle, arrêtez-vous et signalez que la capture est incomplète. Les avertissements concernant une phase facultative dégradée sont acceptables uniquement lorsque cette validation structurelle réussit toujours.
Étape 2 : Système de design
Objectif : Choisir un préréglage d'image livré ; un script le transforme en frame.md + skin de légende de cette vidéo.
Lorsque BRIEF.md nomme un style_preset — l'utilisateur l'a choisi visuellement à partir des présentations de la couche d'intention — utilisez-le ; la décision vous appartient uniquement lorsque le brief est silencieux. Ensuite, vous prenez la seule décision — 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 (couleurs de marque mappées sur les touches de couleur du préréglage par rôle — encre, canevas, accents — en conservant les touches/la structure/les composants ; les polices d'affichage + corps du préréglage échangées contre 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 — aucune 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 remplir) ; n'ajustez frame.md à la main par la suite que si un mapping en a vraiment besoin.
Validation : 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 ; le préréglage choisi a été enregistré comme préférence (--key style_preset --workflow <ce workflow>, contrat brief § 2).
Étape 3 : Storyboard et script
Objectif : Transformer le brief et le matériel capturé en un plan d'image par image approuvé.
Lisez ../hyperframes-creative/references/story-spine.md (langage d'accroche, valeur avant preuve, storyboard comme proposition, visuels traçables à la source), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes/references/storyboard-format.md et ../hyperframes/references/script-format.md. Utilisez-les pour écrire STORYBOARD.md et, lorsque la narration est nécessaire, SCRIPT.md. Définissez la duration: du frontmatter à partir du length du brief — une attente approximative ; le rapport d'assemblage indique où le montage se situe par rapport à celle-ci.
Utilisez story-design.md pour le blueprint de l'histoire, l'accroche, la logique de persuasion, les beats, VO_MODE et les choix d'actifs. En tant que guide souple, consultez le menu rôle → blueprint dans ../hyperframes-animation/blueprints-index.md : pour chaque beat, notez un identifiant de blueprint candidat lorsqu'il correspond. La vérité de l'histoire décide toujours quels beats existent — ne forcez jamais un beat à correspondre à un blueprint, et n'inventez jamais un beat 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 actifs à moins que cet inventaire ne soit manquant ou inutilisable. Utilisez les champs exacts requis issus des références du storyboard et du script.
Après la rédaction, exécutez le passage de plan de la boucle de révision — ../hyperframes/references/review-loop.md § 1 : présentez le plan comme une proposition et posez les deux questions — approuver ou modifier, et croquis d'abord (recommandé) ou passer. Les retours arrivent sous la forme...
[Le contenu a été tronqué pour la traduction]