HyperFrames — commencez ici
HyperFrames génère une 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 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 "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 workflow possède un livrable de bout en bout (son propre répertoire de projet, des étapes séquencées, des sous-agents, un artefact final) ; une compétence de domaine est une couche de capacité qu'un workflow utilise en cours de route et ne possède jamais la tâche.
Carte des capacités — les compétences de 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 keyframes seek-safe — timelines GSAP, keyframes CSS, Anime.js, WAAPI, FLIP, chemins, masques, SVG morph/dessiner, profondeur 3D, plus diagnostics hyperframes keyframes | /hyperframes-keyframes |
Direction créative — frame.md / design.md, palettes, typographie, narration, planification de rythme, réactif à l'audio | /hyperframes-creative |
| Médias — résoudre/générer BGM, SFX, image, icône, logo de marque, voix ; voix off TTS, transcription, suppression d'arrière-plan, sous-titres ; réutilisation entre projets | /media-use |
| Boucle de dev CLI — init, lint, valider, inspecter, prévisualiser, rendre, publier, doctor | /hyperframes-cli |
Installer des blocs / composants de registre (hyperframes add) | /hyperframes-registry |
| Importer du contenu Figma — actifs, tokens, composants, storyboards→mouvement reconstruit (REST/CLI) ; Motion (MCP), shaders (source MCP / export natif) | /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 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 actif), 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 ?
Mode — si la demande porte un signal autonome continu ("surprends-moi", "décide pour moi", "construis-le simplement"), notez-le et transmettez-le dans le workflow : l'ensemble de l'exécution devient autonome et aucune étape ultérieure ne repose la question. Sans signal, le workflow demande le mode comme première question de son 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 des spécifications — 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 / intégré / inconnu → 16:9 ; langue de la narration / des sous-titres = celle de l'utilisateur. Le workflow choisi reconfirme ses propres spécificités à sa première étape (sémantique des champs : hyperframes-core → references/brief-contract.md).
Aide-mémoire des workflows
| Workflow | Utilisez-le pour |
|---|---|
/product-launch-video | Vendre un produit (SaaS, application, site entreprise / produit) — à partir d'une URL, d'un brief ou d'un script → une promotion. La valeur par défaut pour toute URL commerciale, même si seul le site est nommé. |
/website-to-video | Montrer un site lui-même — une visite / démonstration construite à partir des propres captures d'écran du site. Pour les sites non commerciaux (portfolio, blog, documentation, personnel, événementiel), ou lorsque l'utilisateur veut une visite, pas une promotion. |
/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 / explicateur de refactorisation |
/embedded-captions | Ajouter des sous-titres / légendes à une vidéo existante avec une personne qui parle (séquence intacte) |
/talking-head-recut | Emballer une vidéo existante avec une personne qui parle avec des superpositions graphiques conçues — tiers inférieurs, appels de données, titres cinétiques, citations en exergue |
/motion-graphics | Une pièce courte (~moins de 10s), sans narration où le mouvement est le message — texte cinétique, un stat / hit de graphique, un logo sting, 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 au rythme — vidéo lyrique, diaporama, ou promotion cinétique ; la musique pilote le rythme (images / vidéos utilisateur optionnelles découpées sur la grille de rythme) |
/slideshow | Une présentation / pitch deck / deck interactif — diapositives discrètes, fragments, branchements, 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 / affiche statique, 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) :
- Axé sur le mouvement et 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 / application / produit / site entreprise) →
/product-launch-video— une promotion, et la valeur par défaut pour toute URL commerciale même si seul le site est nommé. Non, ou l'utilisateur veut simplement que le site soit montré tel quel (portfolio / blog / documentation / personnel / événementiel) →/website-to-video— une visite. Un lien de PR GitHub →/pr-to-video; un concept sans produit ni site →/faceless-explainer. - Séquence existante — sous-titres simples en parole →
/embedded-captions; cartes de superposition conçues →/talking-head-recut. Aucun ne modifie la séquence elle-même (re-timing / recoloration / recadrage / réordonnancement / 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 battements / l'énergie de la musique pilotent le rythme. (Les pièces avec narration restent dans le workflow correspondant à l'entrée ci-dessus ;/motion-graphicsest pour un 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 de "diaporama" procède directement ; un déclencheur adjacent ("deck / slides / présentation / convertir cette page") fait confirmer par/slideshowqu'il s'agit d'un diaporama avant de créer, et bascule vers le workflow non-diaporama approprié si ce n'est pas le cas. - La longueur 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é.
Après avoir choisi — garantissez que le workflow est installé
Une fois que vous avez choisi un workflow, exécutez l'étape de mise à jour avant de lire sa compétence — les compétences de workflow s'installent à la demande, donc celle que vous avez choisie peut ne pas encore être 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-workflow>
Nom simple, sans / au début — par exemple npx hyperframes skills update pr-to-video. Nommer une compétence garantit qu'elle plus les compétences de domaine de base dont dépend chaque workflow sont installées et à jour : un no-op rapide quand tout l'est déjà, une installation ciblée des seules compétences manquantes / obsolètes dans le cas contraire — jamais l'ensemble complet. Ensuite, lisez la compétence du workflow et continuez. La même commande fonctionne pour une compétence de 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 workflow de mémoire. Solution de secours manuelle (pas de CLI HyperFrames disponible) : npx skills add heygen-com/hyperframes --skill <nom-du-workflow> ; tout en une 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 de manière proactive, les workflows lors de leur première utilisation.
- Ensemble de base — ce routeur, les compétences de domaine
hyperframes-*, etmedia-use.npx hyperframes init(que chaque workflow de création exécute lors de l'échafaudage) vérifie GitHub et rafraîchit l'ensemble de base ainsi que tout ce qui est déjà installé. Il n'étend jamais l'installation — les compétences de workflow que vous n'avez pas utilisées ne sont pas téléchargées. Ré-exécuter init sur une machine à jour est un no-op ; hors ligne (ou limité en débit), il se dégrade gracieusement et n'échoue jamais durement. Le drapeau--skip-skillsest actuellement neutralisé (une mesure temporaire pendant que le registre skills.sh rattrape son retard) ; CI/tests se désengagent via la variable d'environnementHYPERFRAMES_SKIP_SKILLS=1. - Compétences de workflow — installées et rafraîchies au moment du déclenchement par l'étape de mise à jour ci-dessus (
skills update <nom-du-workflow>).
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 ; se termine par un code non nul lorsque quelque chose d'installé est obsolète ou que l'ensemble de base est incomplet — les compétences de workflow 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 de workflows 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 workflows
/product-launch-video
- Entrée : Un produit commercialisé — (a) une URL de produit (explorée avec Chrome headless pour les actifs + les tokens de marque), (b) un script / brief qui nomme le site du produit même sans lien (PLV le résout et 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 palette + système de conception). Un script fourni peut être la voix off textuelle ou restructurée par scène — PLV demande.
- Sortie : un lancement de produit / promotion SaaS en tant que composition HyperFrames → MP4 (zone 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", "promotion pour notre site", "explique mon SaaS en une minute", "transforme mon script en promotion de 60s", "vidéo de lancement texte uniquement, n'explore pas".
/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, documentation, personnel, événementiel), ou lorsque l'utilisateur veut explicitement une visite d'un site tel quel. Capturé avec Chrome headless pour des captures d'écran réelles + actifs de marque. Si le site a un objectif commercial clair mais que l'utilisateur insiste pour une visite, honorez la demande explicite.