Communitygithub.com

motion-template

Créez ou modifiez un modèle Remotion réutilisable pour motion-toolkit, piloté par des props et des tokens. Utilisez-le lorsqu'aucun modèle existant ne convient ou que l'animation d'un modèle doit être modifiée.

Qu'est-ce que motion-template ?

Cette compétence permet aux développeurs et aux agents IA de créer ou modifier des modèles Remotion réutilisables dans l'écosystème motion-toolkit. Un modèle est un design qui lit les props d'un plan et les tokens résolus, et rien d'autre. Elle couvre l'emplacement des fichiers (client spécifique dans `clients/<client>/templates/` ou maison dans `templates/`), le contrat technique avec `defineTemplate`, la validation des schémas Zod, et l'utilisation exclusive des fonctions Remotion (`useCurrentFrame`, `interpolate`, `spring`) pour des rendus déterministes. La compétence insiste sur la gestion des couleurs via `color(tokens, nameOrHex)`, des polices, des durées et easing via `motion(tokens, fps)`, et des positions via `safeArea(tokens, video)`. Pour la cohérence visuelle, elle introduit les concepts de « looks » (choreo, reveal, typo) et fournit des instructions de vérification (check, still, render). Enfin, elle détaille le processus de travail à partir d'une vidéo de référence (extraction d'images avec ffmpeg, analyse des phases et des courbes).

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

Demander à votre IA préférée

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

Documentation

Modèles

Un modèle est un design réutilisable. Il lit les props d'un plan et les tokens résolus, et rien d'autre. Lisez motion-style avant de choisir les timings ou les easing. Pour les détails de l'API Remotion, utilisez les compétences Remotion si elles sont installées (npx remotion skills add) ou https://www.remotion.dev/docs.

Où le placer

  • Spécifique à un client : commencez par pnpm mg new-template <client> <nom>. Cela génère un squelette fonctionnel dans clients/<client>/templates/<nom>/index.tsx (id <client>/<nom>) qui respecte le contrat ci-dessous ; remplacez son design.
  • Maison (tous les clients) : templates/<nom>/index.tsx dans le dépôt motion-toolkit, enregistré dans templates/index.ts, publié avec une nouvelle version du toolkit. N'écrivez pas dans node_modules.

Avant d'écrire le code d'animation, proposez le schéma (les props que l'utilisateur pourra modifier sans agent) et confirmez-le avec l'utilisateur.

Contrat

import { interpolate, useCurrentFrame } from "remotion";
import { z } from "zod";
import { color, defineTemplate, font, motion, px, safeArea } from "motion-toolkit/engine";

const schema = z.object({
  headline: z.string().min(1).default("Titre"),
  holdSeconds: z.number().positive().default(3),
  accent: z.string().default("accent").describe("Nom du token de couleur ou #hex"),
});

export const template = defineTemplate({
  title: "Carton titre",
  schema,
  durationSeconds: ({ props, tokens }) => {
    const m = motion(tokens, 1);
    return m.seconds("enter") + props.holdSeconds + m.seconds("exit");
  },
  check: ({ props, tokens }) => {
    color(tokens, props.accent); // lève une erreur si le token est inconnu ; s'exécute dans `mg check`
  },
  component: ({ props, tokens, video }) => {
    const frame = useCurrentFrame();
    const m = motion(tokens, video.fps);
    // ...
  },
});

Exigences :

  1. Exportez template (modèles clients) construit avec defineTemplate.
  2. Chaque champ du schéma a une valeur .default() pour que les nouveaux plans et le Studio démarrent valides. Ajoutez .describe() pour le formulaire Studio.
  3. Couleurs via color(tokens, nameOrHex), polices via font(tokens, role), durées et easing via motion(tokens, fps), positions dans safeArea(tokens, video), tailles via px(sizeAt1080, video).
  4. Animer uniquement à partir de useCurrentFrame() avec interpolate/spring. Pas de transitions CSS, setTimeout, Date.now() ou Math.random() (utilisez random(seed) de remotion). Les rendus doivent être identiques à chaque fois.
  5. Laissez l'arrière-plan transparent sauf si le modèle est plein écran ; les tiers inférieurs et les incrustations se rendent avec alpha. Chaque élément doit être invisible sur la dernière image.
  6. Échouez bruyamment : lancez une Error avec une indication de correction lorsque le texte ne tient pas ou qu'un token est manquant. Utilisez assertFits/wrapLines du moteur ; ils mesurent avec la police chargée et lèvent une erreur en cas de débordement.
  7. Les props qui nomment des tokens (couleurs, logos, polices, sons) sont validées dans check avec checkRefs, afin que mg check détecte les fautes de frappe avant le rendu.
  8. durationSeconds et check s'exécutent dans Node (mg check) et avant le chargement des polices : ne mesurez jamais de texte ici.
  9. Images et logos : <Img src={staticFile(tokens.logos[nom])} /> ou staticFile(props.someAsset). Sons : <Html5Audio src={staticFile(fichier)} /> dans une <Sequence from={frame}>, fichiers issus de tokens.sounds[nom]. Le CLI prépare les fichiers.

Looks

Les modèles maison, et les modèles clients destinés à leur correspondre, prennent look: lookSchema et le résolvent avec resolveLook(props.look, tokens). Construisez-les à partir des helpers partagés pour que les trois looks restent cohérents (voir motion-style) :

  • choreo(tokens, look, fps) donne beat(frame, index, exitStart, steps) → { inP, outP } pour chaque élément dans l'ordre d'entrée ; choreoSeconds(...) donne la durée correspondante.
  • reveal(look, beat, video) est le style d'entrée du look pour un élément (entourez-le de overflow: hidden pour corporate).
  • typo(tokens, look, "display" | "title" | "body" | "label", size) est le style typographique du look ; onColor(hex) choisit une couleur de texte lisible sur un bloc de couleur ; cornerPlacement(corner, inset) positionne les graphiques de coin.

Lisez un modèle maison tel que node_modules/motion-toolkit/templates/title-card/index.tsx comme exemple concret.

Vérification

  1. pnpm mg new-shot <client>/<projet> <plan> --template <client>/<nom> dans un projet de test, plus un deuxième plan avec le texte réaliste le plus long.
  2. pnpm mg check <client>/<projet>.
  3. pnpm mg still <client>/<projet> <plan> et regardez les images. Ensuite pnpm mg render.
  4. Suivez motion-qa.

Travailler à partir d'une vidéo de référence

Lorsque l'utilisateur fournit une vidéo de référence, extrayez les images avant de concevoir. Créez d'abord renders/reference/ ; le ffmpeg intégré est une version minimale sans filtres, donc utilisez -r pour la fréquence d'images :

pnpm mg ffmpeg -i reference.mp4 -r 10 renders/reference/f_%03d.png

Décrivez à partir des images ce qui bouge, dans quel ordre, combien de temps dure chaque phase (comptez les images à 10 ips), et la sensation de l'easing. Confirmez cette décomposition avec l'utilisateur, puis mappez-la sur des tokens : durées vers motion.durations, courbes vers motion.easings.

Individual skills in this repo

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

Skills associés