Communitygithub.com

motion-spot

Produza spots de motion graphics de nível agência (anúncios de produto e app, spec ads, lançamentos, intros de marca, showreels) 100% com código. Usa HTML com GSAP, CSS 3D e Three.js, renderizado quadro a quadro com desfoque de movimento real, locução e música composta ou própria.

O que é motion-spot?

O **motion-spot** é uma skill para agentes de IA (como Claude Code, Cursor ou Codex) que cria vídeos animados de alta qualidade, no estilo de agências de publicidade, inteiramente através de código. Diferente de ferramentas tradicionais de motion graphics, ele gera cada quadro como o estado de uma página web, usando HTML, GSAP, CSS 3D e Three.js. Um motor personalizado percorre uma timeline do GSAP pausada, quadro a quadro, sem janela do Chrome, e o ffmpeg monta o MP4 final com desfoque de movimento, brilho e grano aplicados. A skill foi desenvolvida a partir da análise de dezenas de spots reais que alcançaram milhões de visualizações, garantindo uma receita comprovada: um conceito com tensão, a interface real do produto como protagonista, tipografia cinética, câmera sempre em movimento, sincronia com a locução, um pico na cor da marca e um fechamento limpo com logo e lema. Ela suporta desde spots de produto, comerciais de app e intros de marca até showreels e vídeos musicais, seguindo um fluxo completo que inclui conceito, roteiro, storyboard, sistema visual, locução (ElevenLabs ou voz sintetizada), música (composta ou própria), renderização e entrega final. O usuário deve fornecer ativos reais (logotipo, capturas de tela, cores) para evitar resultados genéricos, e a skill inclui regras estritas para evitar o "visual padrão do Claude", garantindo autenticidade e fidelidade à marca ou referência fornecida.

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

Perguntar na sua IA favorita

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

Documentação

O que motion-spot faz?

Produz spots que parecem de estúdio, com um método extraído da análise de 45 spots feitos com Claude que alcançaram milhões de visualizações (references/estudio.md). A receita que se repete em todos:

Um conceito com tensão (não uma lista de funções) + a interface ou o produto real como protagonista + tipografia cinética + uma câmera que nunca fica parada + cada coisa exatamente quando a voz a nomeia + um pico na cor da marca + um fechamento limpo com logo e lema.

Tudo é código: cada quadro é um estado de uma página web. Uma timeline do GSAP pausada é percorrida quadro a quadro no Chrome sem janela, e o ffmpeg monta o MP4 com desfoque de movimento, brilho e granulado. O motor já está pronto e testado em plantilla/motor/, com um spot de exemplo completo em plantilla/escenas.js.

Se o usuário der um vídeo de referência ("faz igual")

  1. Desmonta a referência antes de projetar: 8 a 12 quadros por segundo dos trechos chave em bom tamanho (folha de contato com Read), anotando cada elemento: qual UI real aparece, qual fonte, qual cor, como entra e sai (esticar, desfocar, virar).
  2. Copia a estrutura e os elementos reais, não um "equivalente genérico": se o original usa bolhas do iMessage, use -apple-system (SF do sistema) e bolha com rabo; se usa o card de letra do Spotify, recrie-o com sua etiqueta, botões e cor; se usa uma palavra gigante, é Arial Black (vem no macOS).
  3. Tipografia: nunca a de sempre. O usuário já rejeitou várias vezes a tipografia padrão do Claude (sans preta apertada com tracking muito negativo, Inter, serif itálica). Use a fonte da marca em seus cortes ESTÁTICOS reais (ex.: MonaSans-Black/Bold/Regular.ttf de SocialMedia/fuentes/, as mesmas dos vídeos de ilustração) com tracking normal (-0,01 em no máximo), a da referência se houver, ou pergunte/mostre 3 testes antes de renderizar. Nunca fontes variáveis em peso intermediário com tracking apertado. 3b. Proibido por padrão o "look Claude": Inter/Anton/serif itálica/HUD mono aparecem só se a referência ou a marca os usar. Com referência, a tipografia e os elementos são os dela.
  4. Peça capturas reais do que não puder ser recriado fielmente (app, player, capa): o usuário as solta em activos/. Spotify e outros apps podem estar bloqueados para controle por política: não se contorna o bloqueio, pede-se a captura ou usa-se uma imagem pública e avisa-se.
  5. Mostre uma folha de fotos da sua versão junto com a da referência e corrija as diferenças antes de entregar.
  6. Leia references/referencia-fiel.md: processo completo, receitas de cada elemento (bolhas do Apple Messages, card de letra do Spotify, controles em SVG, sombreamento deslizante) e os erros que já custaram rodadas. Peças prontas em motor/ui.js e motor/ui.css; exemplo completo em ejemplos/video-con-letra/.

Antes de começar

Você precisa saber, e se não estiver claro, pergunte em uma única mensagem, com valores padrão propostos:

  1. O que está sendo anunciado e para quem (uma linha).
  2. Ativos reais: logotipo (SVG melhor), capturas do app ou site, fotos do produto, cores. Um site também serve. Sem ativos reais a marca fica genérica: peça-os sempre. Se não houver, projete uma identidade de exemplo e avise.
  3. Formato e duração: 9:16 e de 15 a 20 s por padrão. 16:9 para web ou YouTube.
  4. Locução: ElevenLabs (definitiva), say (rascunho) ou sem locução.
  5. Música: composta pelo motor ou uma faixa própria (recomendado para publicar).

Se o usuário trouxer um briefing completo (references/encargo.md) ou disser "as decisões são suas", não pergunte: produza e explique depois em DECISIONES.md.

Fluxo

1. Projeto

bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <pasta-do-spot>          # com o exemplo "Turnito" como referência
bash ~/.claude/skills/motion-spot/scripts/nuevo.sh <pasta-do-spot> --limpo # esqueleto vazio

Copia o template, instala dependências (cerca de 10 s) e verifica se o Chrome está disponível. Copia os ativos do usuário para activos/.

2. Conceito e arquétipo

Leia references/arquetipos.md e escolha um (mais um plano emprestado para o momento uau). Escreva:

  • O conceito em uma frase, com sua tensão: "A bagunça do sábado contra a calma de reservar em 3 toques".
  • O insight de marca: um detalhe próprio da marca que ninguém mais poderia usar (a seta da Amazon que une o A ao Z, o swoosh que corta a tela). Se não houver um, o spot será genérico.

3. Roteiro de locução → guion.json

Leia references/voz-y-musica.md. A locução é escrita antes da animação, pois marca o tempo de tudo. Uma frase por cena, de 2 a 8 palavras, com acentos e sinais de abertura. Gancho de situação ("São 2 da manhã..."), ação, benefício, pico e marca + lema. Escreva guion.json com as cenas, o BPM, o estilo musical, a cena pico e os efeitos.

4. Folha de planos

Uma tabela, uma linha por cena: tempo · locução · herói · câmera · técnicas de motion graphics (3 ou mais, de references/lenguaje.md) · transição de saída. Regras:

  • Três camadas por plano: fundo vivo + herói + detalhe.
  • A câmera sempre se move. Transições de motion graphics (corte no beat, zoom através, cortina, íris, empurrão), sem fades.
  • Um pico próximo aos 70 % na cor da marca ou em 3D.
  • Mínimo 8 técnicas diferentes no spot.

Se o spot for longo ou caro, mostre a folha ao usuário antes de construir. Se ele pediu "faz", continue.

5. Sistema visual → estilo.css

Leia references/diseno.md. Defina variáveis (--fundo, --tinta, --acento, --acento2...) e as classes da interface recriada com prefixo próprio (.ui ...). Tipografia: sans preta apertada + uma palavra em serif itálica + mono para o HUD (já vêm instaladas: Inter, Instrument Serif, JetBrains Mono e Anton).

6. Locução e tempos

  • ElevenLabs: uma geração por cena → audio/voz/<id>.mp3 → node motor/preparar.mjs --recortar.
  • Rascunho: node motor/preparar.mjs --rascunho-voz.
  • Depois node motor/preparar.mjs: mede as locuções, quantiza os cortes no pulso e escreve guion.tempos.json com o tempo estimado de cada palavra.

7. Construir cena por cena → escenas.js

Leia references/motor.md (API, receitas e armadilhas conhecidas). Para cada cena:

  1. spot.cena('id', (camada, c) => { ... }) com suas três camadas, sua deriva de câmera e suas técnicas.
  2. Sincronize com a locução: spot.quando('id', 'palavra').
  3. node motor/render.mjs --fotos <inicio+0.1>,<meio>,<fim-0.1> e olhe a folha (saida/fotos/folha.jpg) com Read. Corrija antes de continuar.

Use plantilla/escenas.js (Turnito) como referência de nível: como fazer a oclusão, a órbita, a roda da hora, as notificações, o 3D de voxels, a cortina e o zoom através.

8. Música e mixagem

node motor/musica.mjs   # compõe no BPM, com queda na cena "pico"; ou usa a faixa própria de guion.json
node motor/mixagem.mjs   # locuções + música com ducking + efeitos, a -14 LUFS

Com node motor/servir.mjs o usuário pode ver a prévia com áudio e percorrê-la.

9. Render, revisão e polimento

node motor/render.mjs --fotos                 # folha de 12 fotos: composição, ortografia e zonas seguras
node motor/render.mjs --subida                # final: 30 fps, desfoque 4×, acabamento, mais a cópia de < 10 MB (2 a 3 min para cada 20 s)

Passe a lista de references/qualidade.md (três passadas). Depois faça uma rodada só de polimento: microanimações secundárias, acentos nos golpes, primeiros e últimos quadros de cada cena. A segunda rodada é o que separa o bom do excelente.

10. Entrega

  • saida/spot.mp4 e saida/spot-subida.mp4.
  • Capa: a foto do momento mais marcante, não a primeira.
  • DECISOES.md: conceito, arquétipo, decisões, o descartado, iterações e tempo (template em qualidade.md).
  • No chat: o caminho, o que é rascunho (locução say, música sintetizada) e 2 ou 3 melhorias concretas.

Regras que não se quebram

  1. Tudo é função do tempo t. Nada de Math.random, Date.now, animações CSS, setTimeout nem requestAnimationFrame no spot. Para aleatoriedade: ruido(i) ou azar(semente).
  2. Nunca coloque transform no CSS de algo que GSAP anima (use xPercent/yPercent). É a causa número um de elementos desalinhados.
  3. Olhe as fotos de cada cena antes de continuar. Nada é entregue sem ter sido visto.
  4. Ativos reais ou se diz que são de exemplo. As interfaces são recriadas com fidelidade a partir de capturas, não se inventam "genéricas".
  5. Marcas de terceiros: um spot de uma marca real que não é do usuário é um exercício de portfólio ("spec"). Não se publica como se fosse oficial, não se sugere relação com a marca e seu logotipo não é deformado.
  6. Dados: são do usuário ou marcados como ilustrativos.
  7. Não posso ouvir. Verifico níveis (pico de -1 a -2 dB, -14 LUFS) e que a locução soe acima da música; o usuário julga de ouvido.
  8. Contexto: um spot gasta bastante contexto. Se a sessão passar de 40 % de contexto, compacte antes de continuar construindo.
  9. Letras de músicas: Claude não as escreve em lugar nenhum (código, letra.json, chat), mesmo que o usuário as forneça. Para vídeos com letra: tempos em letra.json com o texto vazio, spot que funciona com e sem letra, validação com frases neutras em uma cópia de teste, e o usuário cola a letra e executa o render final. Detalhes em references/motor.md → "letra.json".

Vídeos musicais e com vídeo de fundo

node motor/extrair.mjs <video> --de S --ate S extrai os quadros (activos/clip/) e o áudio do trecho; videoQuadros(...) os exibe sincronizados; motor/letra.js faz o karaokê a partir de letra.json. Arquétipo 9 em references/arquetipos.md.

Se algo falhar

SintomaCausa provável
window.spot.pronto nunca é trueErro de JS em escenas.js: o render imprime os erros da página. Revise os imports e se existe await spot.terminar()
Um elemento aparece desalinhado ou pulatransform no CSS mais GSAP; ou uma classe que colide com outra (.app); ou um seletor descendente muito amplo
Uma cena aparece em branco ou pretoO id não está no roteiro (execute preparar.mjs), ou uma transição deixou a camada com opacity: 0
O 3D parece planoFalta transform-style: preserve-3d em um contêiner intermediário, ou há um overflow ou filter no meio
A locução e a imagem não coincidemAjuste ± 0,1 s em spot.quando(...); revise em servir.mjs com áudio
O render demora muitoUse --blur 1 --escala 0.5 para rascunhos; reduza nós com sombra ou desfoque; diminua n em voxelOnda ou particulas
O MP4 pesa demaisÉ o granulado: --grano 3 ou --crf 22; para upload, --subida

Habilidades Relacionadas