Communitygithub.com

motion

Point d'entrée pour tout travail de motion design dans un espace de travail mg (mg.json à la racine) — tiers inférieurs, titres, textes animés, changements de marque, rendus. À lire en premier ; il achemine vers les autres compétences motion-*.

Qu'est-ce que motion ?

Cette compétence définit l'espace de travail Motion, un environnement professionnel de motion design basé sur Remotion et le CLI mg. Elle gère la création de graphismes animés reproductibles (tiers inférieurs, titres, textes cinétiques, logos, etc.) à partir de templates codés et de fichiers de configuration JSON. Le système suit une chaîne de tokens hiérarchique (toolkit → marque maison → client → variante → projet → props de plan) pour séparer strictement les données visuelles du code. Les plateformes supportées incluent Claude Code, Cursor, Codex et tout outil compatible avec les skills d'agent IA. L'utilisateur peut modifier les couleurs, polices ou textes en éditant simplement du JSON et en relançant `pnpm mg render`, sans jamais toucher au code des templates. Une règle fondamentale est que toute valeur visible provient des props ou des tokens, sans aucune valeur codée en dur. Le skill fournit également des commandes pour la validation, la livraison et le rebranding, et oriente vers d'autres compétences spécialisées (motion-brand, motion-project, motion-render, motion-qa) selon la tâche.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ryodeushii/motion-graphics/tree/HEAD/skills/motion

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Espace de travail Motion

Cet espace de travail produit des graphismes animés reproductibles avec Remotion via le CLI mg (pnpm mg <commande>). Les designs sont du code dans des templates ; chaque valeur spécifique à un projet vit dans un fichier JSON. Un changement de texte, de couleur ou de police est une modification JSON suivie de pnpm mg render, jamais une modification de code.

Structure

mg.json                         paramètres vidéo par défaut de l'espace de travail (fps, taille)
brand/house.tokens.json         tokens maison : couleurs de base, polices, easing, durées, zones de sécurité
brand/fonts/  brand/logos/      fichiers référencés par les tokens maison
clients/<client>/
  client.json                   nom d'affichage, éventuel remplacement vidéo
  brand/tokens.json             remplacements client (fusion profonde par-dessus la maison)
  brand/fonts/ brand/logos/
  brand/variants/<variant>/     variante nommée d'aspect alternatif réutilisée par plusieurs projets : tokens.json, fonts/, logos/
  templates/<name>/index.tsx    templates propres au client, id "<client>/<name>"
  projects/<project>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
    tokens.json                 remplacements propres au projet (optionnel)
    tokens.lock.json            présent quand gelé : les rendus ignorent la chaîne active
    fonts/ logos/ assets/       fichiers du projet ; les props référencent les assets comme "asset:<chemin>"
    shots/<plan>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    sortie, git-ignorée ; manifest.json suit les versions

Le code de la boîte à outils (moteur, templates maison, ces compétences) se trouve dans node_modules/motion-toolkit, verrouillé par package.json. Ne jamais l'éditer ici ; les modifications des templates maison vont dans le dépôt de la boîte à outils.

Templates maison

Chaque template maison a une prop look : minimal (propre, graisses légères, flou-montée, sans panneaux), bold (typographie lourde en majuscules, blocs de couleur pleins, effet ressort), corporate (panneaux, barres d'accent, révélations par masque). La valeur par défaut "brand" utilise le jeton look, donc un client définit son style une fois dans brand/tokens.json ("look": "minimal").

IdUtilisation
lower-thirdBandeau nom et titre, logo optionnel
title-cardTitre de chapitre ou de section, accroche et sous-titre optionnels ; superposition ou plein écran
calloutLigne partant d'un point dans la vidéo (x, y en fractions d'image) vers une étiquette
end-cardCarte de fin : logo, titre, CTA, URL, 0–2 emplacements d'écran de fin YouTube
kinetic-textCitation ou déclaration révélée mot par mot ; *mot* met en emphase
logo-stingCourt fondu animé du logo (intro/outro)
counterCompteur numérique montant (value, prefix, suffix, decimals) avec une étiquette
social-handleIcône de plateforme plus @handle dans un coin (YouTube, Instagram, TikTok, X, LinkedIn, …)
typewriterTexte tapé touche par touche avec sons de machine à écrire ou de clavier dans l'audio du rendu
corner-brandingLogo persistant dans n'importe quel coin, tag optionnel tel que EN DIRECT

pnpm mg new-shot … --template <id> écrit chaque prop avec sa valeur par défaut. La signification de chaque prop se trouve dans son texte .describe() dans node_modules/motion-toolkit/templates/<id>/index.tsx.

Chaîne de tokens

boîte à outils → maison → client → variante (si project.json "brand") → project tokens.json → props de plan. La couche boîte à outils ne fournit que des valeurs par défaut (le look, une police mono, des sons de frappe). Les objets fusionnent clé par clé, null supprime une clé héritée, et la couche la plus spécifique gagne. "extends": "none" ignore le client et la variante. Les fichiers de police, logo et son sont recherchés dans le dossier fonts/, logos/ ou sounds/ de la couche la plus spécifique qui les contient.

Règles

  1. Toute valeur visible provient des props de plan ou des tokens. Pas de couleurs, polices, tailles en px sans prop, ou minutages codés en dur dans les templates.
  2. Les projets contiennent des données, pas du code. Un nouveau design est un template ; un nouveau travail est un projet avec des fichiers de plan.
  3. Placez une valeur dans la couche la plus basse qui la possède : un seul plan → props de plan ; un seul projet → tokens.json du projet ; plusieurs projets d'un client → une variante ; tout le client → tokens client.
  4. Ne modifiez jamais tokens.lock.json à la main. Les projets livrés sont gelés ; ils ne changent que via mg rebrand (voir motion-render).
  5. Après chaque modification de JSON ou de template, exécutez pnpm mg check et corrigez ce qu'il signale avant de lancer un rendu.
  6. Terminez chaque changement visuel par la procédure motion-qa avant de le déclarer terminé.
  7. Demandez à l'utilisateur avant mg rebrand --apply et avant de modifier les tokens client ou variante utilisés par des projets gelés.
  8. Si un rendu ou une vérification de diagnostic échoue, exécutez pnpm mg doctor avant de modifier le code.

Routage

TâcheÀ lire
Nouveau client, variante, logo, police, palette de couleursmotion-brand
Nouveau projet ou plans à partir d'un brief ; modifier texte/couleurs sur des plans existantsmotion-project
Nouveau template ou modification de l'animation d'un templatemotion-template, puis motion-style
Sensation de mouvement : easing, timing, décalage, zones de sécuritémotion-style
Rendu, préréglages, versions, livraison, application de changements de marquemotion-render
Vérification du rendu avant remisemotion-qa

Commandes

pnpm mg templates                                  lister les ids de templates
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <client>/<projet> <plan> --template <id>   fichier de plan avec toutes les props par défaut
pnpm mg new-template <client> <nom>                template de démarrage
pnpm mg check [<client> | <client>/<projet>]      valider tout sans rendu
pnpm mg render <client>/<projet> [plan…]           ignore les plans inchangés ; --force, --preset
pnpm mg still <client>/<projet> [plan…]            aperçus PNG sur un damier (tous les plans par défaut)
pnpm mg studio <client>/<projet>                  aperçu en direct ; Studio "Enregistrer" écrit le fichier de plan
pnpm mg deliver <client>/<projet>                 rendu, vérification, gel, copie des finals vers deliver/<date>/
pnpm mg rebrand <client | client/projet> [--apply]   changements de marque pour le travail livré
pnpm mg freeze|unfreeze|diff <client>/<projet>
pnpm mg doctor                                     environnement, mg check, rendu test

Individual skills in this repo

This repo contains 3 individual skills — each has its own dedicated page.

Skills associés