Avant tout, gardez cette compétence à jour — vérifiez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update faceless-explainer. Une opération rapide sans effet si tout est à jour ; sinon, cela rafraîchit cette compétence ainsi que les compétences de domaine dont elle dépend avant de les utiliser.
media-use : Avant de trouver des ressources audio/images/logos, appelez
/media-usepour obtenir la BGM/les effets sonores/images du catalogue HeyGen et les logos de marque depuis leurs sources officielles. Exécutez d'abord--adoptpour enregistrer les ressources existantes. Voir la compétence/media-use.
Expliqueur sans visage vers HyperFrames
Utilisez cette compétence pour transformer un bloc de texte en vidéo explicative : choisissez un système de design, planifiez une histoire pédagogique et construisez-la image par image dans HyperFrames. Sans visage signifie que chaque visuel est inventé en aval — il n'y a pas d'étape de capture et aucun inventaire de ressources réel.
La porte d'entrée est
/hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa validation, et continuez seulement ensuite. Cette compétence sert à expliquer un sujet à partir de texte, sans produit ni site web à capturer. Toute autre intention, un simple « faire une vidéo » ou toute incertitude → lisez/hyperframesd'abord — la couche d'intention possède chaque décision d'itinéraire, 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 validation avant de continuer. Les étapes avec validation 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 validation et comment flow/storyboard de BRIEF.md déterminent le mode qui régit les validations des Étape 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 conception ou d'animation ici ; elles se trouvent dans le sous-agent de travail des images, dans ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ et hyperframes-creative.
Workflow : Étape 0 configuration → hyperframes.json ; Étape 1 brief → capture/extracted/ ; É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éterminent le mode (contrat du brief § 1). (2) Pas de BRIEF.md mais le projet existe (hyperframes.json / STORYBOARD.md sur le disque) → reprenez à partir des métadonnées 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, mène les questions de cet itinéraire (../hyperframes/references/routes/faceless-explainer.md) et restitue le brief verrouillé. Les demandes de modification ignorent tout cela — allez faire la modification.
Initialisez seulement si hyperframes.json est manquant. Nommez <projet> à partir du sujet en kebab-case, par exemple interets-composes-expliques ; n'utilisez jamais le nom de l'espace de travail ou un horodatage.
npx hyperframes init "videos/<projet>" --non-interactive --example=blank --skill=faceless-explainer — 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 <RACINE_PROJET> être videos/<projet> 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 <RACINE_PROJET> ; n'écrivez jamais .media, capture ou des fichiers de sortie dans le répertoire appelant.
Écrivez BRIEF.md immédiatement après init (jamais avant — init refuse un répertoire non vide) : le brief verrouillé par la couche d'intention, format selon ../hyperframes/references/brief-format.md. Résolvez <REPERTOIRE_MEDIA> comme le répertoire d'installation de la compétence /media-use. Ensuite, enregistrez chaque réponse basée sur les préférences avec node <REPERTOIRE_MEDIA>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomme le sous-ensemble). Si la couche d'intention a adopté une recette, exécutez node <REPERTOIRE_MEDIA>/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 est rédigée. Une recette remplit les réponses, pas les approbations ; les validations de révision s'exécutent toujours.
Affichez l'état de connexion avant de passer la Configuration — exécutez npx hyperframes auth status et retransmettez sa sortie textuellement. Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, lorsque vous êtes déconnecté, comment vous connecter. Appliquez une branche :
- Collaboratif : attendez que l'utilisateur se connecte ou choisisse explicitement
offline/go. - Autonome : indiquez l'état 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.
Validation : hyperframes.json et BRIEF.md existent ; les réponses basées sur les préférences ont été enregistrées (contrat du brief § 2) ; l'état de connexion a été affiché (connecté, ou continuation hors ligne).
Étape 1 : Brief (pas de capture)
Objectif : Intégrer le texte de l'utilisateur dans le projet en tant que source d'information. Il n'y a pas de capture de site web et pas de ressources réelles — il s'agit d'un explicateur sans visage.
Enregistrez l'intégralité de la saisie de l'utilisateur textuellement, puis créez le package de capture synthétique à la main :
capture/extracted/visible-text.txt— l'article / les notes / le sujet / le brief complet, textuellement. C'est la source d'information, pas un modèle d'histoire (l'Étape 3 le remodèle).capture/extracted/tokens.json—{ "title": "", "description": "", "colors": [], "fonts": [] }. Remplisseztitle/descriptionà partir du brief. Laissezcolors/fontsvides sauf si l'utilisateur a explicitement donné des couleurs ou polices de marque — alors ajoutez-les (le préréglage de design fournit une palette complète quoi qu'il arrive).
Si l'utilisateur a collé un script ou souhaite que son texte soit conservé, enregistrez-le textuellement sous user_script.txt ; VO_MODE (textuel ou restructuré) vient de BRIEF.md — la couche d'intention le demande lorsqu'un script arrive. Demandez une fois ici seulement si le brief manque de cela, et stockez la réponse pour l'Étape 3.
N'exécutez pas npx hyperframes capture (il n'y a pas d'URL). Ne créez pas asset-descriptions.md et ne remplissez pas capture/assets/ — les visuels sans visage sont inventés aux Étape 4-5, pas capturés. La seule exception : si l'utilisateur a fourni une image réelle, placez-la sous public/<nom_base> et notez-la pour l'Étape 3.
Validation : capture/extracted/visible-text.txt et capture/extracted/tokens.json existent ; vous pouvez énoncer le sujet et le public de l'explicateur en une phrase claire.
Étape 2 : Système de design
Objectif : Choisir un préréglage d'image fourni ; 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 dans les présentations de la couche d'intention — utilisez-le ; le jugement vous appartient seulement lorsque le brief est silencieux. Ensuite, vous prenez la seule décision — quel préréglage : lisez ../hyperframes-creative/references/design-spec.md et parcourez ../hyperframes-creative/frame-presets/ ; choisissez le préréglage dont l'apparence correspond le mieux au sujet, au ton et au public. Exécutez ensuite :
node <REPERTOIRE_COMPETENCE>/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 tous les jetons de marque dans capture/extracted/tokens.json (couleurs de marque mappées sur les clés de couleur du préréglage par rôle ; les polices d'affichage + corps du préréglage remplacées par celles de la marque), copie le skin de légende du préréglage vers .hyperframes/caption-skin.html, et s'auto-valide (sortie 1 sur un mappage cassé). Procédez dès qu'il sort 0 — pas de modification manuelle de la spécification.
Un explicateur sans visage n'a généralement pas de couleurs/polices de marque (tokens.json couleurs/polices vides) → le script conserve la propre palette du préréglage, un design complet et livrable. Seulement lorsque l'utilisateur a nommé des couleurs/polices de marque, ajoutez-les à tokens.json avant l'exécution, et ajustez frame.md à la main ensuite seulement si un mappage en a vraiment besoin.
Validation : build-frame.mjs a terminé avec 0 — frame.md existe à partir d'un préréglage nommé, et (lorsque le préréglage en fournit un) .hyperframes/caption-skin.html existe en tant que 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 du brief § 2).
Étape 3 : Storyboard et script
Objectif : Transformer le texte en un plan pédagogique approuvé image par image.
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: des métadonnées à partir du length du brief — une attente approximative ; le montage indique où la coupe se situe par rapport à cela.
Utilisez story-design.md pour la structure de l'explicateur (concept / tutoriel / listicle / histoire), la stratégie d'accroche, les techniques de clarté, les rythmes émotionnels, le mappage d'énumération de type et VO_MODE. La séquence vidéo vient de la conception narrative, pas de l'ordre des paragraphes du texte d'entrée — réorganisez, fusionnez, omettez, compressez. En tant que guide souple, consultez le menu rôle→plan dans ../hyperframes-animation/blueprints-index.md : pour chaque temps fort, écrivez la voix off dans la forme qu'implique son plan candidat et étiquetez cet id candidat blueprint: lorsqu'il correspond. La vérité pédagogique décide toujours quels temps forts existent — ne forcez jamais un temps fort à correspondre à un plan et n'inventez jamais un temps fort simplement parce qu'une forme éprouvée est disponible. Les visuels sans visage sont inventés en aval, donc les images ne portent pas d'inventaire de ressources : laissez asset_candidates vide sauf si l'utilisateur a fourni une image public/<nom_base> réelle. Utilisez les champs obligatoires exacts des références de storyboard et de script.
Après la rédaction, exécutez le passage de planification 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 comme une réponse de chat ; bouclez jusqu'à approbation. C'est une validation de point de contrôle (contrat du brief § 1) : en mode autonome, il n'y a rien à demander — publiez le même résumé comme avertissement et continuez ; les croquis se fondent dans la construction, et la seule question de prévisualisation vient à l'Étape 6.
Validation : STORYBOARD.md existe, chaque image a les champs narratifs obligatoires, SCRIPT.md existe lorsque la narration est nécessaire, et l'utilisateur a approuvé le plan image par image (autonome : le résumé a été publié comme avertissement).
Étape 3.1 : Audio
Objectif : Générer la narration, les minutages des mots, la musique et les métadonnées audio à partir du script approuvé.
Commencez l'audio après l'approbation de l'Étape 3. Exécutez-le en arrière-plan, puis continuez à l'Étape 4. (L'état de connexion a déjà été affiché à l'Étape 0 ; le moteur se replie automatiquement.)
Choisissez la voix de narration à partir de la demande de l'utilisateur avant d'invoquer. Si la demande a nommé une voix, un genre ou un ton, choisissez un identifiant de voix correspondant et passez-le avec --voice <id>. La valeur par défaut du pipeline est sinon Marcia (féminin) sur HeyGen / am_michael sur Kokoro — donc une demande comme « une voix masculine » est silencieusement ignorée sauf si vous passez l'indicateur. Les identifiants de voix sont spécifiques au fournisseur ; résolvez selon le fournisseur que l'état de connexion de l'Étape 0 a sélectionné : HeyGen (connecté) via node <REPERTOIRE_MEDIA>/audio/scripts/heygen-tts.mjs --list (ou GET /v3/voices?engine=starfish) ; Kokoro (hors ligne) via le tableau des voix dans <REPERTOIRE_MEDIA>/audio/references/tts.md (préfixes am_/bm_ masculin, af_/bf_ féminin). Lorsque l'utilisateur n'a exprimé aucune préférence, revenez à la voix mémorisée (contrat du brief § 2) avant la valeur par défaut du pipeline, et dites laquelle vous avez utilisée ; omettez --voice seulement lorsque aucun des deux n'en nomme une. Lorsque l'utilisateur a explicitement choisi une voix lors de cette exécution, enregistrez-la (prefs.mjs record --key voice).
node <REPERTOIRE_COMPETENCE>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <id-voix> &
Le script audio gère la narration, les minutages des mots, la recherche de BGM dans la bibliothèque musicale de HeyGen et les métadonnées de minutage. L'ambiance BGM provient du champ music: du storyboard. Cela utilise l'API Audio de HeyGen pour la récupération, pas la génération, et la même information d'identification ~/.heygen que TTS. Pour les détails du fournisseur, lisez ../media-use/audio/references/tts.md.
S'il n'y a pas de narration et pas de SCRIPT.md, ignorez la génération vocale. La BGM peut toujours s'exécuter si le storyboard a une ambiance musicale.
Le marqueur de silence total canonique (partagé entre les workflows qui réutilisent ce modèle audio) : music: none dans le bloc YAML supérieur de STORYBOARD.md et pas de SCRIPT.md. Cette combinaison marque le projet comme silencieux — pas de narration, pas de BGM, pas d'effets sonores. audio.mjs le reconnaît et ne génère rien (il supprime tout audio_meta.json périmé ; un audio_meta.json absent est ce que le montage traite comme silencieux), donc cette étape est un passage propre. music: none avec narration conserve TTS et désactive seulement la BGM. Utilisez exactement cette orthographe — n'improvisez pas d'autres marqueurs.
Validation : le travail audio a commencé, ou le projet est marqué comme silencieux (music: none + pas de SCRIPT.md).
É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.
Esquissez d'abord la feuille de storyboard (uniquement en mode collaboratif). Dès que le plan est approuvé, exécutez le passage d'esquisse — ../hyperframes/references/review-loop.md § 2 (n'attendez pas l'Étape 3.1 ; les esquisses n'utilisent pas de minutages) : créez un wireframe de chaque image vous-même comme une cellule de storyboard.html (`../hyperframes/reference…