HyperFrames, commencez ici
HyperFrames génère une 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 accessible par recherche, et dont la lecture multimédia est gérée par le framework. Le contrat d'édition complet se trouve dans /hyperframes-core ; lisez-le avant d'écrire le HTML de la composition.
Ci-dessous : une carte des capacités (les compétences de domaine, chargées à la demande) et le routeur d'intention (choisissez un workflow pour toute demande "crée-moi une vidéo").
Carte des capacités. Les compétences de domaine
Capacités atomiques que vous chargez à la demande : pas des workflows vidéo complets. Pour "crée-moi une vidéo", utilisez le routeur d'intention ci-dessous.
| Vous voulez… | Compétence |
|---|---|
Créer / modifier une composition HTML : le contrat data-*, clips, pistes, sous-compositions, variables | /hyperframes-core |
| Animer : mouvement atomique, plans de scène, transitions, adaptateurs runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Créer des keyframes sûres pour la recherche : timelines GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, chemins, masques, morph/dessin SVG, profondeur 3D, plus les diagnostics hyperframes keyframes | /hyperframes-keyframes |
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 de médias : 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, doctor | /hyperframes-cli |
Installer des blocs/composants du registre (hyperframes add) | /hyperframes-registry |
| Importer du contenu Figma : assets, tokens, composants, storyboards→animatiques (REST/CLI); Motion, shaders (MCP) | /figma |
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 de 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é ("crée une vidéo sur notre truc" sans URL, produit, sujet ou asset), demandez avant d'entrer dans un workflow. S'engager sur 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 ?
Les valeurs par défaut du cahier des charges sont fixes, 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 | Vendre un produit (SaaS, app, site entreprise/produit). Depuis une URL, un brief ou un script → une promo. Le choix par défaut pour toute URL commerciale, même si le site est seulement nommé. |
/website-to-video | Montrer un site lui-même : une visite / démo construite à partir des captures d'écran du site. Pour les sites non commerciaux (portfolio, blog, docs, personnel, événement), ou quand l'utilisateur veut une visite, pas une promo. |
/faceless-explainer | Expliquer un sujet / concept à partir de texte, sans produit, sans URL ; chaque visuel est inventé par LLM |
/pr-to-video | Une PR GitHub / modification de code → changelog / révélation de fonctionnalité / correction / explication de refactorisation |
/embedded-captions | Ajouter des sous-titres / légendes à une vidéo existante avec une personne qui parle (métrage inchangé) |
/talking-head-recut | Emballer une vidéo existante avec une personne qui parle avec des superpositions graphiques conçues : tiers inférieurs, annotations de données, titres cinétiques, citations mises en évidence |
/motion-graphics | Un graphisme animé court, sans narration, centré sur le design : texte cinétique, un hit statistique/chiffre, un logo sting, une superposition de tiers inférieur |
/music-to-video | Une piste musicale → une vidéo synchronisée sur le rythme, vidéo lyrique, diaporama ou promo cinétique ; la musique pilote le rythme (images/vidéos utilisateur optionnelles coupées sur la grille de beats) |
/slideshow | Une présentation / pitch deck / deck interactif : diapositives discrètes, fragments, branchements, points chauds ; la sortie 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) :
- Centré sur le mouvement & sans narration (moins de ~10s, le mouvement est le message) →
/motion-graphics, quel que soit l'entrée. - Une URL ou un script : demandez une chose : le site vend-il un produit ? Oui (SaaS / app / produit / site entreprise) →
/product-launch-video: une promo, et le choix par défaut pour toute URL commerciale même si le site est seulement nommé. Non, ou l'utilisateur veut juste montrer le site tel quel (portfolio / blog / docs / personnel / événement) →/website-to-video: une visite. Un lien de PR GitHub →/pr-to-video; un concept sans produit ni site →/faceless-explainer. - Métrage existant : sous-titres simples de paroles →
/embedded-captions; cartes de superposition conçues →/talking-head-recut. Aucun des deux ne modifie le métrage lui-même (re-timing / recolor / recadrage / réorganisation / audio est un montage NLE, hors périmètre). - Une piste musicale est l'entrée (un fichier audio, ou une vidéo pour en extraire l'audio) sans narration →
/music-to-video: les beats/énergie de la musique pilotent le rythme. (Les pièces narrées restent avec le workflow adapté à l'entrée ci-dessus ;/motion-graphicsest pour le mouvement court non narré qui n'est pas piloté par la musique.) - Une présentation / pitch deck / deck interactif (diapositives discrètes, navigation, mode présentateur) →
/slideshow: la sortie est un deck navigable, pas une vidéo rendue. Une demande explicite de "slideshow" procède directement ; un déclencheur adjacent ("deck / slides / présentation / convertis cette page") fait confirmer par/slideshowqu'il s'agit d'un slideshow avant de créer, et bascule vers le workflow non-slideshow 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-videoseulement quand la pièce est clairement plus longue que ~3 min, ou qu'il s'agit d'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 conjectures, dites à l'utilisateur de l'installer d'abord :
- Juste ce workflow :
npx skills add heygen-com/hyperframes --skill <workflow-name>(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 son exécution, relisez la compétence du workflow et continuez.
Maintenir les compétences à jour
Les compétences HyperFrames sont versionnées. npx hyperframes init vérifie les compétences installées par rapport aux dernières sur GitHub et installe/rafraîchit l'ensemble complet dès que quelque chose est obsolète ou manquant. Ainsi, un projet fraîchement initialisé a toujours l'ensemble complet et le plus récent (et réexécuter init sur un projet à jour ne fait rien). La vérification est un aller-retour rapide vers GitHub ; hors ligne (ou limité par le taux), elle retombe sur l'installation après un court délai d'attente, donc init n'échoue jamais définitivement à cause d'un problème réseau. Les workflows de création génèrent avec init, donc démarrer un nouveau projet exécute toujours cette vérification et récupère nos dernières compétences depuis GitHub lorsqu'elles sont obsolètes. Le drapeau --skip-skills est actuellement neutralisé (une mesure temporaire pendant que le registre skills.sh rattrape son retard) : le passer ne saute plus la vérification, donc chaque init vérifie GitHub. Les tests CI s'excluent via la variable d'environnement HYPERFRAMES_SKIP_SKILLS=1.
Si une tâche se comporte de manière inattendue, ou avant une longue construction, confirmez que les compétences installées sont à jour :
- Vérifier :
npx hyperframes skills check(ajoutez--jsonpour un verdict lisible par machine ; sort avec un code non nul lorsque quelque chose est obsolète ou manquant). - Mettre à jour :
npx hyperframes skills update: récupère l'ensemble complet jusqu'à la dernière version, en installant tout ce qui n'est pas encore présent (comme l'étape d'installation de init).
Le CLI affiche également un rappel d'une ligne lorsqu'une exécution render / lint / validate détecte des compétences obsolètes.
Détails des workflows
/product-launch-video
- Entrée : Un produit commercialisé, (a) une URL de produit (explorée avec Chrome headless pour les assets + les tokens de marque), (b) un script / brief qui nomme le site du produit même sans lien (PLV le résout + l'explore, sauf si l'utilisateur refuse), ou (c) un script sans site dérivable / "ne pas explorer" (mode sans capture, choisissez un préréglage de style qui fournit la palette + le système de design). Un script fourni peut être la voix off textuelle ou restructurée par scène. PLV demande.
- Sortie : une promo de lancement de produit / SaaS sous forme de composition HyperFrames → MP4 (durée idéale 30-90s). La valeur du produit est le sujet, pas une visite guidée du site. Pour une simple visite du site, utilisez
/website-to-video. - Déclencheurs : "vidéo de lancement pour X", "promo pour notre site", "explique mon SaaS en une minute", "transforme mon script en promo de 60s", "vidéo de lancement text-only, ne pas explorer".
/website-to-video
- Entrée : Un site web / URL dont le but est de montrer le site lui-même, pas de vendre un produit. Idéal pour les sites non commerciaux (portfolio, blog, docs, personnel, événement), ou quand l'utilisateur veut explicitement une visite du site tel quel. Capturé avec Chrome headless pour des captures d'écran réelles + des assets de marque. Si le site vend quelque chose et que l'utilisateur veut une promo, utilisez
/product-launch-video. - Sortie : une visite / démonstration / clip social du site construit à partir des visuels propres du site → MP4.
- Déclencheurs : "transforme ce site web en vidéo", "visite du site depuis ", "clip 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és, sans produit commercialisé ni site à capturer. (Issu de
/product-launch-video; pas de Chrome headless.) - Sortie : explicateur sans visage → MP4, chaque visuel est inventé par LLM par scène (typographie / abstrait / diagramme / visualisation de données) ; livre le préréglage
pin-and-paper. (durée idéale 30-90s). - Déclencheurs : "explicateur sans visage sur X", "explique comment fonctionne DNS en vidéo", "transforme cet article en explicateur", "explicateur à partir de mes notes".
/pr-to-video
- Entrée : Une pull request GitHub : une URL de PR, une référence
owner/repo#N, ou "cette PR". Lue via le CLIgh(pas un site à explorer). - Sortie : explicateur de changement de code (changelog / révélation de fonctionnalité / correction / refactorisation) → MP4, surlignages de diff, avant/après, arborescence de fichiers + scènes d'impact. ≤ (durée idéale 30-90s).
- Déclencheurs : "fais une vidéo sur cette PR", "transforme la PR #1187 en vidéo de changelog", "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, du métrage réel, 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.
- Sortie : le même métrage inchangé, avec une couche de sous-titres, Standard (rail textuel en tiers inférieur + un climax intégré derrière le sujet) ou Cinématographique (chaque sous-titre composé derrière le sujet). Toute durée.
- Déclencheurs : "ajoute 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, du métrage réel. Transcrite localement (Whisper). Le clip est lu en entier en dessous, inchangé.
- Sortie : le même métrage avec des cartes de superposition graphiques temporisées : titres cinétiques, tiers inférieurs, annotations de données, citations mises en évidence, panneaux latéraux, incrustation image dans image, synchronisés…