Communitygithub.com

motion

Einstiegspunkt für alle Bewegtgrafiken in einem mg-Workspace (mg.json im Stammverzeichnis) – Einblendungen, Titel, animierter Text, Markenänderungen, Rendering. Zuerst lesen; leitet zu den anderen motion-*-Fähigkeiten weiter.

Was ist motion?

Dieser Skill definiert den Einstiegspunkt und das grundlegende Layout eines ‚Motion Workspace‘, der mit dem mg-CLI-Tool auf Basis von Remotion wiederholbare Bewegtgrafiken rendert. Das System trennt strikt Code (Vorlagen) von Daten (JSON-Konfigurationen), sodass Text-, Farb- oder Schriftartenänderungen ohne Code-Änderungen durchgeführt werden können. Die Skill-Beschreibung erläutert die Token-Kaskade (Toolkit → Haus → Kunde → Variante → Projekt → Shot), die Struktur der Vorlagen (Hausvorlagen wie unteres Drittel, Titelkarte, Callout usw.), die Regeln für die Verwaltung von Projekten und Daten sowie die Routing-Informationen zu spezialisierten Skills wie `motion-brand`, `motion-project`, `motion-template`, `motion-style`, `motion-render` und `motion-qa`. Der Skill unterstützt plattformübergreifend die mg-CLI-Befehle zur Erstellung, Validierung, Vorschau und Auslieferung von Bewegtgrafiken.

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

In Ihrer bevorzugten KI fragen

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

Dokumentation

Motion-Workspace

Dieser Workspace rendert wiederholbare Bewegtgrafiken mit Remotion über die mg-CLI (pnpm mg <command>). Designs sind Code in Vorlagen; jeder auftragsspezifische Wert lebt in JSON. Eine Text-, Farb- oder Schriftartenänderung ist eine JSON-Bearbeitung plus pnpm mg render, nie eine Code-Änderung.

Layout

mg.json                         Video-Standardeinstellungen des Workspaces (fps, Größe)
brand/house.tokens.json         Haus-Tokens: Basis-Farben, Schriftarten, Easing, Dauern, Sicherheitsbereiche
brand/fonts/  brand/logos/      Dateien, auf die die Haus-Tokens verweisen
clients/<client/>/
  client.json                   Anzeigename, optionales Video-Override
  brand/tokens.json             Kunden-Overrides (tief zusammengeführt über Haus)
  brand/fonts/ brand/logos/
  brand/variants/<variant>/     benannter alternativer Look, der von mehreren Projekten wiederverwendet wird: tokens.json, fonts/, logos/
  templates/<name>/index.tsx    Nur-Kunden-Vorlagen, Id "<client>/<name>"
  projects/<project>/
    project.json                { title?, extends?: "client"|"none", brand?: "<variant>", video?, preset? }
    tokens.json                 Nur-Projekt-Overrides (optional)
    tokens.lock.json            vorhanden, wenn eingefroren: Rendering ignoriert die Live-Kette
    fonts/ logos/ assets/       Projektdateien; Props verweisen auf Assets als "asset:<pfad>"
    shots/<shot>.props.json     { template, props, durationSeconds?, preset?, video? }
    renders/                    Ausgabe, von git ignoriert; manifest.json verfolgt Versionen

Toolkit-Code (Engine, Hausvorlagen, diese Skills) lebt in node_modules/motion-toolkit, gepinnt durch package.json. Niemals dort bearbeiten; Änderungen an Hausvorlagen gehen in das Toolkit-Repository.

Hausvorlagen

Jede Hausvorlage hat eine look-Prop: minimal (sauber, leichte Schriftgewichte, Weichzeichner-Aufstieg, keine Panels), bold (schwere Großbuchstaben, feste Farbblöcke, Spring-Pop), corporate (Panels, Akzentbalken, Masken-Enthüllungen). Der Standardwert "brand" verwendet das look-Token, sodass ein Kunde seinen Stil einmal in brand/tokens.json setzt ("look": "minimal").

IdVerwendung
lower-thirdName- und Titel-Band, optionales Logo
title-cardKapitel- oder Abschnittstitel, optionaler Aufmacher und Untertitel; Overlay oder Vollbild
calloutLinie von einem Punkt im Filmmaterial (x, y als Bildanteile) zu einer Beschriftung
end-cardAbschlusskarte: Logo, Überschrift, CTA, URL, 0–2 YouTube-Endbildschirm-Slots
kinetic-textZitat oder Aussage, Wort für Wort enthüllt; *wort* betont
logo-stingKurze animierte Logo-Enthüllung (Intro/Outro)
counterHochzählende Zahl (value, prefix, suffix, decimals) mit einer Beschriftung
social-handlePlattformsymbol plus @handle in einer Ecke (YouTube, Instagram, TikTok, X, LinkedIn, …)
typewriterText Buchstabe für Buchstabe getippt mit Schreibmaschinen- oder Tastaturgeräuschen im Rendering-Audio
corner-brandingPermanentes Logo-Wasserzeichen in einer beliebigen Ecke, optionaler Tag wie LIVE

pnpm mg new-shot … --template <id> schreibt jede Prop mit ihrem Standardwert. Die Bedeutung jeder Prop steht im .describe()-Text in node_modules/motion-toolkit/templates/<id>/index.tsx.

Token-Kaskade

toolkit → haus → kunde → variante (falls projekt.json "brand") → project tokens.json → shot props. Die Toolkit-Ebene liefert nur Standardwerte (den Look, eine mono-Schrift, Tipp sounds). Objekte werden Schlüssel für Schlüssel zusammengeführt, null löscht einen geerbten Schlüssel, und die spezifischste Ebene gewinnt. "extends": "none" überspringt Kunde und Variante. Schrift-, Logo- und Sounddateien werden im spezifischsten fonts/-, logos/- oder sounds/-Ordner gefunden, der sie enthält.

Regeln

  1. Jeder sichtbare Wert stammt aus Shot-Props oder Tokens. Keine hartcodierten Farben, Schriftarten, Größen in px ohne Prop oder Timings in Vorlagen.
  2. Projekte enthalten Daten, keinen Code. Ein neues Design ist eine Vorlage; ein neuer Auftrag ist ein Projekt mit Shot-Dateien.
  3. Setze einen Wert auf der niedrigsten Ebene, die ihn besitzt: ein Shot → Shot-Props; ein Projekt → Projekt tokens.json; mehrere Projekte eines Kunden → eine Variante; der gesamte Kunde → Kunden-Tokens.
  4. Niemals tokens.lock.json von Hand bearbeiten. Ausgelieferte Projekte sind eingefroren; sie ändern sich nur durch mg rebrand (siehe motion-render).
  5. Nach jeder JSON- oder Vorlagenbearbeitung pnpm mg check ausführen und die gemeldeten Fehler beheben, bevor gerendert wird.
  6. Jede visuelle Änderung mit der motion-qa-Prozedur abschließen, bevor sie als erledigt gemeldet wird.
  7. Vor mg rebrand --apply und vor der Bearbeitung von Kunden- oder Varianten-Tokens, die von eingefrorenen Projekten verwendet werden, den Benutzer fragen.
  8. Wenn ein Rendering oder eine Doctor-Prüfung fehlschlägt, vor einer Code-Änderung pnpm mg doctor ausführen.

Routing

AufgabeLesen
Neuer Kunde, Variante, Logo, Schriftart, Farbpalettemotion-brand
Neues Projekt oder Shots aus einem Briefing; Text/Farben auf bestehenden Shots ändernmotion-project
Neue Vorlage oder eine Änderung der Animation einer Vorlagemotion-template, dann motion-style
Bewegungsgefühl: Easing, Timing, Staffelung, Sicherheitsbereichemotion-style
Rendering, Voreinstellungen, Versionen, Auslieferung, Markenänderungen anwendenmotion-render
Ausgabe vor der Übergabe prüfenmotion-qa

Befehle

pnpm mg templates                                  Vorlagen-IDs auflisten
pnpm mg new-client|new-variant|new-project …
pnpm mg new-shot <kunde>/<projekt> <shot> --template <id>   Shot-Datei mit allen Props auf Standardwerten
pnpm mg new-template <kunde> <name>               Starter-Vorlage
pnpm mg check [<kunde> | <kunde>/<projekt>]      alles ohne Rendering validieren
pnpm mg render <kunde>/<projekt> [shot…]          überspringt unveränderte Shots; --force, --preset
pnpm mg still <kunde>/<projekt> [shot…]           PNGs auf Schachbrettmuster ansehen (alle Shots standardmäßig)
PNpm mg studio <kunde>/<projekt>                  Live-Vorschau; Studio "Speichern" schreibt die Shot-Datei
pnpm mg deliver <kunde>/<projekt>                 rendern, verifizieren, einfrieren, Finales nach deliver/<datum>/ kopieren
pnpm mg rebrand <kunde | kunde/projekt> [--apply]   Markenänderungen für ausgelieferte Arbeiten
pnpm mg freeze|unfreeze|diff <kunde>/<projekt>
pnpm mg doctor                                     Umgebung, mg check, Smoke-Rendering

Individual skills in this repo

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

Verwandte Skills