Avant tout, gardez ce skill à jour — exécutez-le en silence, ne demandez pas :
npx hyperframes skills update motion-graphics. Une opération rapide et sans effet lorsque tout est à jour ; sinon, cela rafraîchit ce skill ainsi que les skills du domaine de base dont il dépend, avant que vous ne vous appuyiez dessus.
source figma : Si le logo/la ressource/l'animation à construire provient d'une URL figma.com, exécutez
/figmaen premier — exportation des ressources, jetons de marque, et traduction Motion→GSAP si le graphique est une importation Figma Motion — puis construisez à partir de sa sortie. Ne pilotez pas Figma directement via les outils MCP bruts : cela contournerait la sanitisation SVG, la provenance.media/manifest.jsonl, et la liaisonvar()des jetons de marque, de sorte qu'un changement ultérieur de marque ne pourrait pas se propager sans une réimportation complète.
motion-graphics — point d'entrée de répartition
La porte d'entrée est
/hyperframes. Ce skill réalise un motion design court, dirigé par le design et non narré (le mouvement est le message ; ~moins de 10s, sans voix off). Tout ce qui est plus long, narré ou multi-scène — ou en cas d'incertitude → lisez/hyperframesen premier : la couche d'intention possède chaque décision de routage.
Ce workflow est autonome par conception — au plus une question de clarification (agents/director.md), puis construction jusqu'à la vérification sans révision intermédiaire. La couche d'intention (/hyperframes → references/intent-interview.md) achemine directement ici sans questions sur la forme du rendu ; un storyboard et une session d'accompagnement apportent peu à un morceau aussi court. Le rendu est toujours contrôlé par l'utilisateur : après la réussite des vérifications et des clichés de validation, posez la question canonique « aperçu d'abord, ou rendu ? » de ../hyperframes-core/references/brief-contract.md. Lorsqu'un BRIEF.md existe, lisez-le avant la question du réalisateur.
Un motion design court et dirigé par le design. Priorité aux ressources : décidez de la stratégie de ressources et procurez-vous le matériel réel avant de concevoir le plan, puis concevez le plan autour de ce que vous avez, puis composez en réutilisant les capacités du catalogue. Tous les artefacts vont dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'étape 0) ; tous les chemins ci-dessous lui sont relatifs.
| Phase | Exécution | Artefact principal | Flux détaillé |
|---|---|---|---|
| init | Bash | hyperframes.json | Étape 0 |
| plan | sous-agent — décider de la recherche ? + classifier + stratégie de ressources | shot-plan.json (brouillon : catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| source ◇ | Bash — résolution d'usage des médias (passer si asset_needs est vide) | assets/ + assets/index.md | phases/source/guide.md |
| design | sous-agent — conception du plan autour des ressources résolues | shot-plan.json (final : bloc(s) + disposition + mouvement + positions) | agents/director.md (Partie 2) |
| build | sous-agent — composition priorisant la réutilisation | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, clichés de validation ; réparation en cas d'échec | snapshots/contact-sheet.jpg | Étape 5 |
| approve | Demander un aperçu ou un rendu ; attendre la réponse | approbation explicite du rendu | Étape 6 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov pour overlay) | renders/video.mp4 ou overlay transparent | Étape 6 |
◇ source s'exécute uniquement lorsque la catégorie choisie déclare des ressources. Les catégories de code/texte pur (par ex. kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.
Catégories — divisées par la décision de recherche
La première décision de plan est : cela nécessite-t-il une recherche ? Cette bifurcation sépare les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories guidées par la recherche, selon le type de contenu renvoyé par la recherche. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé réside dans references/motion-vocabulary.md (→ règles/plans directeurs hyperframes-animation + blocs du registre).
Catégories de forme — pas de recherche ; l'utilisateur fournit le contenu :
| Catégorie | Intention | Repose sur |
|---|---|---|
kinetic-type | ligne percutante / citation / titre, texte prioritaire du mouvement | blocs caption-* + règles d'animation |
stat | nombre héroïque unique / compteur + anneau | apple-money-count / rules/{counting-dynamic-scale, stat-bars-and-fills} |
charts | barre / ligne / camembert / course / % à partir de données | bloc data-chart |
logo-reveal | logo sting / lockup de marque (logo utilisateur) | logo-outro / rules/svg-path-draw |
lower-thirds | barres de nom / titre, callouts, overlays sociaux | caption-* + blocs d'overlay du registre |
maps | mouvement géographique — mettre en évidence des régions, connecter des lieux, zoomer sur un emplacement (couche vectorielle, ou couche de fond de carte intégré) | famille us-map / world-map + bake-basemap.mjs |
Catégories guidées par la recherche — rechercher d'abord, puis animer selon le type de contenu (le chemin RWA) :
| Contenu retourné | Catégorie | Animation |
|---|---|---|
| page web / lien | webpage | animation de page web / interface utilisateur (défilement, révélation, curseur, callouts) |
| article de presse | news | révélation de titre + carte source + callouts de faits clés |
| tweet | tweet | carte de tweet animée |
| image / entité | asset-fusion | la géométrie de la ressource devient le graphique (fusion diégétique RWA) |
Ordre de construction : un à la fois, priorité à la couverture (l'approximation est acceptable). kinetic-type porté depuis le prototype ; le reste suit.
Prérequis
macOS Apple Silicon ou Linux x64. Outils système : brew install node ffmpeg. npx hyperframes doctor une fois. Rendu GPU macOS : export PRODUCER_BROWSER_GPU_MODE=hardware.
Clés optionnelles (fallbacks locaux si non définies) — uniquement nécessaires pour les catégories qui se procurent/génèrent des ressources via l'usage des médias :
| Clé | Utilisé pour | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'images (résolution d'usage des médias) | passer génération / recherche uniquement |
| (fournisseurs de recherche asset_scout) | recherche de ressources réelles pour webpage/news/tweet + asset-fusion | la catégorie se dégrade en version sans ressources |
Flux
Étape 0 — Initialisation
cwd est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<nom-du-projet>/. <nom-du-projet> : utilisez le répertoire donné par l'utilisateur, sinon un court nom en kebab-case dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni un horodatage.
Uniquement lorsque $PROJECT_DIR/hyperframes.json est absent :
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --example=blank --skill=motion-graphics
init vérifie les skills installés par rapport aux plus récents sur GitHub et met à jour l'ensemble global si certains sont obsolètes.
Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais cd nu.
Étape 1 — Planification (sous-agent : Directeur Partie 1)
Lancez un sous-agent. invite = agents/director.md complet + ## Contexte d'envoi (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schema: <SKILL_DIR>/references/shot-plan-ir.md). Il doit :
- Décider : cela nécessite-t-il une recherche ? (la première bifurcation)
- Non → choisir une catégorie de forme (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
asset_needs: []. - Oui → émettre un plan de recherche dans
asset_needs[](actualité / web / tweet / image ; requêtes bipolaires). La catégorie guidée par la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu retourné à l'étape 2, et finalisée à l'étape 3.
- Non → choisir une catégorie de forme (kinetic-type / stat / charts / logo-reveal / lower-thirds) ; le contenu est fourni par l'utilisateur ;
- Écrire un brouillon de
shot-plan.json(enveloppe + catégorie de forme choisie ou intention de recherche +asset_needs+ un brief de plan d'un paragraphe). Schéma :references/shot-plan-ir.md.
Validation : [ -s "$PROJECT_DIR/shot-plan.json" ] && echo ok || echo manquant.
Étape 2 — Source ◇ (Bash : usage des médias, conditionnel)
Si shot-plan.json.asset_needs n'est pas vide, résoudre les ressources (recherche / génération / récupération → chemins figés locaux au projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories guidées par la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passer à l'étape 3.
# illustratif — voir phases/source/guide.md
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/source/resolve.mjs --plan ./shot-plan.json --out ./assets)
Se dégrader gracieusement : si un fournisseur de recherche est indisponible, la catégorie revient à une version sans ressources (le noter dans context.log).
Étape 3 — Conception (sous-agent : Directeur Partie 2)
Lancez un sous-agent (invite = agents/director.md Partie 2 + contexte d'envoi incluant le assets/index.md résolu si l'étape 2 a eu lieu + catalog-map.md). Il conçoit le plan autour des ressources disponibles : choisir le(s) bloc(s) du catalogue + les règles/plans directeurs hyperframes-animation, la disposition, le mouvement, les temps forts, et (pour asset-fusion) les element_positions + palette de l'outil pipette. Finalise shot-plan.json (content.block + content.customize + contenu par catégorie).
Étape 4 — Construction (sous-agent : Constructeur, priorité à la réutilisation)
Lancez un sous-agent. invite = agents/builder.md complet + contexte d'envoi (shot-plan.json, catalog-map.md, le module.md de la catégorie, references/motion-vocabulary.md, references/builder-contract.md). Priorité à la réutilisation : npx hyperframes add <block> + personnaliser sur place ; n'écrire à la main que les lacunes + l'affordance de fusion de ressources. Sortie compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + ids stables, tl.seek(0), déterministe).
Étape 5 — Vérification (Bash → sous-agent de réparation en cas d'échec)
(cd "$PROJECT_DIR" && npx hyperframes lint .)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <temps-de-validation>)
Choisir des temps de validation qui montrent l'état d'ouverture, le mouvement signature, et la tenue finale. Inspecter la feuille de contact ou de clichés générée avant de continuer. En cas d'échec de lint, check, ou de cliché, lancer le sous-agent de réparation (agents/finalize.md) pour un seul passage de correction sur place, puis réexécuter la porte défaillante. Ne jamais modifier une durée fixe uniquement pour cacher un défaut.
Étape 6 — Approbation et rendu (Bash)
Poser une question : « aperçu d'abord, ou rendu ? » Si l'utilisateur choisit l'aperçu, ouvrir Studio et revenir à la même porte d'approbation après les révisions :
(cd "$PROJECT_DIR" && npx hyperframes preview)
Effectuer le rendu uniquement après une réponse explicite de rendu :
(cd "$PROJECT_DIR" && npx hyperframes render . --skill=motion-graphics -q high -o ./renders/video.mp4)
# variante overlay transparent : --format webm (ou mov)
Vérifier que la sortie existe, n'est pas vide et a la durée prévue. La remise finale nomme l'artefact, la durée réelle, l'identifiant de composition ou de trame, les temps de validation, et la feuille de contact ou de clichés inspectée. Les drapeaux se trouvent dans /hyperframes-cli → references/preview-render.md.
Tableau de reprise
| État | Continuer depuis |
|---|---|
pas de shot-plan.json | Étape 1 (planification) |
shot-plan.json a asset_needs, pas de assets/ | Étape 2 (source) |
shot-plan.json final, pas de compositions/index.html | Étape 3/4 (conception+construction) |
compositions/index.html existe, clichés de validation absents | Étape 5 (vérification) |
| vérifications et clichés de validation réussis, aucun rendu approuvé | Étape 6 (approbation) |
| rendu approuvé existe | vérifier la sortie, puis faire rapport |
Notes de conception (mainteneurs — l'exécution ne lit pas ceci)
- Raisonnement de la priorité aux ressources : la recherche de ressources est faite en amont et informe la conception du plan (le flux RWA : analyser → rechercher → examiner → composer). Les catégories guidées par la recherche (
webpage/news/tweet) etasset-fusions'appuient toutes sur la recherche d'usage des médias (actualités/web/tweet/image), qui est la lignée RWA documentée de media-use. - Priorité à la réutilisation : l'analogue dans l'écosystème des modèles générés par LLM est "composer"