Vídeo de marketing
O vídeo é uma única página HTML na qual cada pixel é uma função pura do tempo, seek(t), renderizada quadro a quadro com motion blur e uma trilha sonora posicionada ao milissegundo. Tudo o que é específico de uma marca vem do briefing; nada é assumido. Fale com a pessoa no idioma dela. SKILL_DIR abaixo é a pasta que contém este arquivo.
0. Primeira execução: as ferramentas
bash SKILL_DIR/scripts/check_deps.sh
Ele lista o que falta nesta máquina (node 18+, ffmpeg, python3, numpy) com os comandos de instalação para seu sistema. Se faltar algo, informe à pessoa em palavras simples para que serve cada ferramenta, mostre os comandos e pergunte uma vez se deseja instalá-los. Instale apenas mediante confirmação e, em seguida, execute a verificação novamente. Um comando que precise da senha ou abra seu próprio instalador (Homebrew, sudo) é algo que a pessoa executa em seu próprio terminal; passe-o para ela e aguarde. Faça as perguntas do briefing enquanto isso: nada mais depende das ferramentas até a etapa 2.
1. Briefing: pergunte tudo primeiro
Envie as perguntas em references/intake.md em uma única mensagem. Obrigatório antes de construir qualquer coisa:
- o assunto: o que o vídeo diz, para quem, onde será publicado;
- um vídeo de inspiração: a entrada mais útil;
- o sistema de design, ou permissão explícita para usar padrões neutros;
- capturas de tela da UI sempre que o vídeo mostrar um produto.
Cada entrada deve terminar como um arquivo local: peça para baixar ou busque você mesmo quando uma ferramenta permitir. Todo o resto tem um padrão definido. Se um item obrigatório ainda estiver faltando após um lembrete, não inicie nada que dependa dele; para a inspiração apenas, ofereça o estilo próprio do mecanismo (uma forma contínua que se transforma) e continue assim que a pessoa aceitar.
Crie o projeto e registre as respostas em brief.md:
bash SKILL_DIR/scripts/setup.sh ~/marketing-videos/<slug> # modelo, scripts, Playwright local
cd ~/marketing-videos/<slug> # todos os comandos seguintes executam daqui
2. Leia a inspiração e confirme a leitura
python3 inspect_inspiration.py <video> # contact sheets, cortes, duração do plano, ritmo musical
Veja ambas as folhas e escreva uma leitura de estilo de no máximo dez linhas: transformação contínua ou cortes, eventos por batida e quanto tempo os estados se mantêm, movimentos da câmera, easing, paleta, tipografia, som. Mostre e pergunte o que manter. Uma orientação escrita da pessoa (regras, uma lista proibida, uma estrutura) substitui a leitura. Se a pessoa forneceu música, meça agora (python3 inspect_inspiration.py track.mp3) e defina CONFIG.bpm para seu andamento antes da grade.
3. A lista de estados na grade de batidas, depois aguarde
Uma tabela com uma linha por batida: tempo, estado na tela, como se move, o que o cursor faz, câmera. references/craft.md fornece as regras. Não construa nada até que a pessoa aprove. Iterar aqui custa um minuto; após a construção custa uma hora.
4. Construção
Edite scene.html: CONFIG (andamento, compassos, loop ou cartão final, tokens, fontes), depois substitua a cena de exemplo. Leia references/craft.md primeiro: ele contém o mecanismo, as regras de movimento e as armadilhas.
- Fontes: coloque os arquivos da marca em
fonts/(baixe Google Fonts como woff2) e liste-os emfonts.json;CONFIG.fontnomeia uma dessas famílias primeiro.python3 build.pyas incorpora. - Logotipo: cole o SVG da marca literalmente. Nunca redigite uma marca nominativa em uma fonte.
- Capturas de tela são uma referência para uma recriação simplificada em HTML, nunca coladas como imagens.
- Filmagens reais:
python3 frames.py --src clip.mp4 --name <quem> --sheetpara selecionar uma janela limpa e, em seguida, extraia-a cortada para a proporção do quadro. A filmagem é reproduzida sem áudio, a menos que seu som seja misturado na etapa 5.
5. Verifique, depois o som
python3 build.py && node preview.mjs # contact sheet por formato, um quadro por batida, console e erros de fonte
node checks.mjs # cliques dentro dos botões, ponteiro nunca sobre texto lido
Ambos padrão para 1440x1440 e 1080x1920; passe outros tamanhos como 1920x1080. Leia cada folha e corrija o que estiver fora da grade, apertado, ilegível em tamanho de telefone ou no meio de uma transição quando já deveria ter pousado. checks.mjs deve passar em todos os formatos; declare cada novo clique e cada texto a ser protegido em window.CHECKS.
python3 audio.py então sintetiza uma base no andamento da cena e posiciona cada som de window.CUES pelo seu pico medido. --music track.mp3 --offset <s> usa a faixa da pessoa; --voice clip.mp4:at:start:dur mistura a voz de uma pessoa filmada e abaixa a música sob ela.
6. Renderize e entregue
node render.mjs scene.built.html 1440 1440 out/<slug>-v1-1x1.mp4 audio/bed.wav
node render.mjs scene.built.html 1080 1920 out/<slug>-v1-9x16.mp4 audio/bed.wav
Cada versão entregue recebe novos nomes de arquivo e suas fontes são copiadas para versions/v<N>/ no momento da entrega. Nunca sobrescreva um arquivo entregue até que a nova renderização tenha terminado. Copie os MP4s para onde a pessoa deseja e relate o que mudou, quais verificações passaram e qualquer decisão tomada em nome dela.
7. Itere
Siga craft.md#iterating: altere apenas o que foi nomeado, estique o tempo em vez de recoreografar, execute novamente preview.mjs e checks.mjs após cada alteração.
Requisitos
A pasta é autocontida. Os scripts precisam de node 18+, ffmpeg e python3 com numpy (a etapa 0 encontra e instala o que está faltando); setup.sh adiciona o Chromium do Playwright em cada projeto. Se o projeto estiver em um repositório com suas próprias regras, siga-as e mantenha renders, filmagens, quadros e node_modules fora do controle de versão.