Installation du plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution du plugin lorsque cette compétence se trouve à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
D'abord, gardez cette compétence à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update product-launch-video. Une opération rapide et sans effet si tout est à jour ; sinon elle rafraîchit cette compétence ainsi que les compétences du domaine central dont elle dépend avant que vous ne vous y appuyiez.
media-use : Avant de sourcer des audio/images/logos, appelez
/media-usepour résoudre les BGM/SFX/images du catalogue HeyGen et les logos de marque depuis leurs sources officielles. Exécutez--adoptd'abord pour enregistrer les assets existants. Voir la compétence/media-use.
source figma : Si la source est une URL figma.com, exécutez
/figmad'abord — exportation des assets, tokens 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 l'assainissement SVG, la provenance du fichier.media/manifest.jsonlet la liaisonvar()des tokens de marque, ce qui empêcherait la propagation d'un changement ultérieur de marque sans une réimportation complète.
Lancement 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.
La porte d'entrée est
/hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa porte, et ne continuez qu'ensuite à l'étape suivante. Cette compétence est destinée à un produit qui est commercialisé, lancé, promu ou dévoilé, y compris les demandes telles que "promo pour notre site" lorsque l'objectif est promotionnel. Une demande de visite de site / présentation reste ici aussi :BRIEF.mdporte l'intention de montrer tel quel, et les captures d'écran deviennent les assets que la vidéo met en avant. Toute autre intention, un simple "faire une vidéo", ou toute incertitude → lisez/hyperframesd'abord — la couche d'intention possède chaque décision de routage, et une création fraîche arrivant ici sansBRIEF.mdpasse de toute façon par elle (règle d'ouverture de la Configuration).
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. Lisez ../hyperframes/references/brief-contract.md avant l'étape 0 — il définit les types de portes et comment le flow/storyboard de BRIEF.md dérivent le mode qui régit les portes 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 de mouvement ici ; celles-ci vivent dans le sous-agent worker-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 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 durable.
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 demandez rien — le brief est réglé, et son flow/storyboard dérivent le mode (contrat de 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) Ni l'un ni l'autre — 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, conduit les questions de cette route (../hyperframes/references/routes/product-launch-video.md), et renvoie le brief verrouillé. Les demandes de modification sautent tout cela — allez faire la modification.
Initialisez seulement 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 --skill=product-launch-video — 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'elles est obsolète.
Après init, laissez <PROJECT_ROOT> être videos/<projet> et exécutez chaque commande de chemin relatif suivante 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, forme selon ../hyperframes/references/brief-format.md. Résolvez <MEDIA_DIR> comme le répertoire de la compétence /media-use installée. 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> ; cela copie son frame.md dans le projet (l'étape 2 est alors ignorée) et renvoie les squelettes à partir desquels l'étape 3 esquisse. Une recette remplit les réponses, pas les approbations ; les portes 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 se termine 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 :
- Collaboratif : 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 blocage. N'intégrez pas cette décision dans une autre question et n'écrivez pas de clés dans un .env par dépôt. Propriété de l'authentification et solutions de repli hors ligne : /media-use references/setup-providers.md § Fournisseurs.
Porte : hyperframes.json et BRIEF.md existent ; les réponses basées sur les préférences ont été enregistrées (contrat de brief § 2) ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).
Étape 1 : Capture des assets
Objectif : Collecter le matériel source, les signaux de marque et les assets 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 assets. Script/brief collé -> enregistrez-le textuellement sous user_script.txt ; VO_MODE (textuellement 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 ne l'a pas). 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. Gardez le budget post-navigation par défaut sauf si l'appelant a un délai plus court ; alors passez 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 optionnel 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 brutal 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'assets. Ne fabriquez pas de solution de repli synthétique sans capture après un échec de capture d'URL. Continuez par 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" ainsi qu'un catalogue d'assets vide ne sont pas une preuve de page utilisable. Pour un brief de visite de site ou de présentation telle quelle, 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 de site ou de présentation telle quelle, la page capturée est la source de vérité visuelle. Utilisez la vraie capture d'écran au lieu de reconstruire le site web complet en HTML. Si le plan a besoin de mouvement interne, conservez la capture d'écran comme base et superposez les assets capturés réels à des positions mesurées, ou reconstruisez uniquement 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, pixel-parfait pour une fenêtre de 1920 pixels de large qui se déplace vers le bas. Elle est absente lorsque la page était trop haute pour être capturée en une seule pièce ; repliez-vous sur les captures de position de défilement qui se chevauchent dans le même répertoire. Un zoom avant au-delà de 1:1 nécessite sa propre capture 2x de cette région, car la plaque n'a pas de marge au-dessus de 1x. Recréez la page entière uniquement 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 assets 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 ou le script complet. asset-descriptions.md doit indiquer qu'aucun asset n'a été capturé sauf si l'utilisateur a donné des notes d'assets.
Porte : la capture JSON a rapporté 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 assets. S'il manque après une capture réelle, arrêtez-vous et signalez la capture incomplète. Les avertissements concernant une phase optionnelle dégradée ne sont acceptables que lorsque cette porte structurelle passe 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 sous-titrage de cette vidéo.
Lorsque BRIEF.md nomme un style_preset — l'utilisateur l'a choisi visuellement à partir des présentations dans la couche d'intention — utilisez-le ; l'appel de jugement vous appartient uniquement lorsque le brief est silencieux. Ensuite, vous faites l'appel unique — 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, toile, 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 sous-titrage du préréglage vers .hyperframes/caption-skin.html, et s'auto-valide (se termine par le code 1 en cas de mapping cassé). Passez à l'étape suivante dès qu'il se termine avec le code 0 — aucune modification manuelle des spécifications.
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) ; ajustez frame.md à la main seulement après si un mapping le nécessite vraiment.
Porte : build-frame.mjs s'est terminé avec le code 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 sous-titrage ; le préréglage choisi a été enregistré comme préférence (--key style_preset --workflow <ce workflow>, contrat de brief § 2).
Étape 3 : Storyboard et Script
Objectif : Transformer le brief et le matériel capturé en un plan 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 le duration : du frontmatter à partir du length du brief — une attente approximative ; le rapport d'assemblage indique où la coupe se situe par rapport à celle-ci.
Utilisez story-design.md pour le plan de l'histoire, l'accroche, la logique de persuasion, les temps forts, VO_MODE, et les choix d'assets. En tant que guide souple, consultez le menu rôle→plan directeur dans ../hyperframes-animation/blueprints-index.md : pour chaque temps fort, notez un identifiant de plan directeur candidat lorsqu'il correspond. La vérité de l'histoire décide toujours quels temps forts existent — ne forcez jamais un temps fort à s'adapter à un plan directeur, et n'inventez jamais un temps fort 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 assets sauf si cet inventaire est manquant ou inutilisable. Utilisez les champs obligatoires exacts des références de storyboard et de script.
Après avoir rédigé, 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 commentaires arrivent sous forme de réponse dans le chat ; bouclez jusqu'à approbation. Il s'agit d'une porte de point de contrôle (contrat de brief § 1) : en mode autonome