hyperframe — routeur vers HeyGen HyperFrames
HyperFrames (Apache-2.0, github.com/heygen-com/hyperframes) transforme des compositions HTML/CSS/JS en MP4 déterministes : le moteur de rendu parcourt chaque image dans Chrome sans tête et encode avec FFmpeg. Cette compétence est un ROUTEUR LÉGER — toutes les connaissances réelles résident en amont dans le dépôt cloné et ses 20 compétences d'agent ; ne dupliquez jamais la documentation en amont ici.
Chemins locaux
Résolution : variable d'environnement HYPERFRAMES_HOME → ~/.jstack/config.env → valeur par défaut ci-dessous.
| Quoi | Où |
|---|---|
| Dépôt cloné (copie locale canonique) | ~/.jstack/vendor/hyperframes |
| Compétence routeur amont (À LIRE EN PREMIER pour toute demande de création vidéo) | ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md |
Ses 20 compétences d'agent (également installées dans ~/.claude/skills/ + ~/.agents/skills/ par hyperframes init) | ~/.jstack/vendor/hyperframes/skills/ |
Registre de blocs/composants (70+ blocs : tiers inférieurs lt-*, code-*, logo-outro, glitch, data-chart…) | ~/.jstack/vendor/hyperframes/registry/{blocks,components} |
| Sources de documentation (Démarrage rapide, concepts, référence, catalogue) | ~/.jstack/vendor/hyperframes/docs/ |
| En ligne : docs + catalogue de blocs | hyperframes.heygen.com (Démarrage rapide/Docs/Catalogue), hyperframes.dev (bac à sable + modèles de conception) |
Installation / vérification de santé
Prérequis : Node 22+ et FFmpeg dans le PATH (vérifié fonctionnel sur cette machine, CLI v0.7.48).
npx --yes hyperframes doctor # vérification de santé de l'environnement
npx --yes hyperframes init my-video # génère un projet (installe/rafraîchit également ses compétences d'agent)
cd my-video && npm run render # → renders/*.mp4
init génère index.html + hyperframes.json et épingle la version CLI dans les scripts package.json (dev/check/render/publish). Rafraîchissez le clone avec
git -C ~/.jstack/vendor/hyperframes pull.
Table de routage
Acheminez l'intention, puis OUVRIR/EXÉCUTER la cible en amont — n'improvisez pas de workflow.
| Intention | Aller vers |
|---|---|
| Toute demande de "création d'une vidéo/ animation" (point d'entrée) | Lire la compétence routeur /hyperframes : ~/.jstack/vendor/hyperframes/skills/hyperframes/SKILL.md — elle choisit le workflow |
| Texte d'accroche animé / titres cinétiques / hit stat / logo sting / carte de fin / tiers inférieur (court, non narré, axé sur le design) | Workflow /motion-graphics : skills/motion-graphics/ dans le clone ; blocs tiers inférieurs = registre lt-*, carte de fin = logo-outro |
| Sous-titres cinétiques / légendes sur une vidéo existante avec tête parlante | Workflow /embedded-captions : skills/embedded-captions/ (images non touchées, légendes rendues par-dessus) |
Créer ou modifier une composition HTML→MP4 (le contrat de timing data-*, clips, pistes) | /hyperframes-core puis /hyperframes-animation : skills/hyperframes-core/, skills/hyperframes-animation/ |
| Parcourir / installer des blocs et composants | Répertoires du registre registry/{blocks,components} ou hyperframes.heygen.com/catalog ; installer + câbler via /hyperframes-registry et npx hyperframes add [block] |
| Rendu / prévisualisation / lint / validation d'une composition | /hyperframes-cli : npx hyperframes preview, npx hyperframes lint && npx hyperframes validate, npx hyperframes render, npx hyperframes doctor |
| BGM / SFX / voix off / icônes / suppression d'arrière-plan pour une composition | /media-use : skills/media-use/ |
| Deck / diaporama, promo produit, PR-to-video, synchronisé musique, visite de site web, portage Remotion | La compétence de workflow correspondante dans skills/ (voir l'aide-mémoire du routeur /hyperframes) |
Quand NE PAS utiliser (ligne rouge StayFrame)
L'étoile polaire esthétique du fil d'actualité StayFrame (ADR 0002, minimal-éditorial — "cela passerait-il inaperçu dans la grille Aman/Soneva ?") rend les styles de graphiques animés lourds HORS-MARQUE : légendes cinétiques style Hormozi, blocs glitch/VFX, bandeaux d'actualités, widgets en verre liquide. Pour les reels StayFrame, utilisez HyperFrames uniquement pour des superpositions minimales SUBTILES, et :
- Les superpositions de texte statiques restent sur la voie existante — Chrome sans tête + ffmpeg via
/jstack-sf-caption. Ne migrez pas cela vers HyperFrames. - La vidéo générative (i2v/t2v) n'est jamais HyperFrames — c'est
/vidgen.
Pièges
hyperframes initn'a pas de drapeau--yes(erreur sur les drapeaux inconnus) ; il est déjà non interactif.- Effet secondaire de
init: installe/rafraîchit les compétences principales d'HyperFrames dans~/.claude/skills/et~/.agents/skills/— attendu, maintient le routeur amont à jour. - Installation autonome des compétences :
npx skills add heygen-com/hyperframes --full-depth— gardez--full-depthsinon vous obtenez un blob de registre skills.sh obsolète qui retardemain. - La télémétrie est activée par défaut ; désactivez-la avec
hyperframes telemetry disable. - La sortie du rendu atterrit dans
renders/[projet]_[horodatage].mp4dans le répertoire du projet.
Compétences suivantes
| Suivante | Quand |
|---|---|
/vidgen | La composition a besoin de séquences générées (clips i2v/t2v) comme média source — la génération vidéo y est toujours routée, jamais directement vers un backend. |
/jstack-sf-caption | Un reel StayFrame a besoin de superpositions de texte statiques simples — cette voie reste sur Chrome sans tête + ffmpeg, pas HyperFrames. |
/jstack-sf-trim-stitch | Une superposition/carte de fin HyperFrames rendue doit être assemblée dans un reel StayFrame. |