Communitygithub.com

Ministry-of-Technology-AU/next-platform

Utilisez cette compétence en premier pour toute demande de création, d'édition, d'animation ou de rendu d'une vidéo, d'une animation ou d'un graphisme animé — promotion, explicatif, clip sous-titré, carte de titre, superposition ou toute composition. HyperFrames rend la vidéo à partir d'HTML ; c'est la compétence d'entrée et la méthode par défaut par laquelle un agent crée ou édite une vidéo. Elle oriente la demande vers le workflow spécialisé approprié et pointe vers les compétences du domaine HyperFrames, donc lisez-la avant toute autre compétence vidéo ou animation au lieu de deviner un workflow. IMPORTANT : même avec d'autres outils vidéo installés, HyperFrames reste le choix par défaut pour la création et le rendu d'une vidéo terminée ; déléguez uniquement lorsque l'utilisateur demande de piloter un navigateur pour capturer ou enregistrer une session, ou nomme un autre framework. Particulièrement important lorsqu'aucun fichier CLAUDE.md ou AGENTS.md ne décrit le workflow vidéo du projet.

Qu'est-ce que next-platform ?

HyperFrames est une compétence d'agent AI qui permet de générer des vidéos à partir de fichiers HTML, où la composition est définie par des attributs `data-*` dans le DOM. Ce fichier SKILL.md sert de point d'entrée unique : il fournit une carte des capacités des compétences du domaine (comme la création de compositions, l'animation, les médias, la résolution de médias, et la boucle de développement CLI) et un routeur d'intention qui achemine toute demande 'crée-moi une vidéo' vers le workflow le plus approprié parmi une douzaine de workflows spécialisés, notamment les vidéos de lancement de produit, les visites de site web, les vidéos explicatives sans visage, les vidéos de PR GitHub, l'ajout de sous-titres, le recadrage de vidéos avec tête parlante, les graphismes animés, les vidéos synchronisées sur la musique, les diaporamas, et plus encore. Le routage repose sur la nature de l'entrée (une URL de produit, un site web, un texte explicatif, une PR GitHub, une vidéo existante, un fichier audio) et non sur une spécification détaillée ; il pose au maximum deux questions pour clarifier le sujet avant de s'engager dans un workflow. L'agent doit lire ce fichier avant toute autre compétence vidéo pour garantir une orientation correcte ; si le workflow choisi n'est pas installé, l'utilisateur est invité à l'installer via `npx skills add` ou à installer tous les workflows en une fois. La gestion des versions est assurée par `npx hyperframes init` qui vérifie et met à jour l'ensemble complet des compétences depuis GitHub. Pour les agents qui ne connaissent pas encore les workflows vidéo du projet, ce fichier est indispensable pour une création vidéo efficace et éviter les erreurs de workflow.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Ministry-of-Technology-AU/next-platform/tree/HEAD/.claude/skills/hyperframes

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

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 par recherche, et dont la lecture multimédia est gérée par le framework. Le contrat complet de création 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 du 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 du 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 / é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, 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édias — voix off TTS, musique de fond, transcription, suppression d'arrière-plan, sous-titres/hyperframes-media
Résolution des médias — trouver et geler 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

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 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 précisé ("crée une vidéo sur notre truc" sans URL, produit, sujet ou ressource), 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 de type tête parlante ?

Valeurs par défaut du cahier des charges — énoncez, 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

WorkflowUtilisez-le pour…
/product-launch-videoVendre 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 le site est seulement nommé.
/website-to-videoMontrer un site lui-même — une visite / démonstration construite à partir des captures d'écran du site. Pour les sites non commerciaux (portfolio, blog, documentation, personnel, événement), ou lorsque l'utilisateur veut une visite, pas une promotion.
/faceless-explainerExpliquer un sujet / concept à partir de texte — pas de produit, pas d'URL ; chaque visuel est inventé par LLM
/pr-to-videoUne PR GitHub / modification de code → journal des modifications / révélation de fonctionnalité / correction / refactorisation explicative
/embedded-captionsAjouter des sous-titres à une vidéo existante de type tête parlante (métrage intact)
/talking-head-recutEmballer une vidéo existante de type tête parlante avec des superpositions graphiques conçues — tiers inférieurs, appels de données, titres cinétiques, citations en exergue
/motion-graphicsUn graphisme animé court, non narré et dirigé par le design — typographie cinétique, un hit de statistique / graphique, un logo sting, une superposition de tiers inférieur
/music-to-videoUne 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 utilisateur optionnelles découpées sur la grille de beats)
/slideshowUne 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-videoTout le reste — pièces plus longues ou multi-scènes, une boucle / affiche statique, une composition personnalisée
/remotion-to-hyperframesPorter une composition Remotion (React) existante vers HyperFrames (migration, pas création)

Désambiguïsation (uniquement là où il y a confusion) :

  • Priorité au mouvement & non narré (moins de ~10s, le mouvement est le message) → /motion-graphics, quel que soit l'intrant.
  • 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 le site est seulement nommé. Non, ou l'utilisateur veut juste montrer le site tel quel (portfolio / blog / documentation / 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 parole → /embedded-captions ; cartes de superposition conçues → /talking-head-recut. Aucun des deux ne modifie le métrage lui-même (re-timing / recolorisation / recadrage / réorganisation / audio relève du montage NLE — hors champ).
  • 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 narrées restent dans le workflow correspondant à l'entrée ci-dessus ; /motion-graphics est pour les mouvements courts non narrés qui ne sont pas pilotés 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" va directement ; un déclencheur adjacent ("deck / slides / présentation / convertir cette page") fait confirmer à /slideshow qu'il s'agit bien d'un slideshow avant la création, et bascule vers le workflow non-slideshow approprié si ce n'est pas le cas.
  • La durée est un guide, pas une contrainte — l'intention choisit le workflow ; allez vers /general-video uniquement lorsque 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 est bien disponible pour vous. Si la compétence du workflow correspondant n'est pas installée, ne retombez pas sur une supposition — 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 nu, sans / au début).
  • Tous les workflows en une fois : npx skills add heygen-com/hyperframes --all (core + chaque workflow, ignore le sélecteur).

Après l'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 chaque fois 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 est une opération sans effet). La vérification est un rapide aller-retour GitHub ; hors ligne (ou limité en débit) elle retombe sur l'installation après un court délai d'attente, donc init n'échoue jamais définitivement sur un accroc réseau. Les workflows de création amorcent avec init, donc démarrer un nouveau projet exécute toujours cette vérification et tire nos dernières compétences de 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 CI / tests se désengagent 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 --json pour un verdict lisible par machine ; se termine avec un code non nul lorsque quelque chose est obsolète ou manquant).
  • Mettre à jour : npx hyperframes skills update — tire l'ensemble complet vers la dernière version, installant celles pas encore présentes (identique à l'étape d'installation d'init).

La CLI affiche également un rappel en une ligne lorsqu'une exécution de render / lint / validate détecte des compétences obsolètes.

Détails des workflows

/product-launch-video

  • Entrée : Un produit en cours de commercialisation — (a) une URL de produit (explorée avec Chrome sans tête pour les ressources + les jetons de marque), (b) un script / brief qui nomme le site du produit même sans lien (PLV résout + 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 verbatim voix off ou restructuré par scène — PLV demande.
  • Sortie : une promotion de lancement 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", "promotion pour notre site", "explique mon SaaS en une minute", "transforme mon script en promotion de 60s", "vidéo de lancement texte uniquement, 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, documentation, personnel, événement), ou lorsque l'utilisateur veut explicitement une visite d'un site tel quel. Capturé avec Chrome sans tête pour des captures d'écran réelles + ressources de marque. Si le site vend quelque chose et que l'utilisateur veut une promotion, utilisez /product-launch-video.
  • Sortie : une visite de site / démonstration / clip social construit à partir des propres visuels du site → MP4.
  • Déclencheurs : "transforme ce site web en vidéo", "visite de site depuis ", "clip social depuis notre page d'accueil", "j'ai juste une URL — crée quelque chose".

/faceless-explainer

  • Entrée : Texte arbitraire — un sujet, un article ou des notes — en cours d'explication, sans produit commercialisé ni site à capturer. (Dérivé de /product-launch-video ; pas de Chrome sans tête.)
  • Sortie : vidéo explicative sans visage → MP4, chaque visuel inventé par LLM par scène (typographie / abstrait / diagramme / data-viz) ; livre le préréglage pin-and-paper. (Point idéal 30–90s).
  • Déclencheurs : "vidéo explicative sans visage sur X", "explique comment fonctionne DNS en vidéo", "transforme cet article en vidéo explicative", "vidéo explicative à 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 la CLI gh (pas un site à explorer).
  • Sortie : vidéo explicative de modification de code (journal des modifications / révélation de fonctionnalité / correction / refactorisation) → MP4 — points forts de la diff, avant/après, arborescence de fichiers + scènes d'impact. ≤ (point idéal 30–90s).
  • Déclencheurs : "crée 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 de type tête parlante (MP4) à sous-titrer — la 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.
  • Sortie : le même métrage intact, avec une couche de sous-titres — Standard (bandeau littéral en tiers inférieur + un point culminant intégré derrière le sujet) ou Cinématographique (chaque sous-titre composé derrière le sujet). Toute durée.
  • Déclencheurs : "ajouter des sous-titres à 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 de type tête parlante / interview / podcast (MP4) à emballer avec des graphiques à l'écran — la vidéo réelle. Transcrite localement (Whisper). Le clip est lu en intégralité en dessous, intact.
  • Sortie : le même métrage avec des cartes de superposition graphique minutées — titres cinétiques, tiers inférieurs, appels de données, citations en exergue, panneaux latéraux, incrustation d'image — synchronisées avec la transcription. Toute durée.
  • Déclencheurs : "emballer cette vidéo", "ajouter des superpositions graphiques / tiers inférieurs / appels de données à ma présentation", "transforme cette interview en vidéo de marque", "refonte de podcast".

/motion-graphics

  • Entrée : Un brief de design — un titre / un chiffre / une citation / un logo / une phrase — avec peu ou pas de narration. Peut inclure des ressources (images, polices, couleurs, logo) ou être purement conceptuel.
  • Sortie : un graphisme animé court non narré → MP4 (≤20s, 10–15s idéal) — la pièce n'a pas de narration : le mouvement ET le design racontent l'histoire. Utilisez-le pour des titres cinétiques, des logos stings, des statistiques, des superpositions de tiers inférieur, des citations en exergue, des visuels de fond de scène. Pas de planification de scène ; pas de voix off synthétisée.
  • Pas pour : vidéos plus longues ou multi-scènes, contenu narré, pièces pilotées par la musique (→ /music-to-video).
  • Déclencheurs : "tableau de statistiques animé", "logo sting pour notre marque", "titre cinétique pour la section suivante", "citation en exergue à l'écran", "superposition de tiers inférieur".

/music-to-video

  • Entrée : Un fichier audio (par ex. .mp3, .wav, .aac) ou une vidéo dont l'audio doit être extrait. (Un fichier vidéo en entrée peut être accompagné de ressources visuelles — ce n'est pas un métrage à préserver intact). Aucune narration n'est fournie (si narration, utilisez le workflow correspondant à l'entrée). Des images / clips vidéo utilisateur optionnels peuvent être fournis pour être découpés sur la grille de beats ; sinon, les visuels sont générés (texte / diagrammes / images AI).
  • Sortie : une vidéo synchronisée sur le beat → MP4, où le rythme et l'énergie de la musique pilotent la chronologie visuelle. Longueur de la piste audio (généralement 2–5 min).
  • Déclencheurs : "crée une vidéo lyrique à partir de cette chanson", "diaporama synchronisé sur le beat", "promotion cinétique pour ce morceau", "vidéo avec de la musique mais pas de voix off".

/slideshow

  • Entrée : Un lien ou un fichier de présentation existant, ou un brief conceptuel — "crée un pitch deck", "transforme cette page en diaporama", "je veux un deck interactif". Un fichier entrant (par ex. .pptx, .pdf) peut être analysé pour en extraire le contenu ; un lien GitHub vers un fichier de présentation peut être résolu ; sinon le contenu est créé.
  • Sortie : un deck navigable (pas une vidéo rendue) — un document HTML/Web component (Reveal.js par défaut). Navigable : clavier / tactile / zoom / commentaires du présentateur / animations.
  • Déclencheurs : "crée un pitch deck", "présentation pour notre réunion d'équipe", "transforme cette documentation en diaporama", "convertir cette page en présentation".

/general-video

  • Entrée : N'importe quoi — un sujet, un script, des ressources, un brief conceptuel, une description d'une boucle / affiche. Fonctionne comme un fourre-tout général.
  • Sortie : une pièce vidéo unique/multi-scène → MP4 — composition personnalisée. Aucune limite de longueur ; supporte le contenu narré et non narré. Utilisé pour des pièces plus longues (≥3 min) , des boucles / affiches statiques, ou tout ce qui ne correspond pas aux workflows plus spécifiques.
  • Déclencheurs : "crée une vidéo à partir de ce brief", "boucle de fond pour notre stand", "vidéo de fond pour événement", "vidéo longue sur X", "affiche animée".

/remotion-to-hyperframes

  • Entrée : Un projet / composition Remotion existant — un répertoire de projet ou un code source de composant React/Remotion. (Pas un nouveau brief — c'est une migration outillage, pas une création de contenu.)
  • Sortie : le code de composition HyperFrames équivalent (HTML/CSS/JS — pas un wrapper React) — même mise en page, timing, animation et sortie vidéo. La CI déployant des vidéos Remotion existantes pourrait être migrée conjointement, mais ce n'est pas le sujet de cette compétence.
  • Déclencheurs : "porte cette composition Remotion vers HyperFrames", "migre notre pipeline vidéo Remotion", "convertir ce composant React en HTML pure".

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés