O que oleg-motion faz?
Motion design determinístico a partir de imagens estáticas: uma cena HTML renderizada quadro a quadro em Chrome headless, codificada com ffmpeg. Tudo é uma função pura do tempo, então os loops fecham exatamente e as renderizações são reproduzíveis. Fale com o usuário no idioma dele; mantenha nomes de arquivo e JSON da cena em inglês.
$OM abaixo significa o diretório desta skill (a pasta que contém este SKILL.md).
0. Certifique-se de que funciona (uma vez por máquina)
Execute tudo através do lançador $OM/om — ele coloca o Node, ffmpeg e Python da própria skill
primeiro no PATH, então funciona em um Mac limpo sem ferramentas de desenvolvedor.
$OM/om doctor # o que está instalado
bash $OM/scripts/setup.sh # núcleo: Node.js, ffmpeg, motor de renderização (baixa o que estiver faltando)
$OM/om setup --psd # + importação PSD
$OM/om setup --ml # + camadas automáticas para imagens planas (~1 GB incluindo modelos)
$OM/om update # versão mais recente do GitHub (funciona sem git), depois setup novamente
A instalação não precisa de senha de administrador, Homebrew ou git: ferramentas ausentes são baixadas para
~/.cache/oleg-motion/tools (substitua a pasta com OLEG_MOTION_HOME); ferramentas já na
máquina são usadas quando são boas o suficiente. O núcleo sozinho já pode animar qualquer imagem (câmera,
partículas, luz, sobreposições). Pergunte antes de executar --ml — ele baixa modelos. Se om não for
executável (descompactado de um zip), execute bash $OM/om ….
1. Briefing — olhe primeiro, depois pergunte com opções clicáveis
As pessoas enviam um arquivo e dizem "faça mexer". A maioria não consegue descrever movimento em palavras, então não faça perguntas abertas — olhe a imagem primeiro (abra-a), liste seus elementos (título, preço, botão, logotipo, fotos, produto, setas…), depois pergunte.
Kit de marca primeiro. Se a solicitação nomear uma marca/projeto, ou um *.brand.json /
oleg-motion.brand.json estiver na pasta de trabalho, ou $OM/brands/ tiver um kit
correspondente, carregue-o e passe --brand para scene: seus padrões respondem a maioria das perguntas (pule-as) e
suas regras protect / avoid / notes são obrigatórias. Formato: references/brand-kit.md. Sem kit ainda →
ofereça-se para salvar um na entrega (etapa 6).
Nunca pergunte sobre técnica — temporizações, curvas de easing, amplitudes, atrasos, contagens de partículas são padrões profissionais (references/motion-guidelines.md). Altere-os apenas quando a pessoa pedir. Cada pergunta oferece um padrão que eles podem simplesmente aceitar.
Pule as perguntas quando o usuário disser "просто зроби" / "apenas faça" / "por conta própria", ou as respostas já estiverem na solicitação: escolha os padrões e indique-os em uma linha.
Caso contrário, pergunte uma vez, com opções — use a ferramenta AskUserQuestion quando disponível
(cartões clicáveis; caso contrário, uma mensagem com opções numeradas). Até 4 perguntas, cada
uma com sua opção recomendada primeiro, com base no que você viu na imagem:
- Onde vai ser usado? → perfil: "como está — não mudar proporções" (
source: a proporção original, lado maior limitado a 1920 px), post do Instagram 4:5 (feed-portrait), Stories/Reels 9:16 (story), banner de site (web-hero/web-strip), anúncio display GIF (display-*). Ajuste as 4 opções à imagem: se a proporção dela já corresponder a um formato (ex.: 4:5 → post do Instagram), ofereça esse formato em vez de um "como está" separado (mesmo resultado) e recomende-o; caso contrário, recomende "como está" primeiro. Um formato com outra proporção corta a imagem (fit: cover) ou adiciona margens borradas (contain-blur) — diga qual, e o que é cortado (bordas do título, o CTA), para que a pessoa não seja surpreendida. - Personagem? → 3–4 humores que se encaixam na imagem, descritos pela sensação, não pelo nome:
"calmo & premium", "energético", "festivo", "quase parado". Mencione o humor correspondente
na descrição (
premium,energetic,festive,calm…; lista completa:$OM/om moods). - Estrutura? → "elementos aparecem, depois loop" (
intro-loop, bom para posts sociais), "apenas loop contínuo" (loop, bom para banners de site), "uma passagem com final" (oneshot). - Qual é o herói? (multiSeleção) → os 3–4 elementos mais proeminentes que você encontrou, ex.: "título SUMMER SALE", "botão CTA", "fotos", "produto". O herói recebe o movimento principal; todo o resto permanece calmo.
Padrões se não respondido: perfil da proporção, 6 s (intro 2 s + loop 4 s para intro-loop), MP4, humor escolhido da paleta e assunto. Um vídeo de referência ("como este") substitui qualquer resposta — analise-o com references/reference-analysis.md e copie seu ritmo, não seu conteúdo.
2. Plano de movimento — concordar em palavras antes de renderizar
Antes da primeira renderização, mostre o plano em linguagem simples (idioma do usuário), uma linha por elemento, com temporização — ex.:
Intro (2 s): logotipo aparece → título sobe por linhas → «-30%» surge → botão e produto aparecem por baixo. Loop (4 s): «-30%» brilha levemente, um brilho percorre por cima · botão pulsa · produto flutua levemente · poeira quente no fundo. Não se move: logotipo (apenas uma centelha), preço após aparecer, datas.
Pergunte "Fazemos assim, ou algo muda?" na mesma mensagem e prossiga apenas após um sim (ou quando o usuário pulou as perguntas — então renderize imediatamente e mostre o plano com o resultado). Mudar o plano custa segundos; mudar uma renderização custa minutos. O plano também decide quais elementos precisam de sua própria camada na próxima etapa.
3. Obter camadas
Escolha pela entrada — o objetivo é um layers.json com funções (veja references/scene-format.md):
| entrada | comando |
|---|---|
| JPG/PNG plano, ML instalado | $OM/om py $OM/scripts/ml/auto_layers.py in.jpg --out work/layers |
| PSD | $OM/om py $OM/scripts/psd_layers.py in.psd --out work/layers |
| pasta de camadas PNG | $OM/om layers-from-dir path/to/pngs |
| criativo projetado (cartões, botões, setas, fotos com cabeças fora do quadro) ou camadas automáticas erraram | escreva regions.json (caixas/polígonos + modo de máscara) → $OM/om py $OM/scripts/ml/cut_regions.py regions.json --out work/layers (formato na docstring do script) |
| imagem plana, sem ML | escreva layers.json manualmente: uma camada background (e peça caixas de texto se as partículas devem evitar texto) |
Para regions.json, encontre coordenadas medindo, não a olho: limiarize pixels claros/escuros
e imprima as caixas delimitadoras dos componentes; para cartões de foto, escaneie a cor do quadro e ajuste
as bordas (um polígono 3–5 px dentro da borda real deixa uma linha brilhante no fundo e
recorta o cartão). Use mask: "contrast" para texto/logotipos/linhas em um fundo plano, "full"
popoutpara cartões de foto com uma cabeça saindo,"seg"para objetos em fotos movimentadas.
Sempre abra preview.png / as PNGs da camada e verifique a separação antes de construir a cena:
camadas automáticas podem rotular erroneamente (um logotipo detectado como texto, um preço como título, um assunto que é
na verdade fundo). Corrija as funções em layers.json — funções decidem o que pode se mover. Se o recorte
do assunto estiver ruim, descarte essa camada em vez de animar uma borda irregular.
4. Construir a cena
$OM/om scene --layers work/layers/layers.json --mood energetic \
--profile feed-portrait --structure intro-loop [--brand brand.json] \
[--intensity 1] [--speed 1] [--density 1] --out work/scene.json
Isso cria um rascunho de scene.json a partir do pacote de humor (e kit de marca). Em seguida, edite-o para corresponder ao
plano acordado — é aí que está o trabalho artesanal: temporizações de intro por camada com atraso de 50–100 ms
(cascata completa ≤ 2 s, entradas 400–800 ms, ease-out; bounce apenas em um elemento lúdico),
luz/brilho do herói, movimento de decoração (setas quicam, crachás giram), partículas em uma cor de
destaque da imagem ou kit de marca. Leia references/effects.md para cada efeito e seus parâmetros, e
references/motion-guidelines.md para limites que mantêm o resultado profissional.
5. Renderizar, olhar, iterar
$OM/om render work/scene.json --out work/out --quality draft # verificação rápida
$OM/om render work/scene.json --out work/out --formats mp4,webm,gif # final
Após cada renderização, veja *-sheet.jpg (8 quadros) e, quando algo estiver em dúvida,
extraia quadros individuais (ffmpeg -ss 2.5 -i out.mp4 -frames:v 1 f.png) e veja-os. O
relatório (*-report.json, resumido no stderr) verifica: emenda do loop, flashes (≤3/s),
camadas bloqueadas não se movendo, zonas seguras (texto/preço/CTA ≥ 10 % das bordas, logotipos ≥ 5 %; cut = uma
mudança de formato cortou, as-designed = a fonte já estava tão apertada), orçamento de arquivo.
Corrija falhas antes de entregar — uma emenda visível geralmente
significa um cycles não inteiro; uma falha de orçamento significa menos partículas/grão, ou menor tamanho/fps
do GIF.
Mostre ao usuário o rascunho (folha de contato ou o MP4) e convide ajustes nas palavras dele — "mais lento", "menos brilho", "sem partículas", "botão mais brilhante", "remove a intro". references/tweaks.md mapeia tais frases para edições de cena; aplique-as, re-renderize como rascunho, e renderize o final apenas quando ele estiver satisfeito.
Custo em um laptop (M1, 8 GB): camadas automáticas ≈ 3–4 min por imagem (execute uma vez, depois itere na cena); renderização ≈ 0,2–0,4 s por quadro (6 s a 30 fps ≈ 1 min). Informe o usuário antes de etapas longas.
6. Entregar
Entregue ao usuário: os arquivos (caminhos + tamanhos), o JPG do poster, uma frase sobre o que se move, e
para sites a dica de incorporação <video autoplay muted loop playsinline poster="…">. Se a
plataforma de destino tiver limites rígidos (tamanho exato, codec, MB máx.), diga que foram
atendidos — ou não. Se este foi um trabalho de marca e nenhum kit existe ainda, ofereça-se em uma linha para salvar um
(references/brand-kit.md) para que da próxima vez as perguntas já estejam respondidas.
Regras que mantêm a qualidade (e porquê)
- Um movimento de herói, ≤ dois ambientes. Os espectadores leem uma coisa de cada vez; movimento extra compete com a mensagem.
- Preços, textos legais e logotipos permanecem rígidos. Movimento borra e treme as letras —
legibilidade e confiança na marca superam o estilo. As funções impõem isso; não reatribua um preço a
textpara obter movimento nele. - Não finja o movimento de uma pessoa. Uma pessoa recortada não pode correr ou acenar; balançar ou pulsar a figura inteira parece um fantoche de papelão. Dê profundidade às pessoas (paralaxe da câmera) e uma intro, nada mais.
- Amplitudes pequenas. 3–6 % de avanço da câmera, 2–4° de inclinação, ≤ 2 % de respiração. Zooms grandes e paralaxe causam enjoo de movimento e parecem amadores.
- Ciclos completos apenas. O loop é contínuo porque cada movimento completa um número inteiro
de ciclos por loop — nunca defina
cyclesfracionário. - Primeiro quadro = poster final. Em
loopo primeiro quadro já tem tudo no lugar; useintro-loopquando forem desejadas entradas. - Sem redesenho generativo de texto. Esta skill nunca repinta texto ou produtos; vídeo de IA (opcional, veja references/ai-video.md) é apenas para fundos, com as camadas originais compostadas de volta por cima.
Solução de problemas
Playwright is not installed,Node.js is missing, erros deffmpeg→bash $OM/scripts/setup.sh.- Quadros em branco ou pretos → um caminho de camada está errado (verifique avisos no stderr) ou a cena não tem camada de fundo.
- Detecção de texto ignorada →
ocrmacé apenas para macOS; em outros lugares, passe camadas de texto manualmente. - Halos nas bordas em paralaxe → reduza
depthParallax.amp, ou pinte a placa novamente (camadas automáticas faz isso a menos que--no-inpaint). - GIF muito grande → os perfis
display-*o encolhem automaticamente; caso contrário, reduza fps/largura.