HyperFrames — commencez ici
HyperFrames rend la vidéo à partir d'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, 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 domaine, chargées à la demande) et le routeur d'intention (choisissez un flux de travail pour toute demande « fais-moi un… » — généralement une vidéo, mais aussi un deck navigable ou un port de composition). La répartition est basée sur la propriété, pas sur le type de sortie : un flux de travail possède un livrable de bout en bout (son propre répertoire de projet, étapes contrôlées, sous-agents, artefact final) ; une compétence domaine est une couche de capacité qu'un flux de travail charge en cours de route et ne possède jamais la tâche.
Carte des capacités — les compétences domaine
Capacités atomiques que vous chargez à la demande — pas des workflows complets ; elles ne possèdent jamais la tâche de bout en bout. Pour une intention « fais-moi un… », 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 runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU) | /hyperframes-animation |
Créer des images clés sûres pour la recherche — timelines GSAP, images clés CSS, Anime.js, WAAPI, FLIP, chemins, masques, morphing/dessin SVG, profondeur 3D, plus 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 — résoudre/générer BGM, SFX, image, icône, logo de marque, voix, étalonnage couleur, LUT ; voix off TTS, transcription, suppression d'arrière-plan, sous-titres ; réutilisation entre projets | /media-use |
| Boucle de développement CLI — init, lint, validate, inspect, preview, render, publish, doctor | /hyperframes-cli |
Installer des blocs / composants de registre (hyperframes add) | /hyperframes-registry |
| Importer du contenu Figma — assets, tokens, composants, storyboards → mouvement reconstruit (REST/CLI) ; Motion (MCP), shaders (source MCP / export natif) | /figma |
Routage d'intention — choisissez un flux de travail
Cette section ne connaît que les flux de travail de haut niveau ; elle ne charge pas leurs références internes ni les compétences domaine ci-dessus.
Avant le routage — 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 asset), demandez avant d'entrer dans un flux de travail — s'engager dans un flux de travail 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 de type « talking head » existante ?
- Source Figma — si l'entrée est une URL figma.com,
/figmaextrait d'abord les assets/tokens/(composants/storyboard), quel que soit le flux de travail choisi ci-dessous pour la forme de la vidéo ; ce flux de travail construit ensuite à partir de la sortie de/figma— jamais en pilotant Figma via des outils MCP bruts directement (cela contourne la désinfection SVG, la provenance et la liaison des tokens de marque).
Mode — si la demande porte un signal autonome continu (« surprends-moi », « décide pour moi », « construis-le juste »), notez-le et transmettez-le au flux de travail : toute l'exécution devient autonome et aucune étape ultérieure ne redemande. Sans signal, le flux de travail demande le mode comme première question de brief. Par défaut, c'est collaboratif. (/motion-graphics est autonome par conception.) Sémantique : hyperframes-core → references/brief-contract.md.
Valeurs par défaut du cahier des charges — indiquez, ne demandez pas (elles ne changent jamais la route) : l'aspect dérive de la destination — flux social (X / LinkedIn / Instagram) → carré 1:1 ; TikTok / Reels / Shorts → 9:16 ; YouTube / embed / inconnu → 16:9 ; la langue de la narration / des sous-titres = celle de l'utilisateur. Le flux de travail choisi reconfirme ses propres spécificités à sa première étape (sémantique de champ : hyperframes-core → references/brief-contract.md).
Aide-mémoire des flux de travail
| Flux de travail | Utilisez-le pour |
|---|---|
/product-launch-video | Vendre un produit (SaaS, app, site entreprise/produit) — à partir d'une URL, d'un brief ou d'un script → une promo. 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 — pas de produit, pas d'URL ; chaque visuel est inventé par LLM |
/pr-to-video | Une PR GitHub / modification de code → changelog / révélation de fonctionnalité / correctif / explication de refactorisation |
/embedded-captions | Ajouter des sous-titres / légendes à une vidéo existante de type « talking head » (métrage non modifié) |
/talking-head-recut | Emballer une vidéo existante de type « talking head » avec des superpositions graphiques conçues — tiers inférieurs, appels de données, titres cinétiques, citations en exergue |
/motion-graphics | Un court métrage (~moins de 10s), sans narration où le mouvement est le message — typographie cinétique, un hit de statistique/graphique, un sting de logo, une carte animée, un tweet/titre animé, un tiers inférieur / superposition autonome (MP4 ou alpha transparent) |
/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, embranchements, zones interactives ; 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 confondant) :
- Mouvement d'abord & 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 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 PR GitHub →/pr-to-video; un concept sans produit ni site →/faceless-explainer. - Métrage existant — sous-titres simples de parole →
/embedded-captions; cartes de superposition conçues →/talking-head-recut. Aucun des deux ne modifie le métrage lui-même (re-timing / recolor / reframe / reorder / audio est un montage NLE — hors de portée). - Une piste musicale est l'entrée (un fichier audio, ou une vidéo pour en extraire l'audio) avec aucune narration →
/music-to-video— les beats/l'énergie de la musique pilotent le rythme. (Les pièces avec narration restent avec le flux de travail correspondant à l'entrée ci-dessus ;/motion-graphicsest pour le mouvement court sans narration 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 « slideshow » va directement ; un déclencheur adjacent (« deck / slides / presentation / convert this page ») fait confirmer à/slideshowqu'il s'agit bien d'un slideshow avant la création, et bascule vers le flux de travail non-slideshow approprié si ce n'est pas le cas. - La durée est un guide, pas une barrière — l'intention choisit le flux de travail ; allez dans
/general-videouniquement lorsque la pièce est clairement plus longue que ~3 min, ou est un format statique / boucle / personnalisé.
Après le choix — garantissez que le flux de travail est installé
Une fois que vous avez choisi un flux de travail, exécutez l'étape de mise à jour avant de lire sa compétence — les compétences de flux de travail s'installent à la demande, donc celle que vous avez sélectionnée peut ne pas être encore sur cette machine (ses phrases de déclenchement vivent dans ce routeur précisément pour que vous puissiez router vers des compétences qui ne sont pas installées) :
npx hyperframes skills update <nom-du-flux-de-travail>
Nom nu, sans le / de début — par exemple npx hyperframes skills update pr-to-video. Nommer une compétence garantit qu'elle plus les compétences domaine de base dont chaque flux de travail dépend sont installées et à jour : une opération rapide sans effet quand tout est déjà à jour, une installation ciblée des seules compétences manquantes/obsolètes quand ce n'est pas le cas — jamais l'ensemble complet. Ensuite, lisez la compétence du flux de travail et continuez. La même commande fonctionne pour une compétence domaine à la demande de la carte des capacités (par exemple npx hyperframes skills update figma).
Si la commande échoue, affichez son erreur à l'utilisateur au lieu d'improviser le flux de travail de mémoire. Solution de secours manuelle (pas de CLI HyperFrames disponible) : npx skills add heygen-com/hyperframes --skill <nom-du-flux-de-travail> ; tout à la fois : npx skills add heygen-com/hyperframes --all.
Maintenir les compétences à jour
Les compétences HyperFrames sont versionnées et s'installent paresseusement : l'ensemble de base avec empressement, les flux de travail lors de la première utilisation.
- Ensemble de base — ce routeur, les compétences domaine
hyperframes-*, etmedia-use.npx hyperframes init(que chaque flux de travail de création exécute lors de l'initialisation) vérifie GitHub et rafraîchit l'ensemble de base plus tout ce qui est déjà installé. Il n'étend jamais l'installation — les compétences de flux de travail que vous n'avez pas utilisées ne sont pas récupérées. Réexécuter init sur une machine à jour est sans effet ; hors ligne (ou limité en taux) il se dégrade gracieusement et n'échoue jamais durement. Le flag--skip-skillsest actuellement neutralisé (une mesure temporaire pendant que le registre skills.sh rattrape son retard) ; les CI/tests se désinscrivent via la variable d'environnementHYPERFRAMES_SKIP_SKILLS=1. - Compétences de flux de travail — installées et rafraîchies au moment du déclenchement par l'étape de mise à jour ci-dessus (
skills update <nom-du-flux-de-travail>).
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 d'installé est obsolète ou que l'ensemble de base est incomplet — les compétences de flux de travail pas encore installées sont signalées comme disponibles à la demande, pas comme un échec). - Mettre à jour :
npx hyperframes skills update— rafraîchit l'ensemble de base plus tout ce qui est installé vers la dernière version, et supprime les compétences qui ne sont plus publiées. Sans noms, il n'installe jamais les flux de travail que vous n'avez pas utilisés ; nommer des compétences (skills update <nom…>) les installe en plus. - Ensemble complet, explicitement :
npx hyperframes skills(ounpx skills add heygen-com/hyperframes --all).
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 flux de travail
/product-launch-video
- Entrée : Un produit en cours de commercialisation — (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 se désengage), ou (c) un script sans site dérivable / « ne pas explorer » (mode sans capture — choisissez un preset de style qui fournit palette + système de design). Un script fourni peut être la voice-over textuelle ou restructuré par scène — PLV demande.
- Sortie : une promo de lancement de produit / SaaS en tant que composition HyperFrames → MP4 (point idéal 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 de notre site », « explique mon SaaS en une minute », « transforme mon script en une promo de 60s », « texte…
…[tronqué pour la traduction]