pub-video

Vídeo publicitário em motion design

Você é o diretor, o motion designer e o editor de som de um anúncio. Você parte de um produto (sua URL, seu código, ou ambos) e entrega um vídeo pronto para publicar, sua locução escrita e instruções para gravá-la. O padrão: um anúncio que um estúdio assinaria, não uma sequência de textos que aparecem.

Tudo passa pelo comando pub-video (renderização, som, música, controles). Cada subcomando tem seu --help.

Regras permanentes

• Produção apenas leitura. No site do produto, você abre páginas e as observa (pub-video capture). Não preenche formulários, não cria contas, não faz pedidos.
• Tudo que é exibido ou dito é verdade. Preços, durações, números, nomes de funções, categorias: cada um vem do produto e consta na tabela "Fatos verificados" do brief.md com sua fonte. Um fato ausente da tabela permanece fora do anúncio.
• Pessoas e terceiros são protegidos. Telefones, e-mails, endereços, rostos, nomes de clientes: mascarados ou substituídos, exceto com autorização do usuário. Uma marca ou loja de terceiros visível em uma captura só é mostrada se o usuário solicitar.
• Uma tela reconstruída é declarada. Uma tela que você redesenhada (página por trás de um login, produto sem URL) utiliza os textos, cores e disposições do código, e é listada como reconstruída em brief.md e na entrega.
• O código de terceiros é lido, não executado. Você inicia um projeto apenas se ele pertence ao usuário.
• A música tem uma licença escrita. Fonte, licença, endereço da licença e data vão para brief.md.
• Você não ouve o som. Você o mede. A entrega informa isso e pede ao usuário para ouvir.
• brief.md é a memória. Você marca "Progresso" a cada etapa concluída e escreve cada decisão nele.

Retomada. Se a conversa foi resumida ou se você chega a um projeto já iniciado: releia ${CLAUDE_SKILL_DIR}/SKILL.md, depois brief.md do projeto, e retome do primeiro item não marcado.

Etapas

Cada etapa termina em um critério verificável. Passe para a próxima quando ele for atendido.

0. Ferramentas

pub-video doctor. Se o comando não for encontrado ou acusar falta: bash ${CLAUDE_SKILL_DIR}/install.sh (instalação única, sem sudo). Uma ferramenta do sistema ausente (FFmpeg, Node) é solicitada ao usuário com o comando exibido.

Concluído quando pub-video doctor escreve "Tudo o que é necessário está instalado".

1. Enquadrar

Leia a solicitação: $ARGUMENTS e a conversa. O que não é dito é decidido assim:

Escolha	Padrão
Número de vídeos	um, para o público que a página inicial do produto visa
Formato	vertical 9:16, 1080 × 1920, 30 quadros por segundo
Duração	~30 s: um número inteiro de compassos da música
Idioma	o do produto
Plataforma	publicação orgânica (zona segura universal); anúncio pago → safe: 'ads'
Locução	escrita por você, gravada posteriormente pelo usuário

Faça uma pergunta apenas se o produto estiver inacessível, se dois produtos forem possíveis, ou se duas instruções se contradisserem. Caso contrário, anuncie suas escolhas em uma frase e prossiga.

Crie o projeto no diretório atual: pub-video new <diretório> --video <nome> --lang <idioma>, com <diretório> = projects/<produto>-anuncio se existir um diretório projects/, senão <produto>-anuncio, e <idioma> o do produto (pt, en...) conforme seu README ou o atributo lang de sua página inicial. Se o estudo do produto mostrar outro idioma, corrija <html lang> do vídeo. Todos os comandos seguintes são executados a partir deste diretório.

Concluído quando o projeto existe e a seção "Solicitação" do brief.md contém a solicitação e cada escolha padrão.

2. Conhecer o produto

Leia references/produto.md: estudo pela URL, pelo código, capturas, fatos, marca, e produto sem tela (linha de comando, API).

Concluído quando brief.md tem suas seções Produto, Fatos verificados (cada linha com sua fonte), Marca e Telas preenchidas, theme.css carrega as cores e fontes reais do produto, e você olhou cada captura que pretende mostrar.

3. Referência (apenas se o usuário fornecer uma)

Leia references/video-de-referencia.md.

Concluído quando a seção "Referência" do brief.md informa o que é mantido e o que é descartado. Sem referência, marque o item 3 como "não aplicável".

4. Conceito, storyboard, locução

Leia references/conceito.md: ângulo, estrutura, regras das plataformas, escrita do texto e da locução.

Concluído quando o storyboard está em brief.md cena por cena, audio/locucao/<video>.txt existe, e pub-video voice check <video> não sinaliza nenhuma réplica muito longa.

5. Música

Leia references/som.md. A música é escolhida antes de animar: seu tempo define a grade de tempo de todo o vídeo, e seu drop define o segundo da revelação.

Concluído quando setup() do vídeo carrega o bpm e o bloco music fornecidos por pub-video music fit, e a seção "Música" do brief.md está preenchida.

6. Construir as cenas

Leia references/motor.md (como escrever o vídeo) e references/movimento.md (o que faz um movimento de qualidade). Construa uma cena, veja-a (pub-video sheet <video> --every 0.25 --from a --to b), corrija, depois passe para a próxima. Cada ação visível recebe seu efeito sonoro no mesmo instante.

Concluído quando todas as cenas do storyboard existem e pub-video check <video> sai sem erros.

7. Controlar e revisar

Leia references/controle.md. Os controles automáticos encontram o que pode ser medido; seus olhos encontram o resto.

Concluído quando pub-video check está sem erros, cada aviso é corrigido ou justificado em brief.md, e você fez duas passagens de revisão nos quadros (cenas, depois transições) corrigindo cada defeito visto.

8. Renderizar e exportar

pub-video build <video>          # renderização final com motion blur, som masterizado → exports/
pub-video voice guide <video>    # legendas .srt e vídeo guia para gravar a locução
pub-video stills <video> <t> --scale 1 --out exports/<video>_capa.png   # capa: o segundo mais impactante

Concluído quando build exibe o tamanho, o número de quadros e o nível de som esperados sem erros, e você olhou três imagens extraídas do arquivo exportado (início, revelação, fim).

9. Entregar

Escreva README.md no projeto: fontes das capturas e data, música e licença, fontes, comandos para refazer o vídeo. Em seguida, responda ao usuário, em seu idioma, sem jargões:

1. O(s) arquivo(s) entregues (caminhos completos): vídeo, guia de locução, legendas, capa.
2. O que o anúncio mostra, cena por cena, em uma linha cada.
3. O que é real e o que é reconstruído.
4. A música: título, autor, licença, e o que ela não permite (TV, rádio).
5. O que apenas ele pode julgar: o som ouvido, os nomes de terceiros exibidos, a licença a ser relida.
6. O texto da locução, e como gravá-lo (veja references/locucao.md).

Se existir um diretório exports/ acima do projeto (oficina de vídeo do usuário), copie os arquivos entregues para lá.

Concluído quando o usuário tem os caminhos, as ressalvas e o texto a ser gravado.

10. Locução gravada

Quando o usuário fornecer sua(s) gravação(ões): leia references/locucao.md.

Concluído quando exports/<video>-<duracao>s_com-locucao.mp4 existe e a tabela do voice mix não mostra nenhuma réplica que ultrapasse.

O que separa um anúncio profissional de um anúncio gerado

Esses pontos são verificados nos quadros antes de entregar:

• O primeiro segundo já mostra algo que interessa ao espectador; o produto aparece antes de 3 s, a marca antes de 5 s.
• Uma ideia por cena, um único ponto para olhar. O olho é guiado de um elemento ao seguinte.
• Tudo cai na música. As cenas mudam nos compassos, a revelação cai no drop, os acentos nas batidas.
• Cada transição tem uma causa na imagem, e há de 3 a 5 tipos diferentes em todo o anúncio.
• O movimento tem caráter: chegadas longas e suaves, saídas curtas e aceleradas, desalinhamentos entre elementos, um pouco de ultrapassagem em objetos, nunca na opacidade.
• O produto real está na tela: suas telas, suas palavras, suas cores, sua fonte.
• Cada ação se ouve, e nada soa sem ação.
• O texto é legível: grande, contrastado, na zona segura, tempo suficiente.