Installation des plugins : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution des plugins lorsque cette compétence se trouve dans un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
Tout d'abord, gardez cette compétence à jour — confirmez avec l'utilisateur avant d'exécuter :
npx hyperframes skills update motion-graphics. Une opération rapide sans effet lorsque tout est à jour ; sinon, cela rafraîchit cette compétence ainsi que les compétences de domaine principales dont elle dépend avant de vous y fier.
source figma : Si le logo/élément/animation à construire provient d'une URL figma.com, exécutez
/figmaen premier — exportation des éléments, jetons de marque, et traduction Motion→GSAP si le graphique est une importation Figma Motion — puis construisez à partir de sa sortie. N'utilisez pas directement les outils MCP bruts pour piloter Figma : cela contourne la désinfection SVG, la provenance.media/manifest.jsonl, et la liaison des jetons de marquevar(), de sorte qu'un changement ultérieur de marque 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. Cette compétence crée un court graphisme animé, axé sur le design, sans narration (le mouvement est le message ; ~moins de 10s, sans voix off). Tout ce qui est plus long, narré, ou multi-scènes — ou toute incertitude → lisez/hyperframesd'abord : la couche d'intention possède chaque décision d'acheminement.
Ce flux de travail 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 ici directement sans questions sur la forme du déroulement ; un storyboard et une session d'accompagnement apportent peu à un clip aussi court. Le rendu est toujours contrôlé par l'utilisateur : après que les vérifications et les captures d'écran de validation ont réussi, ouvrez la prévisualisation 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 directeur.
Un court graphisme animé axé sur le design. D'abord les éléments : décidez de la stratégie d'éléments et sourcez du 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 d'éléments | shot-plan.json (brouillon : catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| source ◇ | Bash — résolution des médias (sauter si asset_needs est vide) | assets/ + assets/index.md | phases/source/guide.md |
| design | sous-agent — conception du plan autour des éléments résolus | shot-plan.json (final : bloc(s) + mise en page + mouvement + positions) | agents/director.md (Partie 2) |
| build | sous-agent — composition en priorisant la réutilisation | compositions/index.html | agents/builder.md |
| verify | Bash — lint, check, captures de validation ; réparation en cas d'échec | snapshots/contact-sheet.jpg | Étape 5 |
| approve | Ouvrir la prévisualisation ; demander rendu ou modifications ; attendre la réponse | approbation explicite du rendu | Étape 6 |
| render | Bash — hyperframes render (MP4, ou --format webm/mov pour superposition) | renders/video.mp4 ou superposition transparente | Étape 6 |
◇ source s'exécute uniquement lorsque la catégorie choisie déclare des éléments. Les catégories purement code/texte (par exemple 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 divise les catégories en deux groupes ; ensuite, la catégorie spécifique est choisie — pour les catégories axé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é se trouve dans references/motion-vocabulary.md (→ règles/plans hyperframes-animation + blocs de registre).
Catégories de formulaire — pas de recherche ; l'utilisateur fournit le contenu :
| Catégorie | Intention | S'appuie sur |
|---|---|---|
kinetic-type | ligne percutante / citation / titre, texte priorisant le mouvement | blocs caption-* + règles d'animation |
stat | nombre 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, appels, superpositions sociales | caption-* + blocs de superposition du registre |
maps | mouvement géographique — mettre en évidence des régions, connecter des lieux, zoomer sur un emplacement (couche vectorielle ou fond de carte cuit) | famille us-map / world-map + bake-basemap.mjs |
Catégories axées sur la recherche — rechercher d'abord, puis animer par type de contenu (le chemin RWA) :
| Contenu retourné | Catégorie | Animation |
|---|---|---|
| page web / lien | webpage | animation de page web / UI (défilement, révélation, curseur, appels) |
| article de presse | news | révélation de titre + carte source + appels de faits clés |
| tweet | tweet | carte tweet animée |
| image / entité | asset-fusion | la géométrie de l'élément devient le graphique (fusion diégétique RWA) |
Ordre de construction : un à la fois, priorité à la couverture (l'approximatif suffit). 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) — nécessaires uniquement pour les catégories qui sourcent/génèrent des éléments via media-use :
| Clé | Utilisé pour | Fallback |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'images (résolution media-use) | ignorer la génération / recherche uniquement |
| (fournisseurs asset_scout / recherche) | recherche d'éléments réels pour webpage/news/tweet + asset-fusion | la catégorie se dégrade en sans élément |
Flux
Étape 0 — Initialisation
le répertoire de travail actuel 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 ou 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 compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si certaines sont obsolètes.
Contraintes : ne jamais hyperframes init dans la racine de l'espace de travail ; ne jamais imbriquer un autre hyperframes/ dans 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 : Directeur Partie 1)
Lancez un sous-agent. invite = agents/director.md complet + ## Contexte de répartition (SKILL_DIR / PROJECT_DIR / la demande de l'utilisateur / Schéma : <SKILL_DIR>/references/shot-plan-ir.md). Il doit :
- Décider : cela nécessite-t-il une recherche ? (la première bifurcation)
- Non → choisissez une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps) ; le contenu est fourni par l'utilisateur ;
asset_needs: []. - Oui → émettez un plan de recherche dans
asset_needs[](news / web / tweet / image ; requêtes bipolaires). La catégorie axée sur la recherche spécifique (webpage / news / tweet / asset-fusion) est confirmée par le type de contenu renvoyé à l'Étape 2, et finalisée à l'Étape 3.
- Non → choisissez une catégorie de formulaire (kinetic-type / stat / charts / logo-reveal / lower-thirds / maps) ; le contenu est fourni par l'utilisateur ;
- Écrivez un brouillon de
shot-plan.json(enveloppe + catégorie de formulaire 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 : media-use, conditionnel)
Si shot-plan.json.asset_needs n'est pas vide, résolvez les éléments (recherche / génération / récupération → chemins locaux figés du projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories axées sur la recherche utilisent la recherche d'actualités/web/tweet/image). Si asset_needs est vide, passez à l'Étape 3.
Dégrader élégamment : si une recherche/un fournisseur est indisponible, la catégorie revient à l'absence d'élément (notez-le dans context.log).
Étape 3 — Conception (sous-agent : Directeur 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 éléments disponibles : choisissez le(s) bloc(s) du catalogue + les règles/plans hyperframes-animation, la mise en page, le mouvement, les temps forts, et (pour asset-fusion) les element_positions + la palette de la 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 données en mouvement. Le Constructeur lit ces guides avant d'écrire la chronologie.
Lancez un sous-agent. invite = agents/builder.md complet + 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 à la main que les lacunes + l'affordance de fusion d'éléments. Sortie compositions/index.html respectant le contrat HF (chronologie 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-validation>)
Choisissez des temps de validation qui montrent l'état d'ouverture, le mouvement signature et la tenue finale. Inspectez la feuille de contact ou la feuille de capture générée avant de continuer. En cas d'échec de lint, check ou de la 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)
Rendre 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 validation, 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 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, captures de validation absentes | Étape 5 (vérification) |
| vérifications et captures de validation réussies, pas de rendu approuvé | Étape 6 (approbation) |
| rendu approuvé existe | vérifier la sortie, puis rapporter |
Notes de conception (mainteneurs — l'exécution ne lit pas ceci)
- Rationnement des éléments en premier