Communitygithub.com

Parrass/mograf-public

Kostenlose Teilmenge der mograf Motion-Doktrin. Vor dem Schreiben oder Bearbeiten von Animationscode (HyperFrames, GSAP, CSS, Remotion, Three.js, Lottie) oder bewegten Grafiken laden. Deckt benannte Ease-Token, Videodauer-Bänder, Choreografie-Regeln und eine „Niemals tun“-Liste ab, die die häufigsten Template/AI-Slop-Bewegungen entfernt. Verwenden, wenn aufgefordert wird zu animieren, Bewegungen hinzuzufügen, ein Video zu erstellen oder Bewegungen weniger generisch wirken zu lassen.

Was ist mograf-public?

Dieses Skill definiert eine Reihe von Regeln und Best Practices für die Erstellung von Bewegungen in Videos und Animationen, die professionell und durchdacht wirken, anstatt wie aus einer Vorlage oder KI-generiert. Es basiert auf der mograf-Doktrin und bietet eine kostenlose Teilmenge, die speziell für Entwickler und Künstler entwickelt wurde, die mit Tools wie GSAP, CSS, Remotion, Three.js und Lottie arbeiten. Das Skill enthält benannte Ease-Token (mg.*) mit spezifischen Kurven für verschiedene Bewegungsarten (Eingänge, Ausgänge, Reisen, Setzen), Videodauer-Bänder für Elemente wie Mikro-Interaktionen, Helden-Ankünfte und Kamerafahrten, sowie klare Choreografie-Regeln wie „Ein Lead zur Zeit“ und „Bauen → Setzen → Halten“. Besonders wertvoll ist die „Niemals tun“-Liste, die typische Fehler wie standardmäßiges Einblenden (Fade-up), Scale(0)-Eingänge, gleichmäßiges Timing oder billige Dekorationen vermeidet. Ziel ist es, Bewegungen bedeutungsvoll zu gestalten – sie sollen Ideen transportieren (quetschen, gießen, brechen, stapeln, montieren, durchdrücken) oder das Auge zur nächsten wichtigen Sache führen. Das Skill ist plattformunabhängig und funktioniert mit jedem Framework, das CSS cubic-bezier, GSAP CustomEase oder Remotion Easing unterstützt. Es ist ideal für Social-Media-Videos, Erklärfilme, UI-Demos und jede Art von Bewegungsgrafik, die professionell aussehen soll.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Parrass/mograf-public/tree/HEAD/plugins/mograf/skills/motion-craft-lite

In Ihrer bevorzugten KI fragen

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

Dokumentation

motion-craft-lite

Dies sind Hausregeln für Bewegungen, die gestaltet und nicht vorlagenhaft wirken. Falls ein übergeordnetes Skill oder eine Bibliotheksvorgabe bei Easing, Timing oder Choreografie abweicht, ist diese Datei maßgeblich.

0. Der eine Test

Bevor du einen Tween schreibst, frage: Was bedeutet diese Bewegung? Wenn die Antwort lautet „es lässt das Ding erscheinen“, höre auf. Bewegung soll die Idee transportieren (quetschen, gießen, brechen, stapeln, montieren, durchdrücken) oder das Auge zum nächsten wichtigen Element führen.

1. Ease-Token

Diese einmal pro Komposition registrieren und nach Rolle verwenden:

gsap.registerPlugin(CustomEase);
CustomEase.create("mg.enter",  ".20,.75,.34,.94"); // Eingänge: scharf rein, saubere Landung
CustomEase.create("mg.settle", ".00,.65,.51,.99"); // Landungen, Arretierungen, Zähler: schnell raus, LANGE Beruhigung
CustomEase.create("mg.travel", "1,.49,0,.55");     // Lange A→B Reise (S-Kurve, steiler Mittelpunkt)
CustomEase.create("mg.depart", ".33,0,.12,1");     // Kamera/Element verlässt AUS DEM STAND
CustomEase.create("mg.exit",   "1,.02,.54,.42");   // Ausgänge: beschleunigen weg
CustomEase.create("mg.cut",    ".15,.85,.95,.05"); // Bewegungen, die durch einen Cut unterbrochen werden, nie beruhigen
CustomEase.create("mg.ui",     ".23,1,.32,1");     // UI-im-Video Mikro-Bewegungen
CustomEase.create("mg.inout",  ".77,0,.175,1");    // On-Screen-Morphs und Umrahmungen

Die gleichen Kurven als CSS cubic-bezier(...) funktionieren in CSS und WAAPI. In Remotion verwende Easing.bezier(...).

Zwei Fallstricke:

  • mg.settle beginnt mit einer vertikalen Tangente: Bei einer Rotation oder Kamerabewegung, die aus dem Stand startet (nach einem Klick, nach einem Halten) ruckelt es in einem Frame. Verwende dort mg.depart.
  • mg.travel ist S-förmig mit einer fast vertikalen Mittelpunkts-Tangente, nicht annähernd linear: Es bewegt sich an den Enden kaum und springt in der Mitte (bei einer 0,75 s Kamerafahrt landen 28 % der Reise in einem Frame). Verwende es nur für lange Reisen (≥ ~1,2 s); für kurze Kamerafahrten verwende mg.inout oder eine gebackene Feder, und mg.depart beim Verlassen aus dem Stand.

Dies ist die gesamte erlaubte Liste: die mg.* Token plus diese eingebauten (und eine gebackene Feder mit Dämpfung 0,80–0,85, falls nötig). Alles andere (power2.out, sine.*, power4.in, …) ist nicht auf der Palette:

  • power3.out: das Arbeitstier.
  • expo.out: Eintritte auf einem Cut.
  • power3.in: Austritte in einen Cut.
  • power4.out: harte Kamera-/Heldenlandungen.
  • power2.inOut: Kamera-Neupositionierung.
  • none: nur für Schleifen, Laufbänder, mechanische Bewegungen und gleichmäßige Geschwindigkeit auf Pfaden.

Regeln:

  • Ein Stück verwendet mindestens 3 Ease-Charaktere. Zwei Tweens, die gleichzeitig in einer Szene laufen, teilen sich keinen Ease, es sei denn, sie bewegen sich als eine gesperrte Gruppe: Ein Tween mit mehreren Zielen oder eine Child-Timeline mit defaults zählt als ein Ease-Nutzer.
    tl.fromTo([".card", ".card-label"], { y: 60 }, { y: 0, duration: 0.7, ease: "mg.settle" }, T); // eine Gruppe
    const lockup = gsap.timeline({ defaults: { ease: "mg.enter", duration: 0.6 } });           // eine Gruppe
    lockup.fromTo(".logo", { scale: 0.94 }, { scale: 1 }, 0).fromTo(".wordmark", { xPercent: -8 }, { xPercent: 0 }, 0.08);
    tl.add(lockup, T + 0.3);
    tl.fromTo(".kicker", { yPercent: 105 }, { yPercent: 0, duration: 0.5, ease: "mg.depart" }, T + 0.3); // gleichzeitig → eigener Ease
    
  • Zähle Ease-Nutzer, nicht Tweens. Eine gesperrte Gruppe zählt einmal. Ein Setter-gesteuerter Proxy (ein Tween auf einem {t}- oder Kameraobjekt, dessen Setter die Szene neu zeichnen) zählt als ein Nutzer mit dem Ease auf seinem Tween; innerhalb seiner paint-Funktion ausgewertete Eases zählen nicht separat, sodass viele gleichzeitige Kontakte von einem Treiber laufen können. Gleichzeitige Treiber benötigen dennoch unterschiedliche Eases.
  • Das Austauschen eines Ease während der Feinarbeit kann eine neue Kollision erzeugen. Nach jedem Austausch überprüfen, welche Tweens zeitlich überlappen und was sie verwenden.
  • Stagger-Verteilungs-Eases (stagger: { each, ease }) sind Timing-Offsets, keine Tween-Eases; sie zählen nicht.
  • Helden-räumliche Bewegungen verwenden niemals linear, power1, CSS ease oder ease-in-out.
  • Überschwingen ist optional: höchstens einmal pro Stück, höchstens 6 %, nur auf Transformationen. back.out, elastic und bounce sind ausgeschlossen, es sei denn, das Briefing verlangt nach einer spielerischen Anmutung.

2. Dauern (Video, nicht UI)

ElementDauer
Mikro (Tick, Icon-Zustand)0,15–0,3 s
Element-Eintritt0,4–0,8 s
Helden-Ankunft0,8–1,5 s, dann halten
Austritt~30 % schneller als sein Eintritt (0,25–0,5 s)
Kamerafahrt1,0–2,5 s, eine pro Szene, ruhiger als die Objekte
Harter Cut / Beat-Treffer0 s (tl.set); ein getimter Treffer zerstört ihn
Lese-Haltepunkt≥ 0,5 s + 0,3 s × Wörter
Finales Logo / CTA Halten≥ 0,8 s, absolut still, funktioniert als Thumbnail
  • Rhythmus.
    • Der langsamste Storyboard-Beat ist mindestens 3× der schnellste (ein Beat ist eine Storyboard-Zeile, kein Sub-Tween darin).
    • Über alle Tweens hinweg sollte längste ÷ kürzeste mindestens 4 betragen.
    • Benenne den Rhythmus vor dem Bau, z. B. schnell-schnell-LANGSAM-cut-halten.
  • Distanz und Masse. Größere Distanz oder mehr Masse bedeutet eine längere Dauer.
  • Eröffnung. Die erste Bewegung beginnt bei 0,1–0,3 s und der Held ist bis 0,5 s sichtbar.
  • Social. Frame 0 ist bereits komponiert und lesbar. Niemals aus Schwarz einblenden.

3. Choreografie

  1. Ein Lead zur Zeit. Zu jedem Zeitpunkt hat das Auge genau eine Sache zu verfolgen.
  2. Lead/Follow-Offsets. Stützen hinken dem Lead um 2–8 Frames (kompakt) oder 4–14 Frames (ausdrucksstark) hinterher, mit geringerer Amplitude.
  3. Kontaktkette. Das nächste Element beginnt, wenn das vorherige an ihm ankommt oder es berührt, nicht durch einen willkürlichen Timer.
  4. Deckkraft ist untergeordnet. Sie beginnt nachdem die Bewegung begonnen hat und endet vor der Beruhigung. Deckkraft allein ist niemals der Eintritt.
  5. Stagger. 50–120 ms pro Element, erleichtert oder von einem bedeutungsvollen Ursprung (Mitte, Fokuspunkt, Lesereihenfolge). Der gesamte Stagger dauert 0,6 s oder weniger.
  6. Enthüllung über die hintere Hälfte. Lade eine Szene nicht vorne auf. Die letzten 50 % sollten noch Informationen hinzufügen.
  7. Bauen → Setzen → Halten. Jede Bewegung endet mit einem Halten. Bewegung ohne Ruhe ist Lärm.
  8. Austritte sind einfacher und schneller als Eintritte. Innerhalb einer Sequenz ist der Übergang der Austritt.
  9. Richtung hat Bedeutung. Vorwärts/nächstes geht nach links oder oben; zurück/verwerfen geht nach rechts oder unten. Halte dies konsistent.

4. Niemals tun

  • Das Standard-Einblenden. opacity 0→1, y 20–40→0, power2.out bei irgendetwas. Text verwendet stattdessen Masken, Splits, Tiefe, Cuts oder einen leichten Pass. Ein Line-Mask-Aufstieg (yPercent → 0 innerhalb einer overflow-versteckten Zeile), der auch beim Herannahen weichzeichnet, beginnt bei yPercent ≥ 130; bei 105 tritt der Weichzeichnungs-Halo vor der Bewegung in die Maske ein. Verstecke maskierte Zeilen zur Build-Zeit mit gsap.set, nicht mit einem tl.set(…, 0) (was Kontrastprüfungen dazu verleiten kann, die unversteckte Zeile zu sampeln).
  • scale(0)-Eintritte. Ausnahmen: Punkte, Partikel und Maskenkreise. Ansonsten starte bei 0,9–0,97.
  • Gleichmäßiges Timing. Identische Dauern oder ein gleichmäßiger 0,1 s Stagger.
  • Atmen im Leerlauf. Scale- oder Opacity-Yoyo-Pulse auf inaktiven Elementen. Stattdessen: Stille, ein motivierter Ambient-Hintergrund oder eine Kameradrift mit einer Endposition.
  • Szenen-„Slides“. Ausblenden, dann einblenden.
  • Flaches #000 oder lineare Verläufe auf dunklen Hintergründen. H.264 bandet sie. Verwende radiale Verläufe und etwas Körnung.
  • Billige Dekoration. Emojis, Stock-Icons, driftende Verlaufsblobs, gestapelter Glassmorphismus, Neon auf allem, Regenbogenpaletten. Verwende 2–3 Farbtöne plus Neutrale, mit dem Akzent auf 10 % des Bildes oder weniger.
  • Monokultur-Schriften als Design. Inter, Roboto, Poppins, Playfair, EB Garamond, Bodoni Moda, Syne, Fraunces. Wähle eine ausdrucksstarke OFL-Display-Schrift und setze sie eng (−0,02 bis −0,05 em, Zeilenabstand ~1,05), mit Gewichtskontrast (300 vs 900).
  • Schreibmaschine + blinkender Cursor als Hauptidee, es sei denn, das Stück handelt buchstäblich vom Tippen oder Code.
  • Ein Ende, das einfach stoppt oder ausblendet. Gestalte den letzten Frame und halte ihn.

Selbstcheck vor der Übergabe:

  1. Kannst du die Idee in 15 Worten ausdrücken?
  2. Würde ein zufälliger Frame als Poster funktionieren?
  3. Gibt es mindestens 3 Ease-Persönlichkeiten, die nach Rolle verwendet werden?
  4. Gibt es einen heftigen Geschwindigkeitskontrast (sehr langsam, dann sehr schnell)?
  5. Hat jeder Übergang ein Motiv?

5. Video-Grundlagen

  • Schriftgröße bei 1080p. Überschriften 64–120 px (90 px oder mehr in einem Feed). Fließtext 32 px oder mehr.
  • Hierarchie. Der Held füllt 60–80 % der Breite. Der Skalenkontrast beträgt mindestens 5:1. Lasse 30–50 % negativen Raum (ein zentriertes Logo oder ein Endcard-Frame kann bis zu 75 % betragen) und verankere an einem Raster oder den Kanten.
  • Sicherheitsbereiche.
    • 16:9: Text innerhalb des 90 % titelsicheren Bereichs halten.
    • 9:16: kein Text in den oberen 14 %, unteren 20 % oder rechten 12 %.
    • 1:1 und 4:5: 6 % Rand.
  • Bildrate.
    • 30 fps ist der Social-Standard; Verwende 60 fps für UI-Demos und schnelle Schrift.
    • Mische niemals Bildraten in einem Stück.
    • Ein Vollbild-Seitwärtsschwenk ohne Unschärfe benötigt 5–7 s, sonst ruckelt er.
  • Determinismus (HyperFrames / jeder Frame-Renderer).
    • Eine pausierte Timeline. Verwende fromTo mit absoluten Werten.
    • Tweene nur Transformationen, Deckkraft, Filter und Clip-Pfade. Keine CSS-Übergänge.
    • Kein Math.random oder Date.now; verwende einen gesäten PRNG.
    • Lade Schriftarten aus lokalen @font-face-Dateien und teile Text erst nach document.fonts.ready.
    • Gestapelte fromTo-Tweens auf derselben Eigenschaft erhalten immediateRender: false wörtlich in jedes Vars-Objekt geschrieben (Linter suchen nach dem wörtlichen Schlüssel, nicht nach einem Helfer, der ihn hinzufügt).
    • Berechnete Transformationen, Canvas- und three.js-Renderings erfolgen über die Timeline-Zeit durch einen Setter-gesteuerten Proxy, nicht über onUpdate (Callbacks werden bei der Suche unterdrückt).

Dies ist die kostenlose Teilmenge der mograf-Doktrin (MIT). Die kostenpflichtige Bibliothek unter mograf.si fügt die Director-Pipeline, die Spezialisten-Skills (Typografie, Übergänge, Tiefe, Sound) und den Finishing-Stack hinzu. Jedes Stück wird mit seinem Prompt, seinen Skills, seiner Quelle und einer Kopie ausgeliefert. Für ein Qualitäts-Gate kombiniere dieses Skill mit dem kostenlosen motion-review.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Verwandte Skills