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")
- 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).
- 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). - 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.ttfdeSocialMedia/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. - 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. - Mostre uma folha de fotos da sua versão junto com a da referência e corrija as diferenças antes de entregar.
- 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 emmotor/ui.jsemotor/ui.css; exemplo completo emejemplos/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:
- O que está sendo anunciado e para quem (uma linha).
- 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.
- Formato e duração: 9:16 e de 15 a 20 s por padrão. 16:9 para web ou YouTube.
- Locução: ElevenLabs (definitiva),
say(rascunho) ou sem locução. - 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 escreveguion.tempos.jsoncom 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:
spot.cena('id', (camada, c) => { ... })com suas três camadas, sua deriva de câmera e suas técnicas.- Sincronize com a locução:
spot.quando('id', 'palavra'). 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.mp4esaida/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 emqualidade.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
- Tudo é função do tempo
t. Nada deMath.random,Date.now, animações CSS,setTimeoutnemrequestAnimationFrameno spot. Para aleatoriedade:ruido(i)ouazar(semente). - Nunca coloque
transformno CSS de algo que GSAP anima (usexPercent/yPercent). É a causa número um de elementos desalinhados. - Olhe as fotos de cada cena antes de continuar. Nada é entregue sem ter sido visto.
- 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".
- 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.
- Dados: são do usuário ou marcados como ilustrativos.
- 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.
- Contexto: um spot gasta bastante contexto. Se a sessão passar de 40 % de contexto, compacte antes de continuar construindo.
- 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 emletra.jsoncom 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 emreferences/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
| Sintoma | Causa provável |
|---|---|
window.spot.pronto nunca é true | Erro 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 pula | transform no CSS mais GSAP; ou uma classe que colide com outra (.app); ou um seletor descendente muito amplo |
| Uma cena aparece em branco ou preto | O id não está no roteiro (execute preparar.mjs), ou uma transição deixou a camada com opacity: 0 |
| O 3D parece plano | Falta 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 coincidem | Ajuste ± 0,1 s em spot.quando(...); revise em servir.mjs com áudio |
| O render demora muito | Use --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 |