Installations du plugin : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution des plugins lorsque ce skill est intégré à un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Tout d'abord, gardez ce skill à 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, il rafraîchit ce skill ainsi que les skills de domaine principaux dont il dépend avant de vous y fier.
media-use : Avant d'utiliser des sources audio/images/logos, appelez
/media-usepour résoudre BGM/SFX/images à partir du catalogue HeyGen et les logos de marque à partir de leurs sources officielles. Exécutez d'abord--adoptpour enregistrer les actifs existants. Voir le skill/media-use.
Explainer sans visage vers HyperFrames
Utilisez ce skill pour transformer un corps 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 d'actifs réel.
La porte d'entrée est
/hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez son point de contrôle, et seulement ensuite continuez. Ce skill est destiné à expliquer un sujet à partir de texte, sans produit et sans site web à capturer. Toute autre intention, un simple "crée une vidéo" ou toute incertitude → lisez d'abord/hyperframes— la couche d'intention possède chaque décision de route, et une création fraîche arrivant ici sansBRIEF.mdpasse de toute façon par celle-ci (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 point de contrôle avant de continuer. Les étapes contrôlées par l'utilisateur sont l'étape 0, l'étape 3 et l'étape 6. Lisez ../hyperframes/references/brief-contract.md avant l'étape 0 — elle définit les types de points de contrôle et comment flow/storyboard de BRIEF.md dérivent le mode qui régit les points de contrôle des étapes 3/4/6. Faites chaque étape vous-même sauf l'étape 5, où vous déléguez un sous-agent par frame. Ne mettez pas de règles de design ou de mouvement ici ; elles vivent dans le sous-agent de travail des frames, les ../hyperframes-animation/rules/ + ../hyperframes-animation/blueprints/ locales de ce skill, 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 frames → 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 posez aucune question — le brief est réglé, et ses flow/storyboard dérivent le mode (contrat de brief § 1). (2) Pas de BRIEF.md mais le projet existe (hyperframes.json / STORYBOARD.md sur 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 directement ici → 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/faceless-explainer.md), et rend le brief verrouillé. Les demandes de modification ignorent tout cela — allez faire la modification.
Initialisez uniquement si hyperframes.json est manquant. Nommez <projet> à partir du sujet en kebab-case, par exemple compound-interest-explained ; 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 que les skills installés sont à jour par rapport à la dernière version sur GitHub et met à jour l'ensemble global si certains sont obsolètes.
Après init, laissez <PROJET_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 <PROJET_ROOT> ; n'écrivez jamais .media, capture, ou les 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é de la couche d'intention, format selon ../hyperframes/references/brief-format.md. Résolvez <MEDIA_DIR> comme le répertoire installé du skill /media-use. 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 sa 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 points de contrôle de révision s'exécutent toujours.
Affichez l'état 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 des moteurs locaux et, en cas de déconnexion, comment se connecter. Appliquez une branche :
- Collaboratif : attendez que l'utilisateur se connecte ou choisisse explicitement
offline/go. - Autonome : indiquez l'état et continuez avec les moteurs locaux disponibles.
N'omettez pas silencieusement une capacité requise lorsqu'aucun fournisseur hors ligne n'existe ; mettez en évidence le blocage. Ne combinez pas cette décision avec 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.
Point de contrôle : hyperframes.json et BRIEF.md existent ; les réponses basées sur les préférences ont été enregistrées (contrat de 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 comme source d'information. Il n'y a pas de capture de site web et pas d'actifs réels — il s'agit d'un explainer sans visage.
Sauvegardez l'entrée complète de l'utilisateur textuellement, puis créez le package de capture synthétique manuellement :
capture/extracted/visible-text.txt— l'article / les notes / le sujet / le brief complets, textuellement. C'est la source d'information, pas un modèle de récit (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 de toute façon).
Si l'utilisateur a collé un script ou souhaite que son texte soit conservé, sauvegardez-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 seule fois ici seulement 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.
Point de contrôle : capture/extracted/visible-text.txt et capture/extracted/tokens.json existent ; vous pouvez énoncer le sujet et le public de l'explainer en une phrase claire.
Étape 2 : Système de design
Objectif : Choisir un préréglage de frame livré ; un script le transforme en frame.md + skin de sous-titres de cette vidéo.
Lorsque BRIEF.md nomme un style_preset — l'utilisateur l'a choisi visuellement à partir des démos de la couche d'intention — utilisez-le ; la décision vous incombe 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 parcourez ../hyperframes-creative/frame-presets/ ; choisissez le préréglage dont l'apparence correspond le mieux au sujet, au ton et au public. Puis exécutez :
node <SKILL_DIR>/scripts/build-frame.mjs --preset <nom> --hyperframes .
Le script fait le reste de manière déterministe : copie FRAME.md du préréglage vers frame.md et le remixe avec 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 et de corps du préréglage échangées contre celles de la marque), copie le skin de sous-titres du préréglage vers .hyperframes/caption-skin.html, et s'auto-valide (sortie 1 en cas de mapping cassé). Continuez dès qu'il sort avec 0 — pas d'édition manuelle de la spécification.
Un explainer 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 livrable. Uniquement lorsque l'utilisateur a nommé des couleurs/polices de marque, ajoutez-les à tokens.json avant d'exécuter, et ajustez frame.md manuellement après seulement si un mapping le nécessite vraiment.
Point de contrôle : 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 sous-titres ; 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 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 duration: du frontmatter à partir du length du brief — une attente approximative ; l'assemblage rapporte où la coupe atterrit par rapport à celle-ci.
Utilisez story-design.md pour la structure de l'explainer (concept / tutoriel / listicle / histoire), la stratégie d'accroche, les techniques de clarté, les battements émotionnels, le mapping d'énumération de type 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. Comme guide souple, consultez le menu rôle→blueprint dans ../hyperframes-animation/blueprints-index.md : pour chaque battement, écrivez la voix off dans la forme qu'implique le blueprint candidat et étiquetez cet identifiant blueprint: candidat lorsqu'il correspond. La vérité pédagogique décide toujours quels battements existent — ne forcez jamais un battement à correspondre à un blueprint, 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 frames ne portent pas d'inventaire d'actifs : laissez asset_candidates vide sauf si l'utilisateur a fourni une image public/<nom_de_base> réelle. Utilisez les champs exacts requis des références de storyboard et de script.
Après la rédaction, 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 — approuver ou modifier, et d'abord les esquisses (recommandé) ou passer. Les commentaires arrivent sous forme de réponse de chat ; bouclez jusqu'à approbation. C'est un point de contrôle de vérification (contrat de brief § 1) : en mode autonome, il n'y a rien à demander — publiez le même résumé comme un avertissement et continuez ; les esquisses se fondent dans la construction, et l'aperçu final avec sa question unique arrive à l'étape 6.
Point de contrôle : STORYBOARD.md existe, chaque frame 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 avertissement).
Étape 3.1 : Audio
Objectif : Générer la narration, les timings des mots, la musique et les métadonnées audio à partir du script approuvé.
Démarrez 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 revient automatiquement au mode hors ligne.)
Choisissez la voix de narration en fonction 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éminine) sur HeyGen / am_michael sur Kokoro — donc une demande comme "une voix masculine" est silencieusement ignorée sauf si vous passez le drapeau. Les identifiants de voix sont spécifiques au fournisseur ; résolvez par rapport au fournisseur que l'étape 0 a sélectionné via l'état de connexion : HeyGen (connecté) via node <MEDIA_DIR>/audio/scripts/heygen-tts.mjs -- list (ou GET /v3/voices?engine=starfish) ; Kokoro (hors ligne) via la table 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 lorsqu'aucune 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 <SKILL_DIR>/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 timings des mots, la recherche BGM à partir de la bibliothèque musicale de HeyGen et les métadonnées de timing. 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 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. Le BGM peut toujours s'exécuter si le storyboard a une ambiance musicale.
Le marqueur canonique de silence total (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 l'assemblage traite comme silencieux), donc cette étape est une simple saut. music: none avec narration conserve TTS et désactive uniquement le BGM. Utilisez exactement cette orthographe — n'improvisez pas d'autres marqueurs.
Point de contrôle : le travail audio a démarré, ou le projet est marqué comme silencieux (music: none + pas de SCRIPT.md).
Étape 4 : Conception visuelle des frames
Objectif : Ajouter la direction visuelle, l'intention de mise en page et les choix de mouvement à chaque frame du storyboard.
**Esquissez la feuille de storyboard...