Communitygithub.com

atmirrr/persian-motion-director

Dirigez et créez du motion design professionnel (films promo et de lancement, typographie cinétique, vidéos explicatives animées, clips sociaux, séquences de titre) avec une typographie persane/farsi correcte et de droite à gauche, dans Remotion ou en code web simple.

Qu'est-ce que persian-motion-director ?

Cette compétence permet de transformer des animations basiques et des vidéos génériques en motion design professionnel, en s'attaquant spécifiquement à deux problèmes récurrents dans les créations générées par IA : l'effet « diaporama » (transitions fades, animations uniformes) et la mauvaise gestion du texte persan/farsi (lettres déconnectées, points tronqués, mélange avec l'arabe, sens d'affichage incorrect). Le flux de travail est structuré comme une boucle de réalisateur : lecture du brief, sélection de techniques parmi une bibliothèque de huit méthodes (caméra unique, coupe sur le beat, découpage en papier, etc.). L'accent est mis sur la mise en musique en premier lieu, la création d'un story-board sur une grille de mesures, et le rendu de plans de style avant toute animation complète. La compétence inclut des outils de pointe pour le persan : `shape_persian.py` utilise HarfBuzz pour générer des contours SVG par lettre et par point, `split_fa.js` préserve les ligatures, et `lint_persian.py` vérifie la conformité (chiffres persans, demi-espaces, kashidas). Cette compétence est idéale pour Remotion (son moteur principal) mais aussi pour le développement web en général. Elle est destinée aux développeurs qui souhaitent produire des vidéos et animations de qualité professionnelle, avec un texte persan parfait, que ce soit pour des clips sociaux, des films d'entreprise, des bandes-annonces ou des séquences de titre.

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

Demander à votre IA préférée

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

Documentation

Directeur Motion Persan

Vous dirigez, vous ne vous contentez pas d'animer. La plupart des animations générées échouent de deux manières prévisibles : elles ressemblent à un diaporama (scènes qui se fondent les unes dans les autres, une seule easing-in-out pour tout, tout arrive en même temps), et le persan est cassé (lettres séparées, points coupés, lettres et chiffres arabes, demi-espaces manquants, défilement de gauche à droite). Cette compétence corrige les deux. La méthode provient de la façon dont les motion designers professionnels décrivent leur propre travail sur X ; les règles persanes proviennent des exigences de mise en page arabe et persane du W3C et ont été vérifiées dans Chrome (le moteur avec lequel Remotion effectue le rendu).

La boucle du réalisateur

Travaillez dans cet ordre. Chaque étape existe parce que la sauter est la raison pour laquelle les pièces finissent par avoir l'air par défaut.

  1. Lisez le brief et ne comblez que les lacunes réelles. Copiez (persan et tout latin), la durée, le ratio d'aspect, les couleurs et polices de la marque, l'endroit où il sera publié, la musique. Si une marque existe, utilisez sa palette et ses polices au lieu d'en inventer une.
  2. Montrez les directions avant de construire. Le motion design est subjectif et coûte cher à refaire. Choisissez 6 à 10 techniques dans la bibliothèque ci-dessous qui correspondent au brief, ouvrez assets/sketches/gallery.html (ou générez les clips) et laissez l'utilisateur choisir. Refaire après une construction complète coûte dix fois plus cher qu'une liste de choix.
  3. La musique d'abord. Verrouillez la piste et son tempo avant d'animer. Construisez une carte des mesures : quelle section vit sur quelles mesures. S'il n'y a pas de piste, composez-en une (assets/music/compose_shur_pulse.py est un exemple fonctionnel qui écrit beats.json) ou demandez-en une. À 120 BPM, un temps vaut 0,5 s et une mesure 2 s ; à 60 ips, un temps vaut 30 images.
  4. Écrivez la liste des plans sur la grille des mesures (modèle dans references/workflow.md). Chaque changement de section atterrit sur un temps fort ; chaque coupe sur un temps ou 2 images avant.
  5. Plans de style. Effectuez le rendu de 4 à 6 images fixes (assets/remotion/render-stills.mjs) et obtenez un accord avant d'animer le tout.
  6. Construisez dans Remotion avec un seul conteneur de caméra et des objets partagés (voir assets/remotion/src/intro/Intro.tsx pour un exemple de travail complet).
  7. Vérifiez, puis effectuez le rendu : exécutez scripts/lint_persian.py sur tout le texte, examinez les images fixes en taille réelle pour détecter les points coupés et les jonctions brisées, parcourez chaque coupe par rapport au temps, et rendez les boucles exactes (durée du clip = un nombre entier de boucles).

Ce qui distingue le motion pro d'un diaporama

Habitude de diaporamaCe qu'il faut faire à la place
Scènes enchaînées avec des transitions fonduesUne caméra se déplace entre les scènes, ou un objet passe à la scène suivante. Jamais de fade() de scène à scène.
La même easing-in-out sur toutChaque mouvement reçoit sa propre courbe. Entrées : bezier(.16,1,.3,1) sur ~20 images. Sorties : bezier(.7,0,.84,0) sur ~8 images, ne parcourant que ~70% de la distance.
Tout arrive ensemble, espacé uniformémentUn élément principal, les autres 2 à 4 images derrière, espacés sur une courbe plutôt qu'uniformément.
spring() rebondissant par défaut de Remotion (dépassement d'environ 16%)Moins de 2% de dépassement sur l'interface utilisateur, aucun sur le texte : rigidité 100 / amortissement 16 donne ~1,5%.
Musique posée à la finMusique en premier ; coupes sur le temps ; les attaques sonores placées sur les hits visuels.
Texte centré sur un dégradé, logo à la finMontrez le vrai produit effectuant une vraie tâche dans les 10 premières secondes.
Gel, ou mouvement qui ne fait jamais de pauseMaintenez assez longtemps pour lire ; seule la caméra respire (zoom 1,00 → 1,04 par scène).
Grain, demi-teinte ou ASCII comme finitionTexture uniquement avec une raison physique (papier, impression, lumière). Ces finitions sont désormais le défaut de l'IA.

Plus de chiffres et les sources derrière eux : references/anti-slideshow.md.

Exigences persanes non négociables

Lisez references/persian-typography.md avant d'écrire du persan dans une image. La version courte :

  1. Ne mettez jamais les lettres persanes dans leurs propres boîtes. Les spans inline-block, les enfants flex (y compris les enfants directs de <AbsoluteFill> de Remotion, qui est une boîte flex) et toute transformation par lettre dessinent chaque lettre sous sa forme isolée. Animez des mots ou des lignes entières. Lorsque vous avez vraiment besoin d'un mouvement par lettre ou par point, utilisez des contours façonnés (scripts/shape_persian.py) ou une division par liure de largeur nulle (scripts/split_fa.js).
  2. Fondu des mots, pas des lettres. Les lettres jointes se chevauchent ; l'opacité par lettre ou la couleur de texte transparente laisse des coutures à chaque jonction.
  3. Les masques ont besoin de jeu. Le persan s'étend bien au-dessus et en dessous du latin : rembourrez les masques de clip d'environ 0,5 em en haut et en bas, utilisez une hauteur de ligne ≥ 1,6 (≥ 2,4 pour le Nastaliq), sinon les points et le haut du گ sont coupés.
  4. Direction. dir="rtl" lang="fa" sur chaque bloc persan ; enveloppez les noms et chiffres latins dans <bdi> (ou FSI/PDI) sinon la ligne se mélange. Les dévoilements et décalages commencent par la droite, le progrès de la caméra se déplace vers la gauche, les flèches « suivant » pointent vers la gauche. Les boutons de lecture, horloges et chiffres ne sont jamais inversés.
  5. Caractères. ی persan (U+06CC) et ک (U+06A9), jamais ي/ك arabe ; chiffres persans ۰–۹ (U+06F0–U+06F9), jamais chiffres arabo-indiens ٠–٩ ; la demi-espace (ZWNJ, U+200C) dans می‌, ‑ها, ‑تر/‑ترین. Ponctuation ، ؛ ؟ « ». scripts/lint_persian.py les détecte.
  6. Pas d'espacement des lettres. Chrome l'ignore à l'intérieur des mots persans (depuis la version 137) et d'autres outils cassent les jonctions. Étirez plutôt avec kashida, seulement après une lettre qui se joint vers l'avant, au maximum un par mot.
  7. Chargez la police, à chaque fois. Si la police persane (ou son sous-ensemble d'écriture arabe) n'est pas chargée, Chrome revient silencieusement à une police système. Dans Remotion, utilisez FontFace + delayRender (voir assets/remotion/src/fonts.ts).
  8. Copie. Écrivez du persan naturel dans un seul registre ; pas d'idiomes anglais mot à mot. Un locuteur natif valide chaque ligne avant le rendu (references/persian-copy.md).

Bibliothèque de techniques

Le code en direct pour chacune se trouve dans assets/sketches/sketches.js (JS simple, une fonction pure du temps) et s'exécute à la fois dans une page de navigateur et dans Remotion via SketchPlayer. Les détails, les chiffres et les publications X dont chacune provient se trouvent dans references/techniques/.

#TechniqueUtilisez-la pourIdentifiant du sketch
01Une caméra, sans coupuresL'épine dorsale d'un film : scènes sur une seule bande, whip pans avec flou de mouvement et parallaxeoner
02Une forme raconte l'histoireTransitions : un point final se transforme en bulle de discussion, puis en le point final suivantmatch
03La vraie interface utilisateur, dirigéePlans produit : interface réelle en 3D, curseur sur des arcs, changement de focusui
04Coupe sur le tempsSéries de fonctionnalités et typographie cinétique : coupes franches sur chaque temps, punch-ins, images inverséesbeat
05Sur deux images, avec bouillon de ligneUn calque dessiné à la main sur une interface utilisateur propre : les dessins tiennent 2 images, les lignes tremblent 12×/sboil
06Lettres découpées en papierCartes de titre chaleureuses : chaque groupe de lettres jointes est une pièce de papier rigidecutout
07Les points en dernierMarques de mots et dévoilements : le corps des lettres d'abord, puis les points tombentnuqta
08Kashida, pas d'espacement des lettresAccentuation sur une note tenue : étirez le trait de jonction, mesuré en points calligraphiqueskashida

Choisissez selon le brief, pas par nouveauté : une ou deux techniques de signature utilisées de manière cohérente se lisent comme un système ; les huit à la fois se lisent comme un showreel.

Outils de cette compétence

  • scripts/shape_persian.py — façonne le persan avec HarfBuzz et exporte les contours SVG divisés en corps de lettres, points et groupes de lettres connectés (pip install uharfbuzz fonttools). C'est ce qui rend possible l'animation par lettre, par point et par kashida sans casser l'écriture.
  • scripts/split_fa.js — divise un mot persan en lettres qui conservent leurs formes jointes (liures de largeur nulle), pour quand les contours sont excessifs.
  • scripts/lint_persian.py — vérifie le texte (lettres et chiffres arabes, demi-espaces manquants, ponctuation anglaise, kashida mal placé) et le code (espacement des lettres, boîtes par lettre, dir manquant).
  • assets/sketches/ — le moteur de mouvement (engine.js), les huit sketches, les données de glyphes façonnés, les styles et gallery.html (servez le dossier avec n'importe quel serveur statique).
  • assets/remotion/ — SketchPlayer (pilote un sketch à partir du numéro d'image), une composition de clip par technique, le film d'introduction complet comme exemple de travail, et des scripts pour effectuer le rendu des clips et des images fixes.
  • assets/music/compose_shur_pulse.py — une piste originale à 120 BPM en Dastgah Shur écrite en code, avec une carte des temps ; montre comment faire en sorte que le montage se verrouille sur la musique.

Quand l'utilisateur ne veut qu'une petite pièce rapide

Gardez quand même les deux non-négociables qui ne coûtent rien : pas de boîtes par lettre pour le persan, et pas de fondus de scène à scène. Utilisez bien une technique, réglez le timing sur une grille de temps, et effectuez le rendu d'images fixes pour vérifier le persan avant le rendu final.

Skills associés