Vídeo institucional e propaganda
Esta skill produz o vídeo inteiro com um pipeline pronto. Não reescreva os scripts: preencha a pasta do vídeo e rode os comandos.
<SKILL> é a pasta desta skill (onde está este arquivo). Rode os scripts com python "<SKILL>/scripts/<script>.py".
Regras que não mudam
- Só dados fictícios. Nada de dados reais, nomes de clientes ou de outras empresas, totais reais ou pessoas reais. Identificadores como
PED-0137e nomes com "(fictício)". A única marca é a da empresa dona do produto. - Nada é gravado em banco real. A demo responde a API com
mock_api.py(dados fictícios) ou roda contra um ambiente local com dados fictícios. - Entrega em arquivos locais: o
.mp4, a capa.jpge a pasta do vídeo, que permite regerar tudo. Não publique online. - Chaves só por variável de ambiente (
OPENROUTER_API_KEY,ELEVENLABS_API_KEY,ELEVEN_VOICE_ID). Nunca em arquivo. - Narração em linguagem de negócio: o que a tela faz e o ganho. Sem "endpoint", "SQL" ou "hash", a menos que o público seja técnico.
- Aprovação antes de gravar: mostre ao usuário o roteiro e a prévia (
--previa) e só grave e monte depois do ok.
Passo a passo
-
Ambiente:
python "<SKILL>/scripts/verificar_ambiente.py". Instale o que faltar, seguindo os comandos que ele mostra. -
Entenda o produto. Leia o README e as telas e rotas do front do projeto. Pergunte ao usuário, numa única mensagem, só o que não der para descobrir:
- formato: institucional ou propaganda;
- público;
- estudo de caso fictício;
- telas que entram;
- como subir a aplicação localmente.
-
Crie a pasta do vídeo dentro do projeto, por exemplo
docs/video-institucional/:- institucional:
python "<SKILL>/scripts/novo_video.py" <pasta>; - propaganda: copie
<SKILL>/modelo-propaganda/*e<SKILL>/modelo/marca/para a pasta.
- institucional:
-
Escreva o roteiro (
roteiro.json) e adapte os slides (cenas.html). A estrutura dos blocos está emreferences/formato.md. O esquema do roteiro e as ações da demo estão emreferences/roteiro.md. -
Demo na ferramenta (só no institucional):
- Suba o front do projeto e descubra as chamadas que ele faz à API, pela aba Network ou pelo código.
- Escreva em
mock_api.pyrespostas fictícias para essas chamadas. - Aponte
demo.url_basepara o dev server edemo.interceptarpara o padrão da API, por exemplo**/api/**. - Prefira alvos estáveis (
css=[data-testid=...],texto=...). - Ensaie o fluxo com o app de exemplo (
app-exemplo/), que já vem funcionando.
-
Prévia:
python "<SKILL>/scripts/gravar.py" <pasta> --previa. Abraprevia/index.html, confira cada print (alvos certos, nada cortado ou sobreposto à legenda) e mostre ao usuário junto com o roteiro. -
Narração:
python "<SKILL>/scripts/narrar.py" <pasta>. O padrão é a voz Francisca (edge-tts), grátis, a mesma dos vídeos didáticos já feitos. Para uma voz paga, há duas opções:... openrouter, comOPENROUTER_API_KEYe"openrouter": {"modelo", "voz", "instrucoes", "velocidade"}no roteiro. Vozes em pt-BR testadas:microsoft/mai-voice-2.1(Rafael, Caio, Pedro, Luana),elevenlabs/eleven-multilingual-v2egoogle/gemini-3.8-flash-tts.... eleven, para a ElevenLabs direta.
Use a mesma voz no vídeo inteiro. Só as frases alteradas são geradas de novo.
-
Gravação:
python "<SKILL>/scripts/gravar.py" <pasta>. Para regravar só um bloco, use--blocos id1,id2. -
Montagem:
python "<SKILL>/scripts/montar.py" <pasta> "<pasta>/saida/<Nome do vídeo>.mp4". Gera também<Nome> - capa.jpg. -
Confira o resultado de verdade. Extraia uns 6 quadros (
ffmpeg -ss <t> -i video.mp4 -frames:v 1 q.jpg), olhe cada um e confira a duração. Ajuste o que estiver estranho e remonte. -
Deixe na pasta um
LEIA-ME.mdcurto, com os comandos para regerar o vídeo.
Formatos
- Institucional (
"formato": "institucional"): de 4 a 6 min, com cenas e demo intercaladas, legenda em toda frase e painel lateral na demo. Os blocos estão emreferences/formato.md. - Propaganda (
"formato": "propaganda"): de 15 a 60 s, só cenas. Tem gancho nos primeiros 2 s, tipografia grande e animada, mockups estilizados da interface em HTML, CTA final com a logo e trilha ("trilha": {"arquivo": "trilha.mp3", "volume": 0.22}). A trilha provisória sai depython "<SKILL>/scripts/trilha_provisoria.py" trilha.mp3 <segundos>; para publicar, troque por uma trilha licenciada. As transições são mais curtas, e as pausas entre frases também.
Problemas comuns
- "alvo sem posição" ou timeout na demo: o texto ou o seletor não existe naquela tela. Rode
--previae ajuste o alvo. - "sem resposta fictícia para GET /api/...": falta essa rota em
mock_api.py. Outra opção é usar"deixar_passar": truepara ir ao back-end local. - "narração desatualizada": o texto mudou. Rode
narrar.pyde novo. - "gravação de outra versão do roteiro": o número de frases do bloco mudou. Regrave o bloco com
--blocos.