Communitygithub.com

atmirrr/persian-motion-director

Regie und Erstellung professioneller Bewegungsgrafiken (Promo- und Launchfilme, kinetische Typografie, animierte Erklärvideos, Social-Media-Clips, Titelsequenzen) mit korrekter persischer/farsi-schriftlicher und rechts-nach-links Typografie in Remotion oder einfachem Web-Code.

Was ist persian-motion-director?

Der Skill **Persian Motion Director** ist für KI-Agenten und Entwickler gedacht, die Videos, Animationen oder Bewegungsgrafiken mit persischem Text und RTL-Skript erstellen. Er behebt zwei typische Probleme generierter Animationen: erstens den „Slideshow-Effekt“ (eintönige Überblendungen, gleichförmige Easing-Kurven, gleichzeitiges Erscheinen aller Elemente) und zweitens fehlerhafte persische Typografie (getrennte Buchstaben, abgeschnittene Punkte, falsche Zeichen und Links-nach-rechts-Animationen). Der Skill basiert auf einer professionellen Arbeitsmethode: zuerst wird der Brief analysiert, dann werden Techniken aus einer Bibliothek von acht erprobten Bewegungsmustern vorgeschlagen. Der Arbeitsablauf folgt einem festen Schema: Musik zuerst, Taktplan, Bild-für-Bild-Animation in Remotion, und abschließend eine Qualitätsprüfung mit speziellen Linting-Tools. Unterstützt wird die Entwicklung in Remotion und mit einfachem Web-Code. Zu den Werkzeugen gehören ein HarfBuzz-basierter Skript („shape_persian.py“) zur Erzeugung von SVG-Outlines mit getrennten Buchstabenkörpern, Punkten und Buchstabengruppen, ein Linter („lint_persian.py“) und ein Generator für persische Musik („compose_shur_pulse.py“). Der Skill stellt sicher, dass persischer Text korrekt dargestellt wird, einschließlich der Verwendung von ZWNJ-Halbzeichen, kashida-Streckungen, richtigen Zeichen (ی statt ي, ۶ statt ۶) und exakter RTL-Ausrichtung.

Funktioniert mit~Claude Code~Codex CLI✓Cursor
npx skills add atmirrr/persian-motion-director

In Ihrer bevorzugten KI fragen

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

Dokumentation

Persian Motion Director

Du führst Regie, animierst nicht nur. Die meisten generierten Bewegungsabläufe scheitern auf zwei vorhersehbare Arten: Sie wirken wie eine Diashow (Szenen, die ineinander überblenden, einheitliches Ease-in-out, alles kommt gleichzeitig an) und das Persisch ist fehlerhaft (Buchstaben getrennt, Punkte abgeschnitten, arabische Buchstaben und Ziffern, fehlende Halbzeichen, Links-nach-rechts-Einblendungen). Dieser Skill behebt beides. Die Methode stammt aus der Art und Weise, wie professionelle Motion Designer ihre Arbeit auf X beschreiben; die persischen Regeln basieren auf den W3C-Empfehlungen für arabische und persische Layoutanforderungen und wurden in Chrome getestet (der Engine, mit der Remotion rendert).

Die Regie-Schleife

Arbeite in dieser Reihenfolge. Jeder Schritt existiert, weil sein Überspringen dazu führt, dass das Endergebnis standardmäßig aussieht.

  1. Lies das Briefing und fülle nur echte Lücken. Kopiere (Persisch und eventuelles Latein), Länge, Seitenverhältnis, Markenfarben und -schriftarten, wo es veröffentlicht wird, Musik. Wenn eine Marke existiert, verwende ihre Palette und Schriftarten, anstatt eigene zu erfinden.
  2. Zeige Richtungen vor dem Bauen. Bewegung ist subjektiv und teuer in der Überarbeitung. Wähle 6–10 Techniken aus der untenstehenden Bibliothek, die zum Briefing passen, öffne assets/sketches/gallery.html (oder rendere die Clips) und lass den Benutzer wählen. Nach einem vollständigen Bau nachzubessern kostet zehnmal mehr als eine Auswahlliste.
  3. Musik zuerst. Lege den Track und sein Tempo fest, bevor du animierst. Erstelle eine Taktkarte: welcher Abschnitt auf welchen Takten liegt. Wenn es keinen Track gibt, komponiere einen (assets/music/compose_shur_pulse.py ist ein funktionierendes Beispiel, das beats.json schreibt) oder frage nach einem. Bei 120 BPM entspricht ein Schlag 0,5 s und ein Takt 2 s; bei 60 fps entspricht ein Schlag 30 Frames.
  4. Schreibe die Shot-Liste auf das Taktgitter (Vorlage in references/workflow.md). Jeder Abschnittswechsel landet auf einem Downbeat; jeder Schnitt auf einem Beat oder 2 Frames davor.
  5. Style Frames. Rendere 4–6 Standbilder (assets/remotion/render-stills.mjs) und hole ein Okay, bevor du alles animierst.
  6. Baue in Remotion mit einem Kamera-Container und gemeinsamen Objekten (siehe assets/remotion/src/intro/Intro.tsx für ein vollständiges Arbeitsbeispiel).
  7. Prüfe, dann rendere: führe scripts/lint_persian.py auf allen Texten aus, überprüfe Standbilder in voller Größe auf abgeschnittene Punkte und unterbrochene Verbindungen, überprüfe jeden Schnitt gegen den Beat und mache Schleifen exakt (Clipslänge = eine ganze Anzahl von Schleifendurchläufen).

Was professionelle Bewegung von einer Diashow unterscheidet

Diashow-GewohnheitWas stattdessen zu tun ist
Szenen mit Überblendungen aneinandergereihtEine Kamera bewegt sich zwischen den Szenen, oder ein Objekt trägt in die nächste Szene über. Niemals Szene-zu-Szene mit fade().
Das gleiche Ease-in-out für allesJede Bewegung bekommt ihre eigene Kurve. Eintritte: bezier(.16,1,.3,1) über ca. 20 Frames. Austritte: bezier(.7,0,.84,0) über ca. 8 Frames, die nur ca. 70 % der Strecke zurücklegen.
Alles kommt gleichzeitig an, gleichmäßig verteiltEin Leitelement, der Rest 2–4 Frames dahinter, auf einer Kurve statt gleichmäßig verteilt.
Remotions standardmäßige elastische spring() (Überschwingen ~16 %)Weniger als 2 % Überschwingen bei UI, kein Überschwingen bei Text: stiffness 100 / damping 16 ergibt ~1,5 %.
Musik erst am Ende hinzugefügtMusik zuerst; Schnitte auf dem Beat; Sound-Attacken auf den visuellen Treffern.
Zentrierter Text auf einem Farbverlauf, Logo am EndeZeige das echte Produkt bei einer echten Aufgabe in den ersten 10 Sekunden.
Anhalten oder Bewegung, die nie pausiertHalte lange genug zum Lesen; nur die Kamera atmet (Zoom 1,00 → 1,04 pro Szene).
Korn, Halbton oder ASCII als FinishTextur nur mit einem physischen Grund (Papier, Druck, Licht). Diese Finishes sind jetzt der KI-Standard.

Weitere Zahlen und die Quellen dahinter: references/anti-slideshow.md.

Persische No-Gos

Lies references/persian-typography.md, bevor du ein persisches Wort in einen Frame schreibst. Die Kurzfassung:

  1. Setze persische Buchstaben niemals in eigene Boxen. inline-block-Spans, Flex-Kinder (einschließlich direkter Kinder von Remotions <AbsoluteFill>, das ein Flex-Box ist) und jede Transformation pro Buchstabe zeichnet jeden Buchstaben in seiner isolierten Form. Animiere ganze Wörter oder Zeilen. Wenn du wirklich Bewegung pro Buchstabe oder pro Punkt benötigst, verwende geformte Umrisse (scripts/shape_persian.py) oder Zero-Width-Joiner-Split (scripts/split_fa.js).
  2. Blende Wörter aus, nicht Buchstaben. Verbundene Buchstaben überlappen; Deckkraft pro Buchstabe oder durchscheinende Textfarbe hinterlässt Nähte an jeder Verbindung.
  3. Masken brauchen Spielraum. Persisch reicht weit über Latein hinaus: Polster Clip-Masken oben und unten um ca. 0,5 em, verwende Zeilenabstand ≥ 1,6 (≥ 2,4 für Nastaliq), sonst werden die Punkte und die Oberseite von گ abgeschnitten.
  4. Ausrichtung. dir="rtl" lang="fa" auf jedem persischen Block; umschließe lateinische Namen und Zahlen mit <bdi> (oder FSI/PDI), sonst gerät die Zeile durcheinander. Einblendungen und Staffelungen beginnen rechts, der Kamerafortschritt bewegt sich nach links, „Weiter“-Pfeile zeigen nach links. Play-Buttons, Uhren und Zahlen werden nie gespiegelt.
  5. Zeichen. Persisch ی (U+06CC) und ک (U+06A9), niemals arabisch ي/ك; persische Ziffern ۰–۹ (U+06F0–06F9), niemals arabisch-indische ٠–٩; das Halbzeichen (ZWNJ, U+200C) in می‌, ‑ها, ‑تر/‑ترین; Satzzeichen ، ؛ ؟ « ». scripts/lint_persian.py erkennt diese.
  6. Keine Buchstabenabstände. Chrome ignoriert sie innerhalb persischer Wörter (seit Version 137) und andere Werkzeuge brechen die Verbindungen. Dehne stattdessen mit Kashida, nur nach einem Buchstaben, der vorwärts verbindet, höchstens einem pro Wort.
  7. Lade die Schriftart, jedes Mal. Wenn die persische Schriftart (oder ihr arabisches Subset) nicht geladen ist, fällt Chrome stillschweigend auf eine Systemschrift zurück. Verwende in Remotion FontFace + delayRender (siehe assets/remotion/src/fonts.ts).
  8. Text. Schreibe natürliches Persisch in einem Register; keine wortwörtlichen englischen Redewendungen. Ein muttersprachlicher Leser gibt jede Zeile vor dem Rendern frei (references/persian-copy.md).

Technikbibliothek

Live-Code für jede ist in assets/sketches/sketches.js (reines JS, eine reine Funktion der Zeit) und läuft sowohl in einer Browserseite als auch in Remotion über SketchPlayer. Details, Zahlen und die X-Beiträge, von denen jede stammt, sind in references/techniques/.

#TechnikVerwende sie fürSketch-ID
01Eine Kamera, keine SchnitteDas Rückgrat eines Films: Szenen auf einem Streifen, schnelle Schwenks mit Bewegungsunschärfe und Parallaxeoner
02Eine Form erzählt die GeschichteÜbergänge: Ein Punkt wächst zu einer Sprechblase, dann zum nächsten Punktmatch
03Die echte UI, inszeniertProdukt-Szenen: echte Oberfläche in 3D, Cursor auf Bögen, Fokus-Pullsui
04Schnitt auf den BeatFeature-Runs und kinetische Typografie: harte Schnitte auf jedem Beat, Punch-Ins, invertierte Framesbeat
05Auf Zweien, mit LinienwabernEine handgezeichnete Ebene über sauberer UI: Zeichnungen halten 2 Frames, Linien wabern 12×/sboil
06Papier-Ausschnitt-BuchstabenWarme Titelbilder: jede verbundene Buchstabengruppe ist ein starres Papierstückcutout
07Punkte zuletztWortmarken und Einblendungen: Buchstabenkörper zuerst, dann fallen die Punkte einnuqta
08Kashida, kein BuchstabenabstandBetonung auf einem gehaltenen Ton: dehn den verbindenden Strich, gemessen in kalligraphischen Punktenkashida

Wähle nach dem Briefing aus, nicht nach Neuheit: ein oder zwei charakteristische Techniken, die konsequent verwendet werden, wirken wie ein System; alle acht gleichzeitig wirken wie eine Showreel.

Werkzeuge in diesem Skill

  • scripts/shape_persian.py — formt Persisch mit HarfBuzz und exportiert SVG-Umrisse, aufgeteilt in Buchstabenkörper, Punkte und verbundene Buchstabengruppen (pip install uharfbuzz fonttools). Dadurch wird Bewegung pro Buchstabe, Punkt und Kashida möglich, ohne das Skript zu zerbrechen.
  • scripts/split_fa.js — teilt ein persisches Wort in Buchstaben, die ihre verbundenen Formen behalten (Zero-Width-Joiner), für den Fall, dass Umrisse übertrieben sind.
  • scripts/lint_persian.py — prüft Text (arabische Buchstaben und Ziffern, fehlende Halbzeichen, englische Satzzeichen, falsch platzierte Kashida) und Code (Buchstabenabstand, Boxen pro Buchstabe, fehlendes dir).
  • assets/sketches/ — die Bewegungsengine (engine.js), die acht Skizzen, geformte Glyphendaten, Styles und gallery.html (diene den Ordner mit einem beliebigen statischen Server).
  • assets/remotion/ — SketchPlayer (steuert eine Skizze über die Frame-Nummer), eine Clip-Komposition pro Technik, der vollständige Intro-Film als Arbeitsbeispiel und Skripte zum Rendern von Clips und Standbildern.
  • assets/music/compose_shur_pulse.py — ein originaler 120-BPM-Track in Dastgah Shur, in Code geschrieben, mit einer Beatmap; zeigt, wie man den Schnitt an die Musik bindet.

Wenn der Benutzer nur ein schnelles Stück möchte

Behalte trotzdem die beiden No-Gos bei, die nichts kosten: keine Boxen pro Buchstabe für Persisch und keine Szene-zu-Szene-Überblendungen. Verwende eine Technik gut, setze das Timing auf einem Beat-Gitter und rendere Standbilder, um das Persisch vor dem vollständigen Rendern zu überprüfen.

Verwandte Skills