Communitygithub.com

oleg-motion

Transforme imagens estáticas em movimento polido — banners em loop, anúncios animados, stories, clipes estilo cinemagraph (MP4/WebM/GIF).

O que é oleg-motion?

O oleg-motion é uma skill determinística de motion design que transforma imagens estáticas (JPG, PNG, PSD ou pastas de layers PNG) em animações profissionais, como banners em loop, anúncios animados para redes sociais, stories e clipes estilo cinemagraph. Ela opera renderizando uma cena HTML frame a frame em um navegador headless Chrome e codificando com ffmpeg, garantindo que loops fechem exatamente e renders sejam reproduzíveis. A skill suporta plataformas como Claude Code, Cursor e Codex, e oferece recursos como detecção automática de layers (com ML para imagens planas), importação de PSD, animação de câmera com parallax/2.5D, partículas (neve, folhas, poeira, confete, bokeh), efeitos de luz (brilho, flares, glow) e movimento de texto/produto, mantendo preços, logotipos e textos legais crispados. O fluxo de trabalho inclui briefing com opções clicáveis, plano de movimento acordado antes da renderização, separação de layers, construção da cena, renderização em rascunho e final, e entrega com arquivos e dicas de incorporação. A skill prioriza qualidade profissional com regras como um herói de movimento, amplitudes pequenas e ciclos inteiros para loops perfeitos.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/bonchuk/oleg-motion/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

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:

  1. 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.
  2. 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).
  3. 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).
  4. 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):

entradacomando
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 erraramescreva 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 MLescreva 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"

  • popout para 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 text para 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 cycles fracionário.
  • Primeiro quadro = poster final. Em loop o primeiro quadro já tem tudo no lugar; use intro-loop quando 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 de ffmpeg → 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.

Habilidades Relacionadas