Installations de plugins : Avant les commandes de configuration ou de mise à jour, suivez les règles d'exécution des plugins lorsque ce skill se trouve à l'intérieur d'un plugin HyperFrames. Les installations autonomes conservent les instructions de mise à jour ci-dessous.
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, il actualise ce skill ainsi que les skills de domaine de base dont il dépend, avant que vous ne comptiez sur eux.
Source figma: Si le logo/actif/animation à construire provient d'une URL figma.com, exécutez
/figmad'abord — exportation des actifs, jetons de marque et traduction Motion→GSAP si le graphique est une importation Figma Motion — puis construisez à partir de sa sortie. N'utilisez pas les outils MCP bruts pour piloter Figma directement : cela contourne l'assainissement SVG, la provenance.media/manifest.jsonlet la liaisonvar()des jetons de marque, de sorte qu'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 court graphique animé, conçu et sans narration (le mouvement est le message ; ~moins de 10s, sans voix off). Tout élément plus long, narré ou multi-scène — ou toute incertitude → lisez/hyperframesd'abord : la couche d'intention possède chaque décision de routage.
Ce flux de travail est autonome par conception — au plus une question de clarification (agents/director.md), puis construction via vérification sans révision intermédiaire. La couche d'intention (/hyperframes → references/intent-interview.md) achemine directement ici sans questions sur la forme d'exécution ; un storyboard et une session de compagnon ajoutent peu à un élément aussi court. Le rendu est toujours verrouillé par l'utilisateur : après la réussite des vérifications et des instantanés de validation, 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 directeur.
Un graphique animé court et conçu. Actif d'abord : décidez de la stratégie d'actif et trouvez 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/<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 ? + classer + stratégie d'actif | shot-plan.json (brouillon : catégorie, requêtes asset_needs, brief) | agents/director.md (Partie 1) |
| source ◇ | Bash — résolution d'utilisation des médias (ignorer si asset_needs est vide) | assets/ + assets/index.md | phases/source/guide.md |
| design | sous-agent — conception du plan autour des actifs 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, instantanés de validation ; réparation en cas d'échec | snapshots/contact-sheet.jpg | Étape 5 |
| approve | Ouvrir l'aperçu ; demander le rendu ou des changements ; 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 actifs. Les catégories purement code/texte (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 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 que la recherche retourne. Chaque catégorie est un categories/<id>/module.md (ses règles de planification + construction) ; le vocabulaire de mouvement partagé vit dans references/motion-vocabulary.md (→ règles/plans directeurs hyperframes-animation + blocs de 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 priorisant le mouvement | blocs caption-* + règles d'animation |
stat | numéro 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 / 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 emplacement (couche vectorielle, ou couche de fond de carte intégrée) | famille us-map / world-map + bake-basemap.mjs |
Catégories axées sur la recherche — chercher 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, 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 l'actif 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 (solutions de repli locales si non définies) — nécessaires uniquement pour les catégories qui recherchent/génèrent des actifs via l'utilisation des médias :
| Clé | Utilisée pour | Repli |
|---|---|---|
GEMINI_API_KEY / GOOGLE_API_KEY | génération d'images (résolution d'utilisation des médias) | ignorer la génération / recherche uniquement |
| (fournisseurs asset_scout / recherche) | recherche d'actifs réels webpage/news/tweet + asset-fusion | la catégorie se dégrade en sans actif |
Flux
Étape 0 — Initialiser
cwd 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 ou un horodatage.
Uniquement 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 derniers sur GitHub et met à jour l'ensemble global si l'un d'eux est obsolète.
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 — Planifier (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 / 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 axé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 — Source ◇ (Bash : utilisation des médias, conditionnel)
Si shot-plan.json.asset_needs n'est pas vide, résoudre les actifs (recherche / génération / récupération → chemins locaux figés dans le projet + registre). Voir phases/source/guide.md (encapsule media-use resolve ; les catégories axées sur la recherche utilisent la recherche actualité/web/tweet/image). Si asset_needs est vide, passer à l'étape 3.
Dégrader gracieusement : si une recherche/un fournisseur est indisponible, la catégorie revient à sans actif (le noter dans context.log).
Étape 3 — Concevoir (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 actifs disponibles : choisir le(s) bloc(s) de catalogue + les règles/plans directeurs hyperframes-animation, la disposition, 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 — Construire (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 timeline.
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> + personnaliser sur place ; n'écrire à la main que les lacunes + l'affordance de fusion d'actifs. 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érifier (Bash → sous-agent de réparation en cas d'échec)
(cd "$PROJECT_DIR" && npx hyperframes check .)
(cd "$PROJECT_DIR" && npx hyperframes snapshot --at <instants-de-preuve>)
Choisissez des instants de preuve qui montrent l'état d'ouverture, le mouvement signature et la tenue finale. Inspectez la feuille de contact ou d'instantané générée avant de continuer. En cas d'échec de lint, check ou d'instantané, lancez le sous-agent de réparation (agents/finalize.md) pour un seul passage de correction sur place, puis réexécutez la porte défaillante. Ne modifiez jamais une durée fixe uniquement pour masquer un défaut.
Étape 6 — Approuver et rendre (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, la composition ou l'identifiant de l'image, les instants de preuve et la feuille de contact ou d'instantané inspectée. Les indicateurs se trouvent dans /hyperframes-cli → references/preview-render.md.
Tableau de reprise
| État | Continuer à partir de |
|---|---|
pas de shot-plan.json | Étape 1 (planifier) |
shot-plan.json a asset_needs, pas de assets/ | Étape 2 (source) |
shot-plan.json final, pas de compositions/index.html | Étape 3/4 (concevoir+construire) |
compositions/index.html existe, instantanés de validation absents | Étape 5 (vérifier) |
| vérifications et instantanés de validation réussis, aucun 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 des actifs en premier
…