Communitygithub.com

jonosin/jstack

Routeur léger vers HeyGen HyperFrames — le moteur de graphiques animés natif HTML (écrivez du HTML, rendez des MP4 déterministes localement via Chrome sans tête + FFmpeg).

Qu'est-ce que jstack ?

Cette compétence agit comme un routeur minimal vers HeyGen HyperFrames, un moteur de graphiques animés open-source (Apache-2.0) qui transforme des compositions HTML/CSS/JS en vidéos MP4 déterministes. Le rendu s'effectue localement en parcourant chaque image dans Chrome sans tête et en encodant avec FFmpeg. La compétence ne contient pas elle-même de logique métier ; elle oriente simplement l'utilisateur vers l'un des 20 workflows spécialisés situés dans le dépôt cloné (comme `/motion-graphics` pour les titres animés, `/embedded-captions` pour les sous-titres cinétiques, ou `/hyperframes-cli` pour le rendu et la validation). Elle est conçue pour être utilisée sur les plateformes d'agents AI (Claude Code, Cursor, Codex) où les utilisateurs expriment le besoin de créer des animations, des incrustations, des cartes de fin, des tiers inférieurs, ou de convertir du HTML en vidéo. La compétence inclut une table de routage détaillée et rappelle les cas où HyperFrames ne doit pas être utilisé (vidéo générative ou superpositions textuelles statiques pour StayFrame).

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/jonosin/jstack/tree/HEAD/skills/hyperframe

Demander à votre IA préférée

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

Documentation

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.

QuoiOù
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 blocshyperframes.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.

IntentionAller 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 parlanteWorkflow /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 composantsRé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 RemotionLa 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 init n'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-depth sinon vous obtenez un blob de registre skills.sh obsolète qui retarde main.
  • 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].mp4 dans le répertoire du projet.

Compétences suivantes

SuivanteQuand
/vidgenLa 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-captionUn reel StayFrame a besoin de superpositions de texte statiques simples — cette voie reste sur Chrome sans tête + ffmpeg, pas HyperFrames.
/jstack-sf-trim-stitchUne superposition/carte de fin HyperFrames rendue doit être assemblée dans un reel StayFrame.

Skills associés