Installation du plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution des plugins lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Avant tout, gardez cette compétence à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update faceless-explainer. Une opération rapide 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 les utilisiez.
media-use : Avant de sourcer des audios/images/logos, appelez
/media-usepour obtenir BGM/bruitages/images depuis le catalogue HeyGen et les logos de marque depuis leurs sources officielles. Exécutez--adoptd'abord pour enregistrer les ressources existantes. Voir la compétence/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.
Faceless Explainer vers HyperFrames
Utilisez cette compétence pour transformer un corpus 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 ni d'inventaire de ressources réelles.
La porte d'entrée est
/hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa validation, puis continuez. Cette compétence est destinée à expliquer un sujet à partir d'un texte, sans produit ni site web à capturer. Pour toute autre intention, un simple « faire une vidéo », ou toute incertitude → lisez d'abord/hyperframes— la couche d'intention possède chaque décision de routage, et une création fraîche arrivant ici sansBRIEF.mdpasse quand même par elle (règle d'ouverture de l'étape de 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 validées par l'utilisateur sont les étapes 0, 3 et 6. Lisez ../hyperframes/references/brief-contract.md avant l'étape 0 — elle 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. Effectuez vous-même chaque étape, sauf l'étape 5 où vous dépêchez un sous-agent par image. Ne placez pas de règles de conception ou de mouvement ici ; elles résident dans le sous-agent de travail d'image, le local ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ de cette compétence, et hyperframes-creative.
Flux de travail : É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 arrêté, et son flow/storyboard dérive 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 préférences mémorisées, mène les questions de cette route (../hyperframes/references/routes/faceless-explainer.md), et renvoie le brief verrouillé. Les demandes de modification sautent tout cela — allez faire la modification.
Initialisez uniquement 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 certaines sont obsolètes.
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 les préférences 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 sautée) et renvoie les squelettes que l'étape 3 ébauche. 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, en cas de déconnexion, comment se connecter. Appliquez une branche :
- Collaborative : attendez que l'utilisateur se connecte ou choisisse explicitement
offline/go. - Autonome : indiquez le statut et continuez avec les moteurs locaux disponibles.
N'omettez pas silencieusement une capacité requise lorsqu'aucun fournisseur hors ligne n'existe ; faites remonter 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 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 de brief § 2) ; le statut de connexion a été affiché (connecté, ou continuation hors ligne).
Étape 1 : Brief (aucune capture)
Objectif : Intégrer le texte de l'utilisateur dans le projet comme source d'information. Il n'y a aucune capture de site web et aucune ressource réelle — il s'agit d'une explicatrice sans visage.
Enregistrez l'entrée complète de l'utilisateur textuellement, puis créez le package de capture synthétique à la main :
capture/extracted/visible-text.txt— l'article / notes / sujet / 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 — ajoutez-les alors (le préréglage de design fournit une palette complète dans tous les cas).
Si l'utilisateur a collé un script ou souhaite que son texte soit conservé, enregistrez-le textuellement comme user_script.txt ; VO_MODE (textuel ou restructuré) vient de BRIEF.md — la couche d'intention le demande quand un script arrive. Demandez une fois ici uniquement si le brief manque, 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 étapes 4-5, pas capturés. La seule exception : si l'utilisateur a fourni une image réelle, placez-la sous public/<nom_de_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'explicatrice en une phrase claire.
Étape 2 : Système de design
Objectif : Choisir un préréglage d'image livré ; un script le transforme en frame.md de cette vidéo + peau de légende.
Lorsque BRIEF.md nomme un style_preset — l'utilisateur l'a choisi visuellement parmi les présentations de la couche d'intention — utilisez-le ; l'appel de jugement vous revient uniquement si le brief est silencieux. Ensuite, faites le seul appel — 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 <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 avec les éventuels 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 ; polices d'affichage et de corps du préréglage remplacées par celles de la marque), copie la peau 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 — aucune édition manuelle de la spécification.
Une explicatrice sans visage n'a généralement pas de couleurs/polices de marque (tokens.json couleurs/polices vides) → le script conserve la palette du préréglage, un design complet livrable. Uniquement lorsque l'utilisateur a nommé des couleurs/polices de marque, ajoutez-les à tokens.json avant d'exécuter, et ajustez frame.md à la main ensuite uniquement si un mappage le nécessite vraiment.
Validation : build-frame.mjs a quitté avec 0 — frame.md existe à partir d'un préréglage nommé, et (lorsque le préréglage en livre une) .hyperframes/caption-skin.html existe comme source de la peau de légende ; le préréglage choisi a été enregistré comme préférence (--key style_preset --workflow <ce flux>, contrat de brief § 2).
Étape 3 : Storyboard et script
Objectif : Transformer le texte en un plan pédagogique 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 ; l'assemblage indique où la coupe se situe par rapport à celle-ci.
Utilisez story-design.md pour la structure de l'explication (concept / tutoriel / listicle / histoire), la stratégie d'accroche, les techniques de clarté, les battements émotionnels, le mappage type-énumération, et VO_MODE. La séquence de la 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 battement, écrivez la voix off dans la forme qu'implique son plan candidat et étiquetez ce candidat blueprint: id lorsqu'il convient. La vérité pédagogique décide toujours quels battements existent — ne forcez jamais un battement à correspondre à un plan, et n'inventez jamais un battement 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 réelle public/<nom_de_base>. Utilisez les champs exacts requis des références du storyboard et du script.
Après l'ébauche, exécutez la passe 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 — approuvez ou modifiez, et d'abord les esquisses (recommandé) ou ignorez. Les retours arrivent par réponse de chat ; bouclez jusqu'à approbation. C'est une validation de point de contrôle (contrat de brief § 1) : en mode autonome, il n'y a rien à demander — publiez le même résumé comme information et continuez ; les esquisses se fondent dans la construction, et l'aperçu final avec sa question unique vient à l'étape 6.
Validation : STORYBOARD.md existe, chaque image a les champs narratifs requis, 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 information).
É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. (Le statut 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 nommait 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éminine) 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 avec le fournisseur sélectionné par le statut de connexion de l'étape 0 : HeyGen (connecté) via node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs --list (ou GET /v3/voices?engine=starfish) ; Kokoro (hors ligne) via le tableau des voix dans <MEDIA_DIR>/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 de brief § 2) avant la valeur par défaut du pipeline, et dites laquelle vous avez utilisée ; omettez --voice uniquement quand aucun des deux n'en nomme une. Lorsque l'utilisateur a explicitement choisi une voix pour cette exécution, enregistrez-la (prefs.mjs record --key voice).
node <SKILL_DIR>/scripts/audio.mjs --script ./SCRIPT.md --storyboard ./STORYBOARD.md --hyperframes . --out ./audio_meta.json --voice <voix-id> &
Le script audio gère la narration, les minutages des mots, la recherche BGM depuis la bibliothèque musicale HeyGen, et les métadonnées de minutage. L'humeur BGM vient du champ music: du storyboard. Cela utilise l'API Audio HeyGen pour la récupération, pas la génération, et le même justificatif ~/.heygen que TTS. Pour les détails du fournisseur, lisez ../media-use/audio/references/tts.md. Lorsque les outils propres de l'application hôte créent la musique ou un effet sonore, mettez le fichier sous assets/ et listez-le dans le fichier audio_meta.json marqué "source": "host" : musique comme bgm { "path": "assets/…", "source": "host" } avec music: none dans le storyboard ; un son comme entrée sfx { "frame": <n>, "file": "assets/…", "offset_s": 0, "duration_s": <sa durée>, "source": "host" }. Chaque passage audio conserve ces éléments, et une image avec un son hôte n'obtient pas de repère recherché.
S'il n'y a pas de narration et pas de SCRIPT.md, sautez la génération vocale. BGM peut toujours s'exécuter si le storyboard a une humeur musicale.
Le marqueur de silence complet canonique (partagé entre les flux de travail qui réutilisent ce modèle audio) : music: none dans le bloc YAML supérieur du STORYBOARD.md, pas de SCRIPT.md, et pas de repères sfx: ni d'audio hôte. Cette combinaison marque le projet comme silencieux—ne générez pas de piste audio ; n'exécutez pas le script audio du tout. Si l'audio est généré et que tout est silencieux par la suite, l'étape 6 respecte ce marqueur pour produire une vidéo silencieuse.