Installation de plugins : Avant les commandes d'installation ou de mise à jour, suivez les règles d'exécution des plugins lorsque ce skill fait partie d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Tout d'abord, gardez ce skill à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update motion-graphics. Une opération rapide sans effet si tout est à jour ; sinon, cela rafraîchit ce skill ainsi que les skills de base dont il dépend avant de les utiliser.
source figma : Si le logo/asset/l'animation à construire provient d'une URL figma.com, exécutez
/figmaen premier — exportation d'assets, 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 contourne l'assainissement SVG, la provenance.media/manifest.jsonlet la liaisonvar()des jetons de marque, donc un changement de marque ultérieur ne peut 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 crée un motion graphic court, design-driven 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/hyperframesd'abord : la couche d'intention possède chaque décision d'acheminement.
Ce workflow est autonome par conception — au plus une question de clarification (agents/director.md), puis construisez 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 de l'exécution ; un storyboard et une session compagnon ajoutent peu à un morceau aussi court. Le rendu est toujours soumis à l'approbation de l'utilisateur : après la réussite des contrôles et des captures d'écran de vérification, ouvrez l'aperçu Studio et posez la question canonique « rendre maintenant, ou quels changements ? » de ../hyperframes/references/brief-contract.md. Lorsqu'un BRIEF.md existe, lisez-le avant la question du réalisateur.
Un motion graphic court et design-driven. Priorité aux assets : décidez de la stratégie d'assets 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/<project-name>/ (créé à l'étape 0) ; tous les chemins ci-dessous sont relatifs à celui-ci.
| 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 d'assets | shot-plan.json (brouillon : catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| sourcer ◇ | Bash — résolution des assets media-use (sauter si asset_needs est vide) | assets/ + assets/index.md | phases/source/guide.md |
| design | sous-agent — conception du plan autour des assets résolus | 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, captures de vérification ; réparation en cas d'échec | snapshots/contact-sheet.jpg | Étape 5 |
| approve | Ouvrez l'aperçu ; demandez le rendu ou les modifications ; attendez la réponse | approbation explicite du rendu | Étape 6 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov pour la superposition) | renders/video.mp4 ou superposition transparente | Étape 6 |
◇ sourcer ne s'exécute que lorsque la catégorie choisie déclare des assets. Les catégories purement textuelles/de code (par ex. kinetic-type, la plupart des charts/stat) ont asset_needs: [] et passent directement de la planification à la conception.
Catégories — réparties 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 basées sur la recherche, par 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 | S'appuie sur |
|---|---|---|
kinetic-type | ligne / citation / titre percutant, texte prioritaire au mouvement | blocs caption-* + règles d'animation |
stat | numéro héros 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 / habillage de marque (logo utilisateur) | logo-outro / rules/svg-path-draw |
lower-thirds | barres de nom / titre, callouts, superpositions sociales | caption-* + blocs de superposition du registre |
maps | mouvement géographique — mettre en évidence des régions, connecter des lieux, zoomer sur un endroit (couche vectorielle, ou couche de fond de carte intégrée) | famille us-map / world-map + bake-basemap.mjs |
Catégories basées sur la recherche — rechercher d'abord, puis animer selon le type de contenu (chemin RWA) :
| Contenu retourné | Catégorie | Animation |
|---|---|---|
| page web / lien | webpage | animation de page web / UI (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 tweet animée |
| image / entité | asset-fusion | la géométrie de l'asset devient le graphique (fusion diégétique RWA) |
Ordre de construction : un à la fois, priorité à la couverture (l'ébauche 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 (alternatives locales si non définies) — uniquement nécessaires pour les catégories qui génèrent/procurent des assets via media-use :
| Clé | Utilisée pour | Alternative |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'images (résolution media-use) | sauter la génération / recherche uniquement |
| (fournisseurs de recherche d'assets) | recherche d'assets réels pour webpage/news/tweet + asset-fusion | la catégorie se dégrade en version sans asset |
Flux
Étape 0 — Initialisation
Le répertoire de travail courant est la racine de l'espace de travail de l'agent ; écrivez tous les artefacts sous PROJECT_DIR = videos/<project-name>/. <project-name> : utilisez le répertoire donné par l'utilisateur, sinon un nom court en kebab-case dérivé de l'intention (<sujet>-motion). Pas le nom de base de l'espace de travail ni un horodatage.
Seulement lorsque $PROJECT_DIR/hyperframes.json est absent :
PROJECT_DIR="${MOTION_GRAPHICS_DIR:-videos/<project-name>}"
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 dernières versions sur GitHub et met à jour l'ensemble global si certains sont obsolètes.
Contraintes : ne jamais exécuter hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre dossier hyperframes/ à l'intérieur de PROJECT_DIR ; chaque commande Bash (maître + sous-agents) est un sous-shell (cd "$PROJECT_DIR" && ...) — jamais de cd nu.
Étape 1 — Planification (sous-agent : Réalisateur Partie 1)
Lancez un sous-agent. invite = contenu complet de agents/director.md + ## Contexte de répartition (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 / maps) ; 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 basée sur 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 / maps) ; 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 — Approvisionnement ◇ (Bash : media-use, conditionnel)
Si shot-plan.json.asset_needs n'est pas vide, résolvez les assets (recherche / génération / récupération → chemins locaux gelés du projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories basées sur la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passez à l'étape 3.
Dégradez-vous gracieusement : si un moteur de recherche/fournisseur est indisponible, la catégorie revient à une version sans asset (notez-le dans context.log).
Étape 3 — Conception (sous-agent : Réalisateur Partie 2)
Lancez un sous-agent (invite = agents/director.md Partie 2 + contexte de répartition incluant le assets/index.md résolu si l'étape 2 a été exécutée + catalog-map.md). Il conçoit le plan autour des assets disponibles : choisir le(s) bloc(s) du catalogue + les règles/plans directeurs de hyperframes-animation, la disposition, le mouvement, les temps forts, et (pour asset-fusion) les element_positions + la 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)
Incluez les principes de mouvement partagés dans le contexte de répartition du Constructeur. Pour charts et stat, incluez également les données en mouvement. Le Constructeur lit ces guides avant d'écrire la timeline.
Lancez un sous-agent. invite = contenu complet de agents/builder.md + contexte de répartition (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> + personnalisation sur place ; n'écrivez manuellement que les lacunes + l'élément de fusion d'asset. Sortie compositions/index.html respectant le contrat HF (timeline GSAP en pause sur window.__timelines, class="clip" + identifiants 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 check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <temps_de_preuve>)
Choisissez des temps de preuve qui montrent l'état d'ouverture, le mouvement signature et la tenue finale. Inspectez la feuille de contact ou de capture générée avant de continuer. En cas d'échec de lint, check ou de capture, lancez le sous-agent de réparation (agents/finalize.md) pour un passage de correction sur place, puis réexécutez la porte défaillante. Ne modifiez jamais une durée fixe simplement pour masquer un défaut.
Étape 6 — Approbation et rendu (Bash)
Ouvrez Studio, puis posez une question : « rendre maintenant, ou quels changements ? » Après les révisions, revenez à la même porte :
(cd "$PROJECT_DIR" && npx hyperframes preview --background)
Rendez 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 superposition transparente : --format webm (ou mov)
Vérifiez 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 la composition ou de l'image, les temps de preuve, et la feuille de contact ou de capture inspectée. Les drapeaux se trouvent dans /hyperframes-cli → references/preview-render.md.
Tableau de reprise
| État | Continuer à partir de |
|---|---|
pas de shot-plan.json | Étape 1 (planification) |
shot-plan.json a asset_needs, pas de assets/ | Étape 2 (approvisionnement) |
shot-plan.json final, pas de compositions/index.html | Étape 3/4 (conception+construction) |
compositions/index.html existe, captures de vérification absentes | Étape 5 (vérification) |
| contrôles et captures de vérification réussis, pas de rendu approuvé | Étape 6 (approbation) |
| rendu approuvé existe | vérifier la sortie, puis signaler |
Notes de conception (mainteneurs — l'exécution ne lit pas ceci)
- Rationnement prioritaire des assets