Communitygithub.com

motion-template

Erstellen oder Ändern einer mg Remotion-Vorlage (einer wiederverwendbaren animierten Grafik, gesteuert durch Props und Tokens). Verwenden, wenn keine vorhandene Vorlage passt oder die Animation einer Vorlage geändert werden muss.

Was ist motion-template?

Diese Fähigkeit definiert eine wiederverwendbare Animationsvorlage für das motion-toolkit-System. Eine Vorlage ist ein vollständiges Remotion-Komponentendesign, das durch ein Zod-Schema definierte Props und über motion-Token aufgelöste visuelle Ressourcen liest. Sie muss mit `defineTemplate` erstellt werden und eine `component`, eine `durationSeconds`-Berechnung sowie einen `check`-Export bereitstellen. Die Vorlage kann kundenspezifisch (unter `clients/<client>/templates/<name>/`) oder als firmenweite Vorlage (im motion-toolkit-Repository) sein. Die Dokumentation beschreibt die Vertragsbedingungen detailliert: Jedes Schemafeld benötigt `default()` und `describe()`, Animationen müssen deterministisch über `useCurrentFrame` mit `interpolate`/`spring` erfolgen, der Hintergrund muss transparent sein (es sei denn, es handelt sich um eine Vollbildvorlage), und Fehler müssen laut mit Hinweisen zur Behebung ausgegeben werden. Für die visuelle Konsistenz gibt es Look-spezifische Helfer wie `choreo`, `reveal` und `typo`. Die Überprüfung erfolgt durch `mg new-shot`, `mg check` und `mg still`. Bei der Arbeit mit einem Referenzvideo müssen zuerst Frames extrahiert werden, um Timing und Easing zu analysieren.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Vorlagen

Eine Vorlage ist ein wiederverwendbares Design. Sie liest Shot-Props und aufgelöste Tokens – und nichts weiter. Lies motion-style, bevor du Timings oder Easing wählst. Für Details zur Remotion-API verwende die installierten Remotion-Fähigkeiten (npx remotion skills add) oder https://www.remotion.dev/docs.

Wo sie abgelegt wird

  • Kundenspezifisch: Beginne mit pnpm mg new-template <client> <name>. Es erstellt einen funktionierenden Starter unter clients/<client>/templates/<name>/index.tsx (ID <client>/<name>), der dem untenstehenden Vertrag folgt; ersetze sein Design.
  • Firmenweit (alle Kunden): templates/<name>/index.tsx im motion-toolkit-Repository, registriert in templates/index.ts, veröffentlicht mit einer neuen Toolkit-Version. Schreibe nicht in node_modules.

Bevor du Animationscode schreibst, schlage das Schema vor (die Props, die der Benutzer ohne Agent ändern kann) und bestätige es mit dem Benutzer.

Vertrag

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("Überschrift"),
  holdSeconds: z.number().positive().default(3),
  accent: z.string().default("accent").describe("Farbtokenname oder #hex"),
});

export const template = defineTemplate({
  title: "Titelkarte",
  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); // wirft Fehler bei unbekannten Tokennamen; läuft in `mg check`
  },
  component: ({ props, tokens, video }) => {
    const frame = useCurrentFrame();
    const m = motion(tokens, video.fps);
    // ...
  },
});

Anforderungen:

  1. Exportiere template (Client-Vorlagen) erstellt mit defineTemplate.
  2. Jedes Schemafeld hat einen .default()-Wert, sodass neue Shots und das Studio gültig starten. Füge .describe() für das Studio-Formular hinzu.
  3. Farben über color(tokens, nameOrHex), Schriftarten über font(tokens, role), Dauern und Easing über motion(tokens, fps), Positionen innerhalb safeArea(tokens, video), Größen über px(sizeAt1080, video).
  4. Animiere nur mit useCurrentFrame() und interpolate/spring. Keine CSS-Übergänge, setTimeout, Date.now() oder Math.random() (verwende random(seed) von remotion). Renderings müssen jedes Mal identisch sein.
  5. Lasse den Hintergrund transparent, es sei denn, die Vorlage ist ein Vollbild; Lower Thirds und Overlays rendern mit Alpha. Jedes Element muss im letzten Frame verschwunden sein.
  6. Fehler laut ausgeben: Wirf einen Error mit einem Lösungshinweis, wenn Text nicht passt oder ein Token fehlt. Verwende assertFits/wrapLines aus der Engine; sie messen mit der geladenen Schriftart und werfen bei Überlauf einen Fehler.
  7. Props, die Tokens benennen (Farben, Logos, Schriftarten, Sounds), werden in check mit checkRefs validiert, sodass mg check Tippfehler vor dem Rendern abfängt.
  8. durationSeconds und check laufen in Node (mg check) und bevor Schriftarten geladen sind: Miss dort niemals Text.
  9. Bilder und Logos: <Img src={staticFile(tokens.logos[name])} /> oder staticFile(props.someAsset). Sounds: <Html5Audio src={staticFile(file)} /> innerhalb eines <Sequence from={frame}>, Dateien aus tokens.sounds[name]. Die CLI stellt die Dateien bereit.

Looks

Firmenvorlagen und Client-Vorlagen, die dazu passen sollen, nehmen look: lookSchema entgegen und lösen es mit resolveLook(props.look, tokens) auf. Baue sie mit den gemeinsamen Helfern, sodass alle drei Looks konsistent bleiben (siehe motion-style):

  • choreo(tokens, look, fps) gibt beat(frame, index, exitStart, steps) → { inP, outP } für jedes Element in der Eingabereihenfolge; choreoSeconds(...) liefert die passende Dauer.
  • reveal(look, beat, video) ist der Eingangsstil des Looks für ein Element (umwickele es mit overflow: hidden für corporate).
  • typo(tokens, look, "display" | "title" | "body" | "label", size) ist der Typografiestil des Looks; onColor(hex) wählt lesbaren Text auf einem Farbblock; cornerPlacement(corner, inset) positioniert Eckgrafiken.

Lies eine Firmenvorlage wie node_modules/motion-toolkit/templates/title-card/index.tsx als ausführliches Beispiel.

Überprüfen

  1. pnpm mg new-shot <client>/<project> <shot> --template <client>/<name> in einem Testprojekt, plus einen zweiten Shot mit dem längsten realistischen Text.
  2. pnpm mg check <client>/<project>.
  3. pnpm mg still <client>/<project> <shot> und betrachte die Frames. Dann pnpm mg render.
  4. Folge motion-qa.

Arbeiten mit einem Referenzclip

Wenn der Benutzer ein Referenzvideo bereitstellt, extrahiere vor dem Entwurf Frames. Erstelle zuerst renders/reference/; das gebündelte ffmpeg ist ein minimaler Build ohne Filter, verwende daher -r für die Bildrate:

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

Beschreibe anhand der Frames, was sich bewegt, in welcher Reihenfolge, wie lange jede Phase dauert (zähle Frames bei 10 fps) und wie sich das Easing anfühlt. Bestätige diese Aufschlüsselung mit dem Benutzer und ordne sie dann Tokens zu: Dauern zu motion.durations, Kurven zu motion.easings.

Individual skills in this repo

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

Verwandte Skills