Communitygithub.com

HyperFrames — Lire ceci en premier

Compétence d'entrée pour HyperFrames. À démarrer ici pour toute demande de création, d'édition, d'animation ou de rendu d'une vidéo, animation, motion design, vidéo explicative, générique, incrustation, vidéo sous-titrée, promotion produit, vidéo web, vidéo de notes de version, montage de données, affiche animée ou composition HTML HyperFrames.

Qu'est-ce que HyperFrames — Lire ceci en premier ?

Cette compétence est le point d'entrée obligatoire pour l'écosystème HyperFrames. Elle agit comme une carte des capacités et un routeur vidéo : elle oriente l'intention 'fais-moi une vidéo' vers le workflow spécialisé approprié — vidéo de lancement produit, explicateur sans visage, site-web-vers-vidéo, PR-vers-vidéo, sous-titres incrustés, incrustations graphiques, motion graphics, vidéo générale ou remotion-vers-hyperframes. Elle détermine le workflow en fonction du type d'entrée (URL, brief, sujet, PR GitHub, vidéo existante) et de la longueur cible (≤~3 min, tutoriel de 3-5 min, analyse approfondie de 5 min+), avec un court-circuit de genre pour les motion graphics courts sans narration. Elle liste également clairement ce qu'HyperFrames ne peut pas faire — comme l'édition de footage existante, les appels réseau au moment du rendu, ou la génération d'actifs qu'il ne possède pas — afin que les utilisateurs ne se tournent pas vers un workflow inadapté. Elle est prise en charge par tous les agents capables de lire des fichiers SKILL.md. La compétence elle-même ne contient pas de logique d'exécution ; elle délègue aux compétences de domaine (hyperframes-core, hyperframes-animation, etc.) une fois la route choisie.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/kyirexy/6/tree/HEAD/.agents/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

Que fait HyperFrames — Lire ceci en premier ?

Commencez ici pour toute tâche HyperFrames — surtout en l'absence de configuration d'agent de projet (CLAUDE.md / AGENTS.md / .cursorrules). Carte des capacités + routeur vidéo ci-dessous.

Carte des capacités — quelle compétence pour quelle intention

Vous voulez…Allez vers
Faire une vidéo (à partir d'une URL, d'un brief, d'un sujet, d'une PR GitHub, d'un footage existant ou d'un seul élément à animer)le routeur vidéo ci-dessous (§ Routage vidéo)
Créer / éditer une composition HTML — le contrat data-*, clips, pistes, sous-compositions, variables/hyperframes-core
Animer — règles de mouvement atomiques, blueprints de scène, transitions, adaptateurs runtime (GSAP / Lottie / Three.js / Anime.js / CSS / WAAPI / TypeGPU)/hyperframes-animation
Direction créative — design.md, palettes, typographie, narration, planification des beats, réactif à l'audio/hyperframes-creative
Prétraitement média — voix off TTS, musique de fond, transcription, suppression d'arrière-plan, sous-titres/hyperframes-media
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

Le contrat de création de composition (tout élément temporel a besoin de data-start / data-duration / data-track-index ; les éléments temporels ont besoin de class="clip" ; les timelines GSAP sont mises en pause et enregistrées sur window.__timelines ; logique déterministe uniquement — pas de Date.now() / Math.random() / réseau) n'est pas dupliqué ici — il vit dans /hyperframes-core. Lisez-le avant d'écrire du HTML de composition.

Ce qu'HyperFrames ne peut pas faire — vérifiez ceci en premier

HyperFrames crée une composition HTML et la rend en MP4 à partir du code. Ce modèle a des limites strictes. Une requête qui dépasse l'une d'elles n'est pas un choix de routage — elle est hors de portée, donc déclinez (ou orientez vers le bon outil) au lieu d'essayer un workflow. Ces limites découlent de l'architecture, pas d'une simple demande :

  • Le rendu est déterministe et autonome. Chaque valeur, ressource et texte est intégré au moment de la création ; le rendu n'effectue aucun appel réseau et aucune extraction de données en direct / au moment du rendu (règle fondamentale : pas de Date.now() / Math.random() / réseau). « Rendre les chiffres en direct au moment du rendu » est hors de portée — récupérez les données une fois au moment de la création et intégrez-les, ou déclinez.
  • La vidéo existante est superposée, jamais éditée. HyperFrames compose des images par-dessus un clip source — /embedded-captions ajoute une couche de sous-titres, /graphic-overlays ajoute des cartes graphiques conçues (tiers inférieurs, encadrés de données, titres) — et le clip reste inchangé en dessous, mais il ne retraite pas le flux vidéo encodé. Modifier le footage lui-même (son timing, sa couleur, son cadrage, son ordre ou son audio) relève de l'édition de type NLE et est hors de portée.
  • L'importation Remotion est à sens unique. /remotion-to-hyperframes traduit le code source du framework Remotion en HyperFrames. Il n'y a pas de traduction inverse (HyperFrames → Remotion, ou → tout autre framework — hors de portée), et une source React / animation web non-Remotion n'a pas de source Remotion à traduire — recréez-la via /general-video.
  • Il ne peut pas produire des entrées qu'il ne possède pas. Pas d'enregistrement d'écran / session, pas de capture caméra, pas de génération d'avatar parlant / synchronisé labialement par IA. Si le footage ou la ressource n'existe pas encore, HyperFrames ne peut pas le créer — demandez à l'utilisateur de le fournir (ou d'utiliser le bon outil de capture) d'abord.

Tout le reste — une vidéo à partir d'une URL, d'un brief, d'un sujet, d'une PR, d'un footage à annoter ou d'un seul élément à animer — est dans le périmètre ; routez-le ci-dessous.


Routage vidéo

Cette section connaît UNIQUEMENT les workflows de haut niveau. Elle ne charge pas les phases internes des workflows, les compétences de domaine (hyperframes-* — voir la carte des capacités ci-dessus) ou les références techniques.

Table de décision

Le type d'ENTRÉE (intention) est l'axe principal ; la longueur de SORTIE est seulement un plafond, pas un verrou. Pour une entrée correspondante, les workflows spécialisés gèrent tout jusqu'à ~3 min — quel workflow vous entrez est décidé par l'intention (le type d'entrée, et pour le texte, le sujet), pas par la durée. La durée compte seulement à l'extrémité haute : un contenu vraiment plus long (un tutoriel de 3-5 min, une analyse approfondie de 5 min+) est un registre différent et route vers /general-video. Dans la bande ≤~3 min, un troisième axe sépare les deux workflows alimentés par du texte — le sujet : un produit qui est commercialisé vs un sujet qui est expliqué (voir la règle de désambiguïsation à l'étape 3 ci-dessous).

Durée / EntréeLancement produit (URL / brief / script)Site web général / URLPR GitHub / changement de codeSujet / article / notes (pas de produit, pas d'URL)Vidéo existante (talking-head) †
≤ ~3 min/product-launch-video/website-to-video/pr-to-video/faceless-explainer/embedded-captions · /graphic-overlays †
Tutoriel 3-5 min/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
Analyse approfondie 5 min+/general-video/general-video/general-video/general-video/embedded-captions · /graphic-overlays †
Statique / boucle/general-video/general-video/general-video/general-video/general-video

Couverture actuelle : la bande ≤ ~3 min a des workflows dédiés pour les entrées lancement-produit / site-web-général / PR-GitHub / sujet (une URL se divise en type puis intention — voir l'étape 3), et la colonne vidéo existante est couverte à n'importe quelle durée — par /embedded-captions (sous-titres / légendes) ou /graphic-overlays (incrustations graphiques conçues), répartis par intention (voir l'étape 2). Chaque autre case est /general-video — le flux général de création de composition HTML (indépendant de l'entrée et de la durée) : tout ce qui est plus long que ~3 min (les lignes 3-5 min / 5 min+) et chaque format statique / boucle. Le routeur n'aboutit jamais à une impasse sur une vidéo créable ; la seule véritable réponse « général / aucun » est une demande en dehors d'HyperFrames lui-même (par exemple, l'édition de type NLE d'un fichier vidéo fini — re-timing, recoloration, recadrage, réorganisation, audio).

† Le footage existant se répartit par intention, pas par durée. Sous-titres / légendes → /embedded-captions ; incrustations graphiques conçues / habillage — tiers inférieurs, encadrés de données, cartes titrées, pull-quotes → /graphic-overlays. Les deux superposent le clip, qui reste inchangé en dessous ; aucun n'édite le footage lui-même.

Court-circuit de genre (précède le tableau). Un motion graphic court (~moins de 10s), sans narration, axé sur le design — typographie cinétique, un stat / point de graphique, un logo sting, un tier inférieur / incrustation, ou un tweet / titre / surbrillance de page animé — route vers /motion-graphics quel que soit le type d'entrée. C'est un genre de SORTIE, pas un type d'entrée, donc il prend le pas sur le tableau des types d'entrées ci-dessus lorsque la demande est clairement axée sur le mouvement sans narration (voir l'étape 2). Un traitement plus long ou narré route selon le type d'entrée, ou /general-video.

Migration d'une composition existante (cas spécial)

Le tableau ci-dessus concerne la création d'une vidéo à partir d'une entrée. Un workflow se situe en dehors : si l'utilisateur demande explicitement de porter / convertir / migrer une composition Remotion (React) existante dans HyperFrames → /remotion-to-hyperframes. C'est une traduction de source, pas une création à partir d'une entrée, donc elle n'a pas de case ENTRÉE × DURÉE. Routez ici UNIQUEMENT sur un langage de migration explicite (« porte mon projet Remotion », « convertis cette comp Remotion », « réécris ça en HyperFrames ») — une mention passagère de Remotion n'est pas un déclencheur ; utilisez par défaut le tableau de création ou /hyperframes-core.

Procédure de routage

  1. Déterminez le type d'ENTRÉE + la longueur cible. Le routage a besoin de savoir ce que la vidéo raconte— son sujet et son entrée. Si le sujet lui-même n'est pas spécifié (par exemple « fais une vidéo sur notre truc » sans URL, produit nommé, sujet ou ressource de travail), ou si le type d'entrée est inconnu, demandez avant d'entrer dans un workflow — clarifiez d'abord ; n'invoquez pas un Skill de workflow puis ne demandez pas, car s'engager dans un workflow est en soi la décision de routage. Posez au maximum 2 questions de clarification :
    • « Quelle est votre entrée — un produit (URL ou brief), un site web général / URL, une PR GitHub / un changement de code, un sujet ou article à expliquer, ou une vidéo talking-head existante à sous-titrer ? »
    • « Longueur cible — environ 3 minutes ou moins, ou plus long (un tutoriel de 3-5 min / une analyse approfondie de 5 min+) ? »
    • Valeurs par défaut des spécifications — déclarez, ne demandez pas (celles-ci n'AFFECTENT PAS la route, donc ne bloquez jamais le routage dessus) : rapport hauteur/largeur 16:9 (le moteur supporte également le 9:16 vertical — passez seulement si l'utilisateur nomme une destination verticale comme TikTok / Reels / Shorts) ; langue de la narration / du sous-titrage = celle de l'utilisateur. Confirmez seulement si l'utilisateur s'y oppose ; le workflow choisi re-confirme ses propres spécificités à son étape 0.
  2. Choisissez par type d'ENTRÉE (intention) d'abord ; la durée n'est qu'un plafond, pas un verrou.
    • Motion graphic court axé sur le design (court-circuit de genre, précède le tableau d'entrée) — le mouvement lui-même est le message : typographie cinétique, un stat / compteur de nombre, un point de graphique, un logo sting, un tier inférieur / incrustation, ou un tweet / titre / surbrillance de page animé ; généralement moins de ~10s, pas de narration / voix off → /motion-graphics. C'est un genre de SORTIE, pas un type d'entrée — lorsque la demande est clairement un court morceau animé sans narration, routez ici quel que soit le type d'entrée. Un traitement plus long ou narré du même matériel n'est PAS cela (routez selon le type d'entrée, ou /general-video).
    • Vidéo talking-head existante (l'utilisateur a un clip et veut y ajouter quelque chose) → répartissez par intention, à n'importe quelle durée (le type d'entrée l'emporte sur la durée) : sous-titres / légendes (les mots parlés sous forme de texte lisible) → /embedded-captions ; incrustations graphiques conçues — tiers inférieurs, encadrés de données, fiches d'info titrées, pull-quotes, un montage habillé graphiquement → /graphic-overlays. (Éditer le footage lui-même — re-timing, recolorier, recadrer, réordonner, audio — est de type NLE et hors de portée ; voir § Ce qu'HyperFrames ne peut pas faire.)
    • PR GitHub / changement de code (un lien github.com/<propriétaire>/<dépôt>/pull/<N>, une référence propriétaire/dépôt#N, ou « cette PR ») → /pr-to-video (jusqu'à ~3 min).
    • Sinon (URL produit / brief / texte de sujet) : l'intention choisit le workflow via l'étape 3, et elle gère tout ce qui est jusqu'à ~3 min — un court promo de 15-30 s et un explicateur de ~100 s se routent tous les deux par intention, pas par durée. Routez vers /general-video (le fallback indépendant de la durée — voir l'étape 4) uniquement lorsque la cible est clairement plus longue que ~3 min (un tutoriel de 3-5 min, une analyse approfondie de 5 min+). Ne forcez jamais un contenu vraiment long dans un workflow ≤~3 min — l'intention décide dans la bande, /general-video couvre le reste.
  3. Désambiguïsez les entrées URL / texte ≤~3 min (le partage d'intention). Deux partages :
    • Type d'URL + intention — une URL ne gagne plus automatiquement pour PLV ; son type puis son intention décident : un lien PR GitHub (.../pull/<N>, propriétaire/dépôt#N, « cette PR ») → /pr-to-video ; sinon, une URL de site web se répartit par intention — commercialisation / lancement / promotion d'un produit ou SaaS spécifique → /product-launch-video ; un site général → vidéo (visite du site, portfolio / blog / vitrine de page d'accueil, un clip social à partir des propres visuels du site, ou simplement « transforme ce site en vidéo ») → /website-to-video. Les deux explorent avec Chrome headless ; les URL de PR sont lues via gh. Lorsqu'il n'est vraiment pas clair qu'une URL de site est un lancement produit ou une vidéo de site général, posez une question.
    • Produit vs sujet (texte, pas d'URL) — la question décisive est ce que la vidéo raconte, pas le format d'entrée :
      • Un produit / entreprise / SaaS / application / site web spécifique qui est commercialisé, lancé ou promu → /product-launch-video.
      • Un concept / sujet / article / comment-quelque-chose-fonctionne qui est expliqué, sans produit et sans URL → /faceless-explainer.
      • Départageurs : Un libellé « Promouvoir / lancer / vendre / notre produit » → PLV. « Expliquer / enseigner / comment X fonctionne / qu'est-ce que X » sans produit → faceless. Le style livré pour faceless est toujours pin-and-paper.
      • Un site nommé sans URL collée est toujours PLV. Un script qui mentionne un produit ou son site web (« notre site est acme.io », « promeut ») route vers PLV même sans lien cliquable — PLV peut chercher le site sur le web et l'explorer pour les ressources de la marque (sauf si l'utilisateur se désengage, → mode préréglé sans capture). Ne pas coller l'URL n'en fait pas un travail faceless / sans capture. Le choix verbeux-vs-restructuration pour un script fourni est interne à PLV et ne change jamais la route.
      • Indices contradictoires → demandez, ne devinez pas. Si la source fournie est le propre matériel marketing d'un produit (sa page d'accueil, un article promotionnel sur leur plateforme) mais que l'utilisateur demande explicitement de supprimer la promotion — un explicateur neutre du concept sous-jacent, pas une pub — traitez-le comme vraiment ambigu (est-ce que la vidéo

…

[tronqué pour la traduction]

Skills associés