HyperFrames — commencez ici
HyperFrames rend la vidéo à partir de HTML — une composition est un fichier HTML dont le DOM déclare le timing avec des attributs data-*, dont le runtime d'animation est interrogeable, et dont la lecture multimédia est gérée par le framework. Le contrat de création complet se trouve dans /hyperframes-core ; lisez-le avant d'écrire du HTML de composition.
Ci-dessous : une carte des capacités (les compétences du domaine, chargées à la demande) et le routeur d'intention (choisissez un workflow pour toute demande "fais-moi une vidéo").
Carte des capacités — les compétences du domaine
Capacités atomiques que vous chargez à la demande — pas des workflows vidéo complets. Pour "fais-moi une vidéo", utilisez le routeur d'intention ci-dessous.
| Vous voulez… | Compétence |
|---|---|
Créer / éditer une composition HTML — le contrat data-*, clips, pistes, sous-compositions, variables | /hyperframes-core |
| Animer — mouvement atomique, plans de scène, transitions, adaptateurs d'exécution (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Direction créative — frame.md / design.md, palettes, typographie, narration, planification des beats, audio-réactif | /hyperframes-creative |
| Média — voix off TTS, musique de fond, transcription, suppression d'arrière-plan, sous-titres | /hyperframes-media |
Résolution média — trouver + figer BGM, SFX, images, icônes du catalogue HeyGen dans .media/ avec suivi du manifeste | /media-use |
| Boucle de développement CLI — init, lint, valider, inspecter, prévisualiser, rendre, publier, docteur | /hyperframes-cli |
Installer des blocs / composants du registre (hyperframes add) | /hyperframes-registry |
Routage d'intention — choisissez un workflow
Cette section ne connaît que les workflows de haut niveau ; elle ne charge pas leurs références internes ni les compétences du domaine ci-dessus.
Avant de router — confirmez l'entrée, pas le cahier des charges
Le routage a besoin de savoir de quoi parle la vidéo — son entrée et son sujet. Si ce n'est pas spécifié ("fais une vidéo sur notre truc" sans URL, produit, sujet ou élément), demandez avant d'entrer dans un workflow — s'engager dans un workflow EST la décision de routage. Au maximum deux questions :
- Entrée — un produit (URL / brief), un site Web général, une PR GitHub, un sujet à expliquer, ou une vidéo existante avec une personne qui parle ?
Valeurs par défaut des spécifications — indiquez, ne demandez pas (elles ne changent jamais la route) : format 16:9 (utilisez 9:16 uniquement pour une destination verticale nommée — TikTok / Reels / Shorts) ; langue de la narration / des sous-titres = celle de l'utilisateur. Le workflow choisi reconfirme ses propres spécificités à sa première étape.
Aide-mémoire des workflows
| Workflow | Utilisez-le pour |
|---|---|
/product-launch-video | Commercialiser / lancer / promouvoir un produit — à partir de son URL, d'un brief ou d'un script (même si le site est seulement nommé) |
/website-to-video | Transformer un site Web général en vidéo — visite du site, présentation du portfolio / de la page d'accueil, extrait social à partir des visuels du site |
/faceless-explainer | Expliquer un sujet / concept à partir d'un texte — pas de produit, pas d'URL ; chaque visuel est inventé par LLM |
/pr-to-video | Une PR GitHub / modification de code → journal des modifications / révélation de fonctionnalité / correctif / explication de refactorisation |
/embedded-captions | Ajouter des sous-titres / légendes à une vidéo existante avec une personne qui parle (images intactes) |
/talking-head-recut | Emballer une vidéo existante avec une personne qui parle avec des incrustations graphiques conçues — tiers inférieurs, encadrés de données, titres cinétiques, citations en exergue |
/motion-graphics | Un graphique animé court, sans narration, axé sur le design — typographie cinétique, une statistique / un hit de graphique, un logo sting, une incrustation de tiers inférieur |
/music-to-video | Une piste musicale → une vidéo synchronisée sur le beat — vidéo lyrique, diaporama ou promotion cinétique ; la musique pilote le rythme (images / vidéos fournies par l'utilisateur, facultatives, coupées sur la grille de beat) |
/slideshow | Une présentation / pitch deck / deck interactif — diapositives discrètes, fragments, branchements, points chauds ; le résultat est un deck navigable, pas une vidéo rendue |
/general-video | Tout le reste — pièces plus longues ou multi-scènes, une boucle statique / affiche, une composition personnalisée |
/remotion-to-hyperframes | Porter une composition Remotion (React) existante vers HyperFrames (migration, pas création) |
Désambiguïsation (uniquement là où c'est confus) :
- Motion-first & sans narration (moins de ~10s, le mouvement est le message) →
/motion-graphics, quel que soit le type d'entrée. - Une URL ou un script — commercialise un produit spécifique (même en nommant simplement le site) →
/product-launch-video; un site général non produit →/website-to-video; un lien de PR GitHub →/pr-to-video; explique un concept sans produit / site →/faceless-explainer. En cas de réelle confusion produit-vs-sujet, ou lancement-vs-site général → posez une question. - Média existant — sous-titres simples de parole →
/embedded-captions; cartes d'incrustation conçues →/talking-head-recut. Aucun des deux ne modifie le média lui-même (re-timing / recoloriser / recadrer / réordonner / audio relève du montage NLE — hors de portée). - Une piste musicale est l'entrée (un fichier audio, ou une vidéo dont extraire l'audio) avec aucune narration →
/music-to-video— les beats/l'énergie de la musique pilotent le rythme. (Les pièces narrées restent avec le workflow correspondant à l'entrée ci-dessus ;/motion-graphicsest pour les animations courtes sans narration qui ne sont pas pilotées par la musique.) - Une présentation / pitch deck / deck interactif (diapositives discrètes, navigation, mode présentateur) →
/slideshow— le résultat est un deck navigable, pas une vidéo rendue. Une demande explicite de "diaporama" va directement ; un déclencheur adjacent ("deck / diapositives / présentation / convertir cette page") fait confirmer à/slideshowqu'il s'agit bien d'un diaporama avant la création, et passer au workflow non-diaporama approprié si ce n'est pas le cas. - La durée est un guide, pas une barrière — l'intention choisit le workflow ; allez vers
/general-videouniquement lorsque la pièce est clairement plus longue que ~3 min, ou est un format statique / boucle / personnalisé.
Si le workflow correspondant n'est pas installé
Une fois que vous avez choisi un workflow, vérifiez qu'il vous est réellement disponible. Si la compétence du workflow correspondant n'est pas installée, ne retombez pas sur des suppositions — dites à l'utilisateur de l'installer d'abord :
- Juste ce workflow :
npx skills add heygen-com/hyperframes --skill <nom-du-workflow>(par ex.--skill pr-to-video— nom simple, sans/au début). - Tous les workflows à la fois :
npx skills add heygen-com/hyperframes --all(core + chaque workflow, ignore le sélecteur).
Après l'avoir exécuté, relisez la compétence du workflow et continuez.
Détails des workflows
/product-launch-video
- Entrée : Un produit commercialisé — (a) une URL de produit (explorée avec Chrome headless pour les éléments + jetons de marque), (b) un script / brief qui nomme le site du produit même sans lien (PLV le résout + l'explore, à moins que l'utilisateur ne refuse), ou (c) un script sans site dérivable / "ne pas scraper" (mode sans capture — choisissez un preset de style qui fournit palette + système de design). Un script fourni peut être la voix off textuelle ou restructurée par scène — PLV demande.
- Résultat : lancement de produit / promotion SaaS en tant que composition HyperFrames → MP4. (point idéal 30–90s).
- Déclencheurs : "vidéo de lancement pour X", "promo pour notre site", "explique mon SaaS en une minute", "transforme mon script en une promo de 60s", "vidéo de lancement texte seul, ne scrape pas".
/website-to-video
- Entrée : Un site Web / URL général à transformer en vidéo — lorsque l'objectif est une vidéo du site, pas un lancement de produit. Capturé avec Chrome headless pour des captures d'écran réelles + éléments de marque.
- Résultat : une visite du site / portfolio / présentation de page d'accueil / extrait social construit à partir des visuels propres du site → MP4.
- Déclencheurs : "transforme ce site Web en vidéo", "visite du site depuis ", "extrait social depuis notre page d'accueil", "j'ai juste une URL — fais quelque chose".
/faceless-explainer
- Entrée : Texte arbitraire — un sujet, un article ou des notes — expliqué, sans produit commercialisé ni site à capturer. (Issu de
/product-launch-video; pas de Chrome headless.) - Résultat : explication sans visage → MP4, chaque visuel inventé par LLM par scène (typographie / abstrait / diagramme / dataviz) ; livre le preset
pin-and-paper. (point idéal 30–90s). - Déclencheurs : "explication sans visage sur X", "explique comment fonctionne DNS en vidéo", "transforme cet article en explication", "explication à partir de mes notes".
/pr-to-video
- Entrée : Une pull request GitHub — une URL de PR, une référence
propriétaire/dépôt#N, ou "cette PR" — lue via la CLIgh(pas un site à scraper). - Résultat : explication de modification de code (journal des modifications / révélation de fonctionnalité / correctif / refactorisation) → MP4 — surlignage des diffs, avant/après, arborescence de fichiers + scènes d'impact. ≤ (point idéal 30–90s).
- Déclencheurs : "fais une vidéo sur cette PR", "transforme la PR #1187 en vidéo de journal des modifications", "vidéo de notes de version depuis github.com/org/repo/pull/123".
/embedded-captions
- Entrée : Une vidéo existante avec une personne qui parle (MP4) à sous-titrer — vidéo réelle, pas une URL ou un brief. Transcrite localement (Whisper, pas de clé API) et matée (RVM) pour que le sujet puisse masquer les sous-titres.
- Résultat : la même vidéo intacte, avec une couche de sous-titres — Standard (bandeau textuel en tiers inférieur + un point culminant incrusté derrière le sujet) ou Cinématographique (chaque sous-titre composé derrière le sujet). Toute durée.
- Déclencheurs : "ajouter des sous-titres / légendes à cette vidéo", "sous-titres derrière le sujet", "sous-titres cinématographiques pour mon clip".
/talking-head-recut
- Entrée : Une vidéo existante avec une personne qui parle / interview / podcast (MP4) à emballer avec des graphiques à l'écran — vidéo réelle. Transcrite localement (Whisper). Le clip est lu en entier en dessous, intact.
- Résultat : la même vidéo avec des cartes d'incrustation graphiques synchronisées — titres cinétiques, tiers inférieurs, encadrés de données, citations en exergue, panneaux latéraux, incrustation d'image dans l'image — synchronisées avec la transcription. Toute durée.
- Déclencheurs : "emballe cette vidéo", "ajoute des incrustations graphiques / tiers inférieurs / encadrés de données à mon talk", "transforme cette interview en un montage emballé graphiquement".
/motion-graphics
- Entrée : Un graphique animé court, axé sur le design, où le mouvement est le message — généralement moins de ~10s, sans narration. Genres : typographie cinétique, un décompte de statistique / nombre, un hit de graphique, un logo sting, un tiers inférieur / incrustation, ou une page / tweet / titre de une piloté par recherche.
- Résultat : un graphique animé court → MP4 ou une incrustation transparente (alpha WebM / MOV) pour un tiers inférieur / encadré.
- Déclencheurs : "un logo sting de 8s", "anime cette statistique", "une intro en typographie cinétique", "transforme ce tweet en graphique animé", "une incrustation transparente de tiers inférieur".
/music-to-video
- Entrée : Une piste musicale — un fichier audio, ou une vidéo dont extraire l'audio — avec aucune narration et aucune capture de site Web. Facultativement, des images / vidéos fournies par l'utilisateur à intégrer. La piste est analysée une fois en une carte de beats / énergie déterministe (
audiomap.json) sur laquelle toute la vidéo est construite. - Résultat : une composition HyperFrames synchronisée sur le beat → MP4 où la musique pilote le rythme. La typographie et les modèles sont le socle (une vidéo complète n'a besoin d'aucun élément) ; tout média fourni est coupé sur la même grille de beat (beat-cut / ken-burns). Le genre — vidéo lyrique, diaporama, promotion cinétique — émerge des choix par image ; le pipeline ne bifurque jamais dessus.
- Déclencheurs : "fais une vidéo pour cette chanson", "vidéo synchronisée sur le beat à partir de cette piste", "vidéo lyrique", "transforme cette musique en vidéo", "visualiseur musical / promotion cinétique sur ce beat".
/slideshow
- Entrée : Une présentation / pitch deck / deck interactif à créer — un brief, un plan, ou une page existante à convertir en diapositives. Pas une demande de vidéo rendue ; si l'intention est ambiguë, la compétence confirme "voulez-vous cela en tant que diaporama HyperFrames ?" avant de créer.
- Résultat : une composition HyperFrames exécutable + une île JSON que le
SlideshowControllerdu lecteur lit pour transformer la timeline GSAP en un deck navigable — diapositives discrètes, révélations de fragments, séquences de branchement, navigation par points chauds, mode présentateur, et notes de l'orateur. Le livrable est un deck, pas un MP4. - Déclencheurs : "fais un pitch deck / une présentation / un diaporama", "un deck interactif", "convertit cette page en diapositives", "un diaporama avec mode présentateur".
/general-video
- Entrée : Tout ce qui n'est pas ci-dessus — un brief créatif, un seul élément à animer, une modification d'une composition que vous construisez. Indépendant de l'entrée et de la durée.
- Résultat : une composition HyperFrames (toute durée / format) via le flux original : système de design → expansion de prompt → plan → mise en page avant animation → construction (délégation aux compétences
hyperframes-*) → validation → rendu.
/remotion-to-hyperframes
- Entrée : Un projet / composition Remotion existant — un répertoire ou une URL de dépôt.
- Résultat : un projet HyperFrames structurellement équivalent (HTML + CSS + JS) qui reproduit l'effet visuel, le timing et la logique interactive de la composition Remotion d'origine.