Communitygithub.com

atmirrr/director-de-movimiento-persa

Dirige y construye motion design profesional (vídeos promocionales, tipografía cinética, explicadores animados, clips sociales, secuencias de títulos) con tipografía correcta en persa/farsi y escritura de derecha a izquierda, en Remotion o código web. Usa esta skill cada vez que el usuario quiera un vídeo, animación, gráficos en movimiento, teaser o texto animado que contenga persa, farsi, escritura árabe o texto RTL, y cuando diga que una pieza de movimiento se ve "por defecto", "como un pase de diapositivas", "hecha por IA" o "no profesional", o que el persa se ve mal, roto o desconectado, incluso si nunca dice "diseño de movimiento". Incorpora el método anti-pase-de-diapositivas (una cámara, objetos que se trasladan entre escenas, ediciones bloqueadas al ritmo de la música), ocho técnicas listas con bocetos en vivo, herramientas HarfBuzz para animación de letras y puntos persas, estiramiento kashida, y una lista de verificación y linter de corrección persa.

¿Qué es director-de-movimiento-persa?

Esta skill transforma la forma de crear animaciones con texto persa, farsi o árabe, asegurando un resultado profesional que evita los errores típicos de las herramientas generativas: cortes tipo diapositiva y roturas en la escritura de derecha a izquierda. Proporciona un flujo de trabajo completo que comienza con la lectura del brief, pasa por la selección de técnicas, el bloqueo de la música primero, y finaliza con la renderización y verificación. Su punto fuerte es que incluye un conjunto de ocho técnicas de animación (como cámara única sin cortes, corte al ritmo, o estiramiento kashida) junto con herramientas de línea de comandos escritas en Python y JavaScript que usan HarfBuzz para animar letras persas sin romper la conectividad de la escritura. Está diseñada para plataformas como Remotion o web estándar, y su documentación se basa en fuentes reales (W3C, publicaciones de diseñadores profesionales en X) para garantizar que el resultado final sea correcto tipográficamente, con reglas sobre dirección, espaciado, saltos de línea y caracteres específicos (por ejemplo, usar ی persa en lugar de ي árabe).

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Director de Movimiento Persa

Estás dirigiendo, no solo animando. La mayoría del movimiento generado falla de dos formas predecibles: parece un pase de diapositivas (escenas que se desvanecen entre sí, la misma entrada y salida suave para todo, todo llegando al mismo tiempo) y su persa está roto (letras separadas, puntos cortados, letras y dígitos árabes, espacios medios faltantes, revelados de izquierda a derecha). Esta skill corrige ambas. El método proviene de cómo los diseñadores de movimiento profesionales describen su propio trabajo en X; las reglas persas provienen de los Requisitos de Diseño Árabe y Persa del W3C y fueron verificadas en Chrome (el motor con el que renderiza Remotion).

El bucle del director

Trabaja en este orden. Cada paso existe porque saltarlo es cómo las piezas terminan viéndose por defecto.

  1. Lee el brief y solo llena los vacíos reales. Copia (persa y cualquier latín), duración, relación de aspecto, colores y fuentes de la marca, dónde se publicará, música. Si existe una marca, usa su paleta y fuentes en lugar de inventar una.
  2. Muestra direcciones antes de construir. El movimiento es subjetivo y caro de rehacer. Elige de 6 a 10 técnicas de la biblioteca a continuación que se ajusten al brief, abre assets/sketches/gallery.html (o renderiza los clips) y deja que el usuario elija. Rehacer después de una construcción completa cuesta diez veces más que una lista de selección.
  3. Primero la música. Bloquea la pista y su tempo antes de animar. Construye un mapa de compases: qué sección vive en qué compases. Si no hay pista, compón una (assets/music/compose_shur_pulse.py es un ejemplo funcional que escribe beats.json) o pide una. A 120 BPM un pulso es 0.5 s y un compás 2 s; a 60 fps un pulso son 30 fotogramas.
  4. Escribe la lista de tomas en la cuadrícula de compases (plantilla en references/workflow.md). Cada cambio de sección cae en un tiempo fuerte; cada corte en un pulso o 2 fotogramas antes.
  5. Fotogramas de estilo. Renderiza de 4 a 6 imágenes fijas (assets/remotion/render-stills.mjs) y obtén un sí antes de animar todo.
  6. Construye en Remotion con un contenedor de cámara y objetos compartidos (consulta assets/remotion/src/intro/Intro.tsx para un ejemplo completo y funcional).
  7. Verifica, luego renderiza: ejecuta scripts/lint_persian.py en todo el texto, revisa las imágenes fijas a tamaño completo en busca de puntos recortados y uniones rotas, revisa cada corte contra el pulso, y haz que los bucles sean exactos (duración del clip = un número entero de bucles).

Lo que separa el movimiento profesional de un pase de diapositivas

Hábito de pase de diapositivasQué hacer en su lugar
Escenas encadenadas con transiciones de desvanecimientoUna cámara viaja entre escenas, o un objeto se traslada a la siguiente escena. Nunca fade() de escena a escena.
La misma entrada y salida suave para todoCada movimiento tiene su propia curva. Entradas: bezier(.16,1,.3,1) durante ~20 fotogramas. Salidas: bezier(.7,0,.84,0) durante ~8 fotogramas, viajando solo ~70% de la distancia.
Todo llega junto, espaciado uniformementeUn elemento principal, el resto de 2 a 4 fotogramas detrás, espaciados en una curva en lugar de uniformemente.
El spring() rebotador por defecto de Remotion (sobreimpulso ~16%)Sobreimpulso inferior al 2% en UI, ninguno en texto: rigidez 100 / amortiguación 16 da ~1.5%.
Música colocada al finalMúsica primero; cortes en el pulso; ataques de sonido colocados en los impactos visuales.
Texto centrado sobre un degradado, logo al finalMuestra el producto real haciendo una tarea real en los primeros 10 segundos.
Congelaciones, o movimiento que nunca pausaMantén el tiempo suficiente para leer; solo la cámara respira (zoom 1.00 → 1.04 por escena).
Grano, semitonos o ASCII como acabadoTextura solo con una razón física (papel, impresión, luz). Estos acabados son ahora el defecto de la IA.

Más números y las fuentes detrás de ellos: references/anti-slideshow.md.

Lo no negociable en persa

Lee references/persian-typography.md antes de escribir cualquier persa en un fotograma. La versión corta:

  1. Nunca pongas letras persas en sus propias cajas. Los spans inline-block, los hijos de flex (incluyendo los hijos directos de <AbsoluteFill> de Remotion, que es una caja flex) y cualquier transformación por letra dibujan cada letra en su forma aislada. Anima palabras o líneas completas. Cuando realmente necesites movimiento por letra o por punto, usa contornos con forma (scripts/shape_persian.py) o división con conector de ancho cero (scripts/split_fa.js).
  2. Desvanece palabras, no letras. Las letras unidas se superponen; la opacidad por letra o el color de texto translúcido deja costuras en cada unión.
  3. Las máscaras necesitan margen. El persa se extiende muy por encima y por debajo del latín: rellena las máscaras de clip unos 0.5em arriba y abajo, usa altura de línea ≥ 1.6 (≥ 2.4 para Nastaliq), o los puntos y la parte superior de گ se cortan.
  4. Dirección. dir="rtl" lang="fa" en cada bloque persa; envuelve nombres y números latinos en <bdi> (o FSI/PDI) o la línea se desordena. Los revelados y escalonados comienzan a la derecha, el progreso de la cámara viaja hacia la izquierda, las flechas de "siguiente" apuntan a la izquierda. Los botones de reproducción, relojes y números nunca se reflejan.
  5. Caracteres. ی persa (U+06CC) y ک (U+06A9), nunca ي/ك árabes; dígitos persas ۰–۹ (U+06F0–06F9), nunca indoarábigos ٠–٩; el medio espacio (ZWNJ, U+200C) en می‌, ‑ها, ‑تر/‑ترین. Puntuación ، ؛ ؟ « ». scripts/lint_persian.py los detecta.
  6. Sin espaciado entre letras. Chrome lo ignora dentro de palabras persas (desde la versión 137) y otras herramientas rompen las uniones. Estira con kashida en su lugar, solo después de una letra que se une hacia adelante, como máximo uno por palabra.
  7. Carga la fuente, cada vez. Si la fuente persa (o su subconjunto de escritura árabe) no está cargada, Chrome recurre silenciosamente a una fuente del sistema. En Remotion usa FontFace + delayRender (consulta assets/remotion/src/fonts.ts).
  8. Texto. Escribe persa natural en un solo registro; nada de modismos ingleses palabra por palabra. Un lector nativo aprueba cada línea antes del renderizado (references/persian-copy.md).

Biblioteca de técnicas

El código en vivo de cada una está en assets/sketches/sketches.js (JS plano, una función pura del tiempo) y se ejecuta tanto en una página del navegador como en Remotion a través de SketchPlayer. Los detalles, números y las publicaciones de X de las que provienen están en references/techniques/.

#TécnicaÚsala paraId del boceto
01Una cámara, sin cortesLa columna vertebral de una película: escenas en una tira, paneos de látigo con desenfoque de movimiento y paralajeoner
02Una forma cuenta la historiaTransiciones: un punto final se convierte en una burbuja de chat, luego en el siguiente punto finalmatch
03La UI real, dirigidaRitmos del producto: interfaz real en 3D, cursor en arcos, enfoque selectivoui
04Corte al ritmoSecuencias de características y tipografía cinética: cortes duros en cada pulso, acercamientos, fotogramas invertidosbeat
05A pares, con ebullición de líneaUna capa dibujada a mano sobre UI limpia: los dibujos mantienen 2 fotogramas, las líneas tiemblan 12 veces/sboil
06Letras recortadas en papelTarjetas de título cálidas: cada grupo de letras unidas es una pieza de papel rígidacutout
07Los puntos al finalMarcas de palabra y revelados: primero los cuerpos de las letras, luego los puntos caennuqta
08Kashida, no espaciado entre letrasÉnfasis en una nota sostenida: estira el trazo de unión, medido en puntos caligráficoskashida

Elige por el brief, no por la novedad: una o dos técnicas distintivas usadas de manera consistente se leen como un sistema; las ocho a la vez se leen como un reel.

Herramientas en esta skill

  • scripts/shape_persian.py — da forma al persa con HarfBuzz y exporta contornos SVG divididos en cuerpos de letras, puntos y grupos de letras conectados (pip install uharfbuzz fonttools). Esto es lo que hace posible la animación por letra, por punto y kashida sin romper la escritura.
  • scripts/split_fa.js — divide una palabra persa en letras que mantienen sus formas unidas (conectores de ancho cero), para cuando los contornos son excesivos.
  • scripts/lint_persian.py — verifica texto (letras y dígitos árabes, espacios medios faltantes, puntuación en inglés, kashida fuera de lugar) y código (espaciado entre letras, cajas por letra, dir faltante).
  • assets/sketches/ — el motor de movimiento (engine.js), los ocho bocetos, datos de glifos con forma, estilos y gallery.html (sirve la carpeta con cualquier servidor estático).
  • assets/remotion/ — SketchPlayer (controla un boceto desde el número de fotograma), una composición de clip por técnica, la película de introducción completa como ejemplo funcional, y scripts para renderizar clips e imágenes fijas.
  • assets/music/compose_shur_pulse.py — una pista original a 120 BPM en Dastgah Shur escrita en código, con un mapa de pulsos; muestra cómo hacer que la edición se bloquee con la música.

Cuando el usuario solo quiere una pieza rápida

Mantén igualmente los dos no negociables que no cuestan nada: sin cajas por letra para el persa, y sin desvanecimientos de escena a escena. Usa una técnica bien, establece el tiempo en una cuadrícula de pulsos, y renderiza imágenes fijas para verificar el persa antes del renderizado completo.

Skills relacionados