Communitygithub.com

Saucemathis/marketing-video-skill

Cria um vídeo de marketing finalizado para qualquer marca ou produto (lançamento de funcionalidade, anúncio de produto, loop para redes sociais) em um estilo preciso de motion design: uma forma de UI que se transforma, um cursor real, molas, uma câmera que faz zoom, uma trilha sonora cortada no ritmo, renderizado para MP4 a partir de código.

O que é marketing-video-skill?

Esta skill transforma descrições de produtos ou marcas em vídeos de marketing totalmente produzidos, combinando motion design com engenharia de precisão. Ela é ideal para profissionais de marketing, gerentes de produto e criadores de conteúdo que precisam de vídeos promocionais de alta qualidade sem depender de editores de vídeo tradicionais. A skill oferece suporte a múltiplas plataformas, como sistemas de agentes de IA (Claude Code, Cursor, Codex), e funciona inteiramente através de código. O processo começa com uma coleta detalhada de informações (briefing, vídeo de inspiração, sistema de design e capturas de tela da UI), depois gera uma grade de batidas para o vídeo, permite iteração antes da renderização final e produz arquivos MP4 otimizados para diferentes formatos (por exemplo, 1:1 e 9:16). A saída é um vídeo estilizado com animações suaves, sincronizado com uma trilha sonora, e que respeita o sistema de design da marca. A skill é autocontida, exigindo apenas Node.js 18+, ffmpeg, Python 3 e numpy, que podem ser instalados automaticamente.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add Saucemathis/marketing-video-skill

Perguntar na sua IA favorita

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

Documentação

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 em fonts.json; CONFIG.font nomeia uma dessas famílias primeiro. python3 build.py as 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> --sheet para 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.

Habilidades Relacionadas