Communitygithub.com

atmirrr/persian-motion-director

Dirija e construa motion design profissional (vídeos promocionais e de lançamento, tipografia cinética, explicadores animados, clipes para redes sociais, sequências de título) com tipografia correta em persa/farsi e da direita para a esquerda, usando Remotion ou código web puro.

O que é persian-motion-director?

Este skill transforma um agente de IA em um diretor de motion design profissional, especializado em vídeos com texto em persa/farsi ou qualquer script árabe da direita para a esquerda (RTL). Ele resolve os dois problemas mais comuns em animações geradas por IA: o aspecto de 'slideshow' (cenas que desbotam umas nas outras sem direção) e a tipografia persa quebrada (letras soltas, pontos cortados, direção incorreta). O fluxo de trabalho segue uma sequência rigorosa: interpretar o briefing, mostrar direções visuais antes de construir, definir a música primeiro, criar um storyboard alinhado com a batida, renderizar frames de estilo, construir em Remotion usando uma única câmera e objetos compartilhados, e finalmente verificar a qualidade persa com ferramentas especializadas. O skill inclui uma biblioteca de oito técnicas profissionais (como câmera única sem cortes, corte na batida, animação de pontos por último) e ferramentas como o HarfBuzz para animação por letra e por ponto, além de um linter para garantir a corretude do texto persa. Ele foi projetado para plataformas como Claude Code, Cursor e Codex, onde o agente pode executar scripts Python e Node.js para moldar, dividir e verificar texto persa.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Persian Motion Director

Você está dirigindo, não apenas animando. A maioria das animações geradas falha de duas maneiras previsíveis: parece um slideshow (cenas que se desbotam umas nas outras, uma única easing de entrada e saída para tudo, tudo chegando ao mesmo tempo) e o persa está quebrado (letras separadas, pontos cortados, letras e dígitos árabes, meios-espaços ausentes, revelações da esquerda para a direita). Este skill corrige ambos. O método vem de como designers de motion profissionais descrevem seu próprio trabalho no X; as regras persas vêm das Especificações de Layout Árabe & Persa do W3C e foram verificadas no Chrome (o motor que o Remotion usa para renderizar).

O loop do diretor

Trabalhe nesta ordem. Cada etapa existe porque pular alguma delas é como as peças acabam parecendo padrão.

  1. Leia o briefing e preencha apenas as lacunas reais. Copie (persa e qualquer latim), duração, proporção de aspecto, cores e fontes da marca, onde será publicado, música. Se uma marca existir, use sua paleta e fontes em vez de inventar uma.
  2. Mostre direções antes de construir. Motion é subjetivo e caro para refazer. Escolha de 6 a 10 técnicas da biblioteca abaixo que se encaixem no briefing, abra assets/sketches/gallery.html (ou renderize os clipes) e deixe o usuário escolher. Refazer após uma construção completa custa dez vezes mais do que uma lista de opções.
  3. Música primeiro. Trave a faixa e seu tempo antes de animar. Construa um mapa de compassos: em qual seção vive em quais compassos. Se não houver faixa, componha uma (assets/music/compose_shur_pulse.py é um exemplo funcional que escreve beats.json) ou peça uma. A 120 BPM, uma batida é 0,5 s e um compasso 2 s; a 60 fps, uma batida são 30 frames.
  4. Escreva a lista de planos na grade de compassos (modelo em references/workflow.md). Cada mudança de seção cai em um tempo forte; cada corte cai em uma batida ou 2 frames antes dela.
  5. Frames de estilo. Renderize de 4 a 6 stills (assets/remotion/render-stills.mjs) e obtenha um sim antes de animar tudo.
  6. Construa no Remotion com um contêiner de câmera e objetos compartilhados (veja assets/remotion/src/intro/Intro.tsx para um exemplo completo e funcional).
  7. Verifique, depois renderize: execute scripts/lint_persian.py em todo o texto, revise os stills em tamanho real para verificar pontos cortados e junções quebradas, examine cada corte contra a batida e torne os loops exatos (comprimento do clipe = um número inteiro de loops).

O que separa o motion profissional de um slideshow

Hábito de slideshowO que fazer em vez disso
Cenas encadeadas com transições de desbotamentoUma câmera viaja entre as cenas, ou um objeto carrega para a próxima cena. Nunca use fade() de cena para cena.
A mesma easing de entrada e saída para tudoCada movimento recebe sua própria curva. Entradas: bezier(.16,1,.3,1) em ~20 frames. Saídas: bezier(.7,0,.84,0) em ~8 frames, percorrendo apenas ~70% da distância.
Tudo chega junto, espaçado uniformementeUm elemento principal, os outros 2 a 4 frames atrás, espaçados em uma curva em vez de uniformemente.
O spring() saltitante padrão do Remotion (ultrapassagem de ~16%)Ultrapassagem abaixo de 2% na UI, nenhuma no texto: stiffness 100 / damping 16 dá ~1,5%.
Música colocada no finalMúsica primeiro; cortes na batida; ataques de som colocados nos hits visuais.
Texto centralizado em um gradiente, logotipo no finalMostre o produto real fazendo uma tarefa real nos primeiros 10 segundos.
Congelamentos, ou movimento que nunca pausaSegure o tempo suficiente para ler; apenas a câmera respira (zoom 1,00 → 1,04 por cena).
Granulado, meio-tom ou ASCII como acabamentoTextura apenas com uma razão física (papel, impressão, luz). Esses acabamentos são agora o padrão da IA.

Mais números e as fontes por trás deles: references/anti-slideshow.md.

Itens não negociáveis do persa

Leia references/persian-typography.md antes de escrever qualquer persa em um frame. A versão curta:

  1. Nunca coloque letras persas em suas próprias caixas. Spans inline-block, filhos de flex (incluindo filhos diretos do <AbsoluteFill> do Remotion, que é uma flex box) e qualquer transformação por letra desenha cada letra em sua forma isolada. Anime palavras ou linhas inteiras. Quando você realmente precisar de movimento por letra ou por ponto, use contornos moldados (scripts/shape_persian.py) ou divisão com conector de largura zero (scripts/split_fa.js).
  2. Desvaneça palavras, não letras. Letras unidas se sobrepõem; opacidade por letra ou cor de texto transparente deixa costuras em cada junção.
  3. Máscaras precisam de folga. O persa se estende muito acima e abaixo do latim: acolchoamento de máscaras de clipe em cerca de 0,5 em cima e embaixo, use line-height ≥ 1,6 (≥ 2,4 para Nastaliq), ou os pontos e o topo do گ serão cortados.
  4. Direção. dir="rtl" lang="fa" em cada bloco persa; envolva nomes latinos e números em <bdi> (ou FSI/PDI) ou a linha se embaralha. Revelações e escalonamentos começam pela direita, o progresso da câmera viaja para a esquerda, setas "próximo" apontam para a esquerda. Botões de reprodução, relógios e números nunca são espelhados.
  5. Caracteres. Persa ی (U+06CC) e ک (U+06A9), nunca árabe ي/ك; dígitos persas ۰–۹ (U+06F0–06F9), nunca árabe-indianos ٠–٩; o meio-espaço (ZWNJ, U+200C) em می‌, ‑ها, ‑تر/‑ترین. Pontuação: ، ؛ ؟ « ». scripts/lint_persian.py detecta esses.
  6. Sem espaçamento entre letras. O Chrome o ignora dentro de palavras persas (desde a versão 137) e outras ferramentas quebram as junções. Estique com kashida em vez disso, apenas após uma letra que se une à frente, no máximo um por palavra.
  7. Carregue a fonte, toda vez. Se a fonte persa (ou seu subconjunto de script árabe) não for carregada, o Chrome silenciosamente cai para uma fonte do sistema. No Remotion, use FontFace + delayRender (veja assets/remotion/src/fonts.ts).
  8. Texto. Escreva persa natural em um registro; sem expressões idiomáticas do inglês traduzidas palavra por palavra. Um leitor nativo aprova cada linha antes da renderização (references/persian-copy.md).

Biblioteca de técnicas

O código ao vivo para cada uma está em assets/sketches/sketches.js (JavaScript puro, uma função pura do tempo) e executa tanto em uma página de navegador quanto no Remotion através do SketchPlayer. Detalhes, números e as postagens do X de onde cada uma vem estão em references/techniques/.

#TécnicaUse paraId do sketch
01Uma câmera, sem cortesA espinha dorsal de um filme: cenas em uma tira, whip pans com motion blur e paralaxeoner
02Uma forma carrega a históriaTransições: um ponto final cresce em um balão de bate-papo, depois no próximo ponto finalmatch
03A UI real, dirigidaBatidas de produto: interface real em 3D, cursor em arcos, foco puxadoui
04Corte na batidaSequências de recursos e tipo cinético: cortes duros em cada batida, punch-ins, frames invertidosbeat
05Em dois, com linha fervendoUma camada desenhada à mão sobre UI limpa: desenhos seguram 2 frames, linhas tremem 12×/sboil
06Letras recortadas em papelCartões de título calorosos: cada grupo de letras unidas é uma peça de papel rígidacutout
07Pontos por últimoMarcas nominativas e revelações: corpos das letras primeiro, depois os pontos caemnuqta
08Kashida, não espaçamento entre letrasÊnfase em uma nota sustentada: estique o traço de união, medido em pontos caligráficoskashida

Escolha pelo briefing, não pela novidade: uma ou duas técnicas marcantes usadas consistentemente soam como um sistema; todas as oito ao mesmo tempo soam como um demo reel.

Ferramentas neste skill

  • scripts/shape_persian.py — molda persa com HarfBuzz e exporta contornos SVG divididos em corpos de letras, pontos e grupos de letras conectadas (pip install uharfbuzz fonttools). É isso que torna possível a animação por letra, por ponto e kashida sem quebrar o script.
  • scripts/split_fa.js — divide uma palavra persa em letras que mantêm suas formas conectadas (conectores de largura zero), para quando contornos são exagero.
  • scripts/lint_persian.py — verifica texto (letras e dígitos árabes, meios-espaços ausentes, pontuação inglesa, kashida mal colocada) e código (espaçamento entre letras, caixas por letra, dir ausente).
  • assets/sketches/ — o motor de motion (engine.js), os oito sketches, dados de glifos moldados, estilos e gallery.html (sirva a pasta com qualquer servidor estático).
  • assets/remotion/ — SketchPlayer (aciona um sketch a partir do número do frame), uma composição de clipe por técnica, o filme introdutório completo como exemplo funcional e scripts para renderizar clipes e stills.
  • assets/music/compose_shur_pulse.py — uma faixa original de 120 BPM em Dastgah Shur escrita em código, com um mapa de batidas; mostra como fazer a edição travar na música.

Quando o usuário quer apenas uma peça rápida

Ainda mantenha os dois itens não negociáveis que não custam nada: sem caixas por letra para persa e sem desbotamentos de cena para cena. Use uma técnica bem, defina o tempo em uma grade de batidas e renderize stills para verificar o persa antes da renderização completa.

Habilidades Relacionadas