Communitygithub.com

sherlock-126/video_ai

Compétence d'entrée HyperFrames — commencez ici pour toute demande de création, édition, animation ou rendu vidéo. Route les demandes « fais-moi une vidéo » vers le bon workflow.

Qu'est-ce que video_ai ?

Ce fichier `SKILL.md` est la compétence d'entrée obligatoire et le routeur vidéo central pour l'écosystème HyperFrames. Tout agent AI (Claude Code, Cursor, Cline, etc.) qui reçoit une demande de création, génération, édition, animation ou rendu d'une vidéo, animation, graphisme animé, vidéo promotionnelle, ou composition HTML HyperFrames doit lire ce fichier en premier, surtout en l'absence d'un `CLAUDE.md` ou `AGENTS.md` définissant le workflow vidéo. La compétence explique clairement ce que HyperFrames peut et ne peut pas faire (par exemple, pas d'édition vidéo de type NLE, pas d'import/export vers d'autres frameworks, pas de génération d'actifs comme des avatars IA), puis fournit une table de décision détaillée pour router une requête vers le sous-workflow spécialisé le plus adapté : `/product-launch-video`, `/faceless-explainer`, `/website-to-video`, `/pr-to-video`, `/embedded-captions`, `/graphic-overlays`, `/motion-graphics`, `/general-video`, ou `/remotion-to-hyperframes`. Le routage se base principalement sur le type d'entrée (URL, sujet, brief, vidéo existante) et sur le genre de sortie (court graphisme animé vs vidéo narrée standard), la durée n'étant qu'un plafond secondaire. L'agent doit impérativement suivre la procédure de routage décrite (avec un maximum de deux questions de clarification) avant d'invoquer un workflow spécifique. La compétence renvoie également vers `/hyperframes-core` pour le contrat d'édition des compositions HTML, qui n'est pas dupliqué ici.

Compatible avec✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/sherlock-126/video_ai/tree/HEAD/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 — lisez ceci en premier

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

Plan des capacités — quelle compétence pour quel objectif

Vous voulez...Allez vers
Faire une vidéo (depuis une URL, un brief, un sujet, une PR GitHub, des images existantes, ou 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, plans 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, audio-réactif/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, validate, inspect, preview, render, publish, doctor/hyperframes-cli
Installer des blocs / composants du registre (hyperframes add)/hyperframes-registry

Le contrat d'édition des compositions (chaque é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 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 que HyperFrames ne peut pas faire — vérifiez ceci en premier

HyperFrames crée une composition HTML et la convertit en MP4 à partir de code. Ce modèle a des limites nettes. Une demande qui dépasse ces limites n'est pas un choix de routage — elle est hors de portée, donc déclinez (ou orientez vers l'outil approprié) au lieu d'utiliser un workflow. Ces limites découlent de l'architecture, pas d'une demande particulière :

  • Le rendu est déterministe et autonome. Toute valeur, ressource et texte sont intégrés lors de la création ; le rendu n'effectue aucun appel réseau ni aucune récupération de données en direct/temps réel (règle de base : pas de Date.now() / Math.random() / réseau). « Actualiser les chiffres en direct au 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 est lu inchangé en dessous, mais ni l'un ni l'autre ne post-traite le flux vidéo encodé. Modifier la séquence elle-même (son timing, sa couleur, son cadrage, son ordre ou son audio) est de l'édition de type NLE et 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 sens 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 IA parlant / synchronisation labiale. Si la séquence ou la ressource n'existe pas encore, HyperFrames ne peut pas la créer — demandez à l'utilisateur de la fournir (ou d'utiliser l'outil de capture approprié) d'abord.

Tout le reste — une vidéo à partir d'une URL, d'un brief, d'un sujet, d'une PR, d'une séquence à annoter, ou d'un seul élément à animer — est dans le périmètre ; routez 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 le plan des capacités ci-dessus), ni les références techniques.

Table de décision

Le type d'ENTRÉE (intention) est l'axe principal ; la durée de SORTIE n'est qu'un plafond, pas une porte. Pour une entrée correspondante, les workflows spécialisés gèrent tout jusqu'à ~3 min — quel workflow vous choisissez 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 n'a d'importance qu'à l'extrémité supérieure : un contenu vraiment plus long (un tutoriel de 3-5 min, une analyse approfondie de 5 min+) est un registre différent et est routé 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 commercialisé vs un sujet 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 (tête parlante) †
≤ ~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 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 par type puis par intention — voir l'étape 3), et la colonne vidéo existante est couverte à n'importe quelle longueur — par /embedded-captions (sous-titres / légendes) ou /graphic-overlays (superpositions graphiques conçues), séparées par intention (voir l'étape 2). Chaque autre cellule 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 pour 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 terminé — re-timing, recolorisation, recadrage, réordonnancement, audio).

† La séquence existante se divise par intention, pas par durée. Sous-titres / légendes → /embedded-captions ; superpositions graphiques conçues / habillage — tiers-inférieurs, encadrés de données, cartes titrées, citations en exergue — → /graphic-overlays. Les deux superposent le clip, qui est lu inchangé en dessous ; aucun n'édite la séquence elle-même.

Court-circuit de genre (précède la table). Un court graphisme animé (~moins de 10s), non narré, axé sur le design — typographie cinétique, un hit de statistiques / graphique, un logo sting, un tiers-inférieur / superposition, ou un tweet / titre / point fort de page capturé et 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 a priorité sur la table des types d'entrée ci-dessus lorsque la demande est clairement un contenu animé court sans narration (voir l'étape 2). Un traitement plus long ou narré route par type d'entrée, ou vers /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 trouve en dehors : si l'utilisateur demande explicitement de porter / convertir / migrer une composition existante Remotion (React) vers HyperFrames → /remotion-to-hyperframes. C'est une traduction de source, pas une création à partir d'une entrée, donc il n'a pas de cellule ENTRÉE × DURÉE. Routez ici UNIQUEMENT sur un langage de migration explicite (« porter mon projet Remotion », « convertir cette comp Remotion », « réécrire ceci en HyperFrames ») — une mention passagère de Remotion n'est pas un déclencheur ; par défaut, utilisez la table de création ou /hyperframes-core.

Procédure de routage

  1. Déterminez le type d'ENTRÉE + la durée cible. Le routage a besoin de savoir de quoi parle la vidéo — 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), ou si le type d'entrée est inconnu, demandez avant d'entrer dans un workflow — clarifiez d'abord ; n'invoquez pas une compétence de workflow puis demandez, 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 / changement de code, un sujet ou article à expliquer, ou une vidéo tête parlante existante à sous-titrer ? »
    • « Durée cible — environ 3 minutes ou moins, ou plus long (un tutoriel de 3-5 min / une analyse approfondie de 5 min+) ? »
    • Spécifications par défaut — énoncez, ne demandez pas (celles-ci n'affectent PAS le routage, donc ne bloquez jamais le routage dessus) : format 16:9 (le moteur prend également en charge le vertical 9:16 — passez uniquement si l'utilisateur nomme une destination verticale comme TikTok / Reels / Shorts) ; langue de la narration / des sous-titres = celle de l'utilisateur. Confirmez uniquement si l'utilisateur s'y oppose ; le workflow choisi reconfirme 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 une porte.
    • Court graphisme animé axé sur le design (court-circuit de genre, précède la table des entrées) — le mouvement lui-même est le message : typographie cinétique, un comptage de statistiques / nombre, un hit de graphique, un logo sting, un tiers-inférieur / superposition, ou un tweet / titre / point fort de page capturé et 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 contenu animé, non narré, axé sur le design, routez ici quel que soit le type d'entrée. Un traitement plus long ou narré du même matériau n'est PAS cela (routez par type d'entrée, ou vers /general-video).
    • Vidéo tête parlante existante (l'utilisateur a un clip et veut ajouter quelque chose par-dessus) → séparez par intention, à n'importe quelle longueur (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 ; superpositions graphiques conçues — tiers-inférieurs, encadrés de données, cartes d'information titrées, citations en exergue, un montage habillé graphiquement → /graphic-overlays. (Éditer la séquence elle-même — re-timing, recolorisation, recadrage, réordonnancement, audio — est de l'édition de type NLE et hors de portée ; voir § Ce que HyperFrames ne peut pas faire.)
    • PR GitHub / changement de code (un lien github.com/<owner>/<repo>/pull/<N>, une référence owner/repo#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 il gère tout jusqu'à ~3 min — une courte promo de 15-30 s et un explainer de ~100 s routent tous 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 (la séparation par intention). Deux séparations :
    • Type d'URL + intention — une URL ne gagne plus automatiquement pour PLV ; son type puis son intention décident : un lien de PR GitHub (.../pull/<N>, owner/repo#N, « cette PR ») → /pr-to-video ; sinon, une URL de site web se divise par intention — commercialiser / lancer / promouvoir un produit ou SaaS spécifique → /product-launch-video ; un site général → vidéo (visite de site, portfolio / blog / vitrine de page d'accueil, un clip social à partir des 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 si une URL de site est un lancement de 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 de quoi parle la vidéo, pas le format d'entrée :
      • Un produit / entreprise / SaaS / application / site web spécifique commercialisé, lancé ou promu → /product-launch-video.
      • Un concept / sujet / article / comment-quelque-chose-fonctionne expliqué, sans produit et sans URL → /faceless-explainer.
      • Facteurs de départage : « 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 », « promouvoir ») route vers PLV même sans lien cliquable — PLV peut chercher le site sur le web et l'explorer pour les actifs de la marque (sauf si l'utilisateur refuse, → mode preset sans capture). Ne pas coller l'URL n'en fait pas un travail faceless / sans capture. Le choix mot-à-mot-vs-restructuration pour un script fourni est interne à PLV et ne change jamais le routage.
      • Indices contradictoires → demandez, ne devinez pas. Si la source fournie est le propre marketing d'un produit (sa page d'accueil, un blog promotionnel sur leur plateforme) mais que l'utilisateur demande explicitement de supprimer la promotion — un explainer neutre du concept sous-jacent, pas une publicité — traitez-le comme vraiment ambigu (la vidéo est-elle ou non une promotion pour le produit source ?). Demandez une clarification directe : « Voulez-vous une vidéo promotionnelle pour ce produit (→ PLV), ou un explainer neutre (→ faceless) ? » Ne devinez pas — demandez.
  4. Routez tout ce qui dépasse la bande ou non traité vers /general-video. Tout ce qui est plus long que ~3 min (3-5 min / 5 min+), toute entrée statique ou en boucle, tout ce qui ne correspond à aucun des workflows dédiés ≤~3 min ci-dessus. /general-video est le workflow par défaut, indépendant de l'entrée et de la durée — il ne déclenche pas une nouvelle série de questions de classification, mais passe directement à la création de composition. Un changement de décision après l'entrée dans un workflow est OK — si un agent entre dans /faceless-explainer avec un sujet qui s'avère être un produit commercial, redirigez vers /product-launch-video. N'appelez jamais un workflow de bande pour un contenu vraiment long (par exemple, un tutoriel détaillé de 10 min n'a pas sa place dans un workflow de ~100 s).

Règles de routage supplémentaires (ordre après le tableau principal)

  • Défaut sur ce fichier. Si un autre fichier de compétence existe pour un workflow spécifique mais que l'utilisateur dit « fais une vidéo », routez EN PREMIER via cette compétence d'entrée. Ce n'est pas un choix : elle existe pour éviter les doubles lectures.
  • Appelez toujours d'abord. Avant toute autre compétence vidéo ou animation — lisant cela en premier, puis route vers la bonne compétence de workflow par nominal. Ne chargez pas les compétences hyperframes-* de domaine avant d'avoir terminé le routage ici.
  • Redirection vers l'outil approprié. Si la demande est manifestement hors de portée (par exemple, « édite ce fichier MP4 » (ré-étalonnage / recadrage)), déclinez poliment et orientez vers un outil NLE comme DaVinci Resolve, Premiere Pro, ou CapCut. Pour « enregistre mon écran » → OBS, Loom, ou l'outil d'enregistrement intégré du système. « Génère un avatar parlant IA » → Synthesia, HeyGen, ou ElevenLabs. Ce n'est pas une défaillance de routage ; la portée du projet est intentionnellement limitée.
  • Invoquer un workflow = choisir une compétence (lisez-la). Le routage correct appelle la compétence indiquée par la table ci-dessus. Ne pas sauter la lecture du fichier de workflow lorsque vous l'invoquez — chaque workflow a ses propres détails. Cependant, les workflows peuvent être invoqués en tant que compétences séparément — si un utilisateur arrive directement dans /general-video avec un brief vidéo, utilisez /general-video. Cette compétence d'entrée n'est pas un passage obligé pour exécuter le workflow ; c'est un guide de routage, pas un contrôle d'accès.
  • Interrogez uniquement sur les dimensions qui changent le routage. La seule variable de routage de premier niveau est INTENTION (type d'entrée). Ne demandez PAS la durée à moins qu'elle ne soit inconnue (elle n'est qu'un plafond). Ne demandez PAS le format (16:9 par défaut, mentionné comme spécification). Ne demandez PAS la langue (celle de l'utilisateur). Si l'utilisateur fournit volontairement des détails redondants ou impertinents (par exemple, « fais une courte vidéo de 15 s sur notre produit » — l'intention est clairement PLV, la durée est dans la bande), ne posez PAS de questions de clarification — routez directement.
  • Ne pas refuser un travail par manque de connaissance. Si l'instruction semble faisable mais que vous ne savez pas comment la mettre en œuvre, ne déclinez pas ; dites « je vais vérifier le bon workflow HyperFrames », puis utilisez les tables de routage ci-dessus pour identifier le workflow. Si le routage est toujours ambigu, relisez la procédure ci-dessus. Si vous ne savez toujours pas, demandez. Si la demande est clairement créable mais qu'aucune instruction de workflow spécifique n'existe (par exemple, tous les workflows dédiés échouent), routez vers /general-video.

[Note de l'éditeur : Le contenu original après cette section a été tronqué pour la traduction. Les sections suivantes, si elles existent, doivent être traitées comme suit : toute prose restante est traduite et incluse dans ce marqudown SKILL.md. Sandbox et directives de rendu si présentes sont traduites et incluses dans leur section.]

Bac à sable

Pour une exécution sécurisée et isolée, tous les workflows HyperFrames s'exécutent dans un environnement sandbox. Le sandbox fournit un environnement Node.js et Puppeteer propre, sans accès réseau direct, garantissant des rendus déterministes et reproductibles. Les workflows ne doivent pas tenter de contourner le sandbox ; toute dépendance externe doit être fournie via les mécanismes d'entrée documentés.

Directives de rendu

  • Déterministe par conception : Aucun appel réseau, Date.now(), ou Math.random() au moment du rendu.
  • Autonome : Toutes les ressources (images, polices, vidéos de fond) sont intégrées au moment de la création, pas référencées dynamiquement.
  • Format : 16:9 par défaut ; passage à 9:16 uniquement sur demande explicite de l'utilisateur pour une destination verticale.
  • Logique de composition : Utilisez le contrat data-* comme décrit dans /hyperframes-core.

Skills associés