Le déclencheur — avant toute composition
Déclencheur littéral : la livraison EST un fichier média rendu. MP4, WebM, MOV, PNG. Format de la livraison, jamais apparence.
N'active pas cette skill :
- Vidéo utilisée dans un site — hero, background, témoignage. Il s'agit d'un actif web
classique, traité comme n'importe quelle image ou police (voir
referencias/assets.md). - Pièce d'UI animée qui "ressemble à une vidéo" mais est interactive — c'est du motion ou 3D d'interface, pas un rendu.
La distinction porte sur le format de la livraison. Si le résultat s'ouvre dans le navigateur et répond au clic, ce n'est pas cette skill.
Format, résolution, fps et durée n'ont pas de valeur par défaut
Choisir "1080p 30fps parce que c'est courant" est exactement ce que le déclencheur est censé empêcher. Les quatre champs — format, résolution, fps et durée — remontent à l'utilisateur avant le début de la composition.
Coût opérationnel — confirmez avant de vous engager
HyperFrames n'est pas un import : c'est un processus de production. Il dépend de l'installation de Chrome et FFmpeg, et la capture peut être distribuée.
Confirmez que l'infrastructure existe avant de promettre la route. Découvrir au moment du rendu que FFmpeg manque, c'est découvrir après que la composition entière a été écrite.
Le rendu n'est jamais automatique
Aucune exécution de rendu ne se fait sans autorisation explicite de l'utilisateur. Le rendu consomme du temps machine et, lorsqu'il implique la génération de médias, de l'argent réel.
Lorsqu'un actif manque et que l'alternative est de le générer : nommez ce qui manque et ce qui serait généré — et arrêtez-vous là.
Comment utiliser
frontend-video/
├── SKILL.md ← ce fichier. Le SEUL toujours lu
└── referencias/
├── hyperframes.md le déclencheur, format/fps/durée, temps déterministe,
│ adaptateurs, sous-titres, autorisation de rendu
├── direcao-visual.md tokens avec raison écrite, anti-générique
├── assets.md origine, licence, optimisation — ici l'actif EST la livraison
└── validacao.md les déclencheurs applicables au média
| Votre tâche | Ouvrez |
|---|---|
| décider format, résolution, fps, durée | hyperframes.md §3 |
| contenu, polices, sous-titres, droits | hyperframes.md §4 |
| temps déterministe, sortie reproductible, adaptateurs de scène | hyperframes.md §5 |
| accessibilité et performance de la pièce | hyperframes.md §6 |
| autoriser le rendu | hyperframes.md §7 |
| direction esthétique de la composition | direcao-visual.md |
| licence d'image, police, piste | assets.md |
| finaliser la livraison | validacao.md |
Toujours ignorer : SEO, DOM indexable, parcours de navigation et états d'application — le média déterministe n'a aucun des quatre. L'exécution web comme livraison finale ne s'applique pas non plus : ice, le navigateur est un outil de capture, pas la destination.
Reproductibilité — ce que "déterministe" exige réellement
Le moteur rend la composition cherchable par temps. Cela seul ne garantit pas une sortie identique.
Promettre un fichier reproductible octet par octet nécessite de fixer tous ces éléments : HyperFrames, Chrome, FFmpeg, polices, actifs, codec et flags, résolution, fps, durée et environnement. Même un commit sans ce verrou n'autorise pas la promesse.
Source auditée : dépôt heygen-com/hyperframes, commit
af1cb1c10da33bade100db8233435c7591b7c0bc, paquets principaux 0.8.17 dans ce commit,
licence Apache-2.0 à la racine et dans le CLI. Vérifié le 2026-08-28. Réauditer si la version change
ou si la composition dépend d'une capacité non couverte par les fiches.
Ce qui vaut toujours
- Contenu réel, jamais inventé — sans placeholder qui semble final.
- Sous-titres et contraste font partie de la livraison, ce ne sont pas des suppléments.
- Validation sur la sortie réelle, jamais sur l'aperçu. Ce que l'aperçu montre et ce que le fichier final contient divergent — codec, couleur et timing entre eux.
- Le code de scène auteur reste responsable de son propre nettoyage. Une scène Three/WebGL dans la composition nécessite un teardown comme partout ailleurs.