harish-anumula/launch-video-skill

Vídeo de lançamento

Você dirige e constrói um vídeo de lançamento curto do início ao fim: perguntas de descoberta → storyboard → capturas do produto → roteiro e narração → música → cenas Remotion → revisão → renderização → miniatura e cortes. A pessoa traz o bom gosto e o conhecimento do produto; você traz o pipeline e o ofício. Faça as perguntas abaixo, tome todas as outras decisões você mesmo e informe o que escolheu.

Tudo aqui é genérico. Traga a própria marca do produto, telas, chaves de API e licença de música.

Instalação (qualquer agente)

• Claude Code: copie esta pasta para ~/.claude/skills/launch-video/ (pessoal) ou <repo>/.claude/skills/launch-video/ (projeto).
• Codex: copie para ~/.codex/skills/launch-video/, ou referencie SKILL.md a partir do seu AGENTS.md.
• Outros agentes: coloque em qualquer lugar e diga ao agente para ler SKILL.md primeiro. Caminhos, versões e APIs mudam com o tempo; se um comando ou formato de API tiver evoluído, verifique a documentação atual e adapte-se em vez de parar.

O que está neste skill

Caminho	O que é
references/storyboard-template.md	Formatos de história, tipos de gancho, como usar vídeos de referência, um roteiro de cenas e uma receita de cena-funcionalidade
references/visual-catalog.md	Os blocos de construção visuais, o que cada um mostra e para quais produtos/funcionalidades cada um é adequado
references/motion-cheatsheet.md	Suavização (easing), molas (springs), ritmo, famílias de estilo e tipos, transições, câmera sobre UI, textura, cursor
references/audio.md	Narração vs música, formatos de API de TTS e música, mixagem, volume (loudness)
references/review-checklist.md	O que verificar por cena, no corte completo e antes de compartilhar
references/gotchas.md	Modos de falha e suas correções
scripts/	Análise de referência, classificação de vozes, VO por linha com timings de palavras, seleção de takes, geração/QA/opções/ajuste de música, temporização ajustada à batida, folhas de contato, finalização
template/	Inicializador Remotion: tokens de marca, helpers de temporização, manchete cinética, cursor, grão, HUD, montagem de logotipo, cenas genéricas de Gancho/Revelação/Funcionalidade/Desfecho/Fim/Miniatura, uma biblioteca de visuais, uma prévia do Catálogo e video.config.tsx (o storyboard em código)

Ferramentas

• Node 20+, ffmpeg, Python 3.11 via uv/uvx (os scripts declaram suas próprias dependências).
• Remotion: npx create-video@latest --yes --blank --no-tailwind video. Instale os skills oficiais do agente (npx skills add remotion-dev/skills) e leia remotion-best-practices antes de escrever cenas.
• Opcional: rubberband (alongamento limpo de tempo), demucs e Whisper via uvx (análise e QA), uma conta ElevenLabs (ou outro TTS/música).
• Licenças: Remotion é gratuito para indivíduos e empresas de até 3 pessoas; empresas maiores precisam de uma licença corporativa Remotion. Verifique os termos comerciais do seu provedor de TTS/música. Logotipos de terceiros são marcas registradas; mostre-os apenas para integrações reais.

1. Perguntas de descoberta (pergunte antes de planejar)

Faça estas perguntas em lote (use a ferramenta de pergunta/múltipla escolha se seu cliente tiver uma; caso contrário, uma lista numerada curta). Ofereça um padrão recomendado para cada uma para que a pessoa possa apenas confirmar.

1. Produto: nome exato como deve aparecer e uma frase sobre o que faz e para quem.
2. Público e objetivo: quem assiste (clientes, prospects, investidores, equipe interna) e o que devem fazer depois (inscrever-se, agendar uma demonstração, testar uma funcionalidade).
3. O que mostrar, em ordem de prioridade: as 3 a 6 funcionalidades ou momentos que mais importam. O tempo de tela segue esta ordem.
4. Duração e formato: ex., corte principal de 45 a 75s em 16:9; quais cortes (15–20s, 1:1, 9:16) e onde serão postados.
5. Som: narração + música (recomendado quando o produto precisa de explicação) ou apenas música. Preferência de voz (gênero, sotaque, energia) ou "combine com este exemplo".
6. História e aparência: o formato da história e o tipo de gancho (consulte references/storyboard-template.md; recomende um com justificativa), claro ou escuro, a família de estilo (nativa do produto, editorial, showreel, lúdica, cinematográfica; references/motion-cheatsheet.md) e quaisquer vídeos que eles gostem. Ativos da marca: logotipo (SVG), cores, fontes ou onde lê-los (o CSS do produto).
7. Telas: você pode executar o produto com uma conta demo e dados fictícios, ou eles fornecerão capturas de tela? Qualquer coisa que não deva aparecer.
8. Cartão final: texto do CTA e URL; data de lançamento/texto "agora em beta".
9. Chaves: onde a chave de API de TTS/música está armazenada (variável de ambiente ou um .env ignorado pelo git). Nunca peça para colarem chaves no chat.

Se já responderam algumas destas, não pergunte novamente.

2. Planeje o storyboard

• Escolha um formato de história e tipo de gancho de references/storyboard-template.md (problema → produto → prova é apenas um entre vários). As cenas de funcionalidades seguem a ordem de prioridade.
• Se a pessoa compartilhar vídeos de referência, pegue emprestado o ofício deles (ritmo, cortes, câmera, tipo), nunca as falas, aberturas ou sequências; verifique o roteiro com as transcrições de referência antes de gravar.
• Escreva a VO como uma linha curta por cena (≈2,5 palavras/s; 60s ≈ 140 palavras). Cada linha deve cair no momento visual de sua cena.
• Para cada cena de funcionalidade, escolha um visual de references/visual-catalog.md que se encaixe neste produto (um app mobile pode ser Telefone → Passos → Notificações; uma ferramenta dev RespostaCompositor → AntesDepois → Dispositivo). Varie os movimentos entre cenas consecutivas.
• Compartilhe o storyboard como uma tabela curta e confirme antes de construir.

3. Capture o produto

• Execute o produto com uma conta demo e dados fictícios. Nunca mostre clientes reais, colegas, e-mails ou dados de produção.
• Capture capturas de tela de referência (Playwright, 2x DPR) de cada tela que o storyboard usa e anote o texto visível exato. Reconstrua essas telas como componentes React simplificados dentro de Device/Phone/cartões para que fiquem nítidos e animem. Capturas de tela reais podem ir diretamente em Device/Phone quando uma reconstrução não valer a pena.
• Se um estado não puder ser alcançado honestamente, estilize-o e diga.

4. Narração (se escolhida)

• Coloque as falas em config/script.json. scripts/vo_lines.py faz 3 takes por linha com timings de palavras; scripts/vo_pick.py escolhe o melhor por correspondência de transcrição (e similaridade com uma voz de referência, se fornecida).
• Gere por linha, nunca o roteiro inteiro de uma vez: leituras de uma passada juntam as linhas e você não pode começar cada linha em seu corte.
• Use vozes padrão/pré-fabricadas. Para se assemelhar a uma voz de um exemplo, classifique as vozes padrão com scripts/voice_match.py; nunca clone uma pessoa real sem consentimento.

5. Música

• Gere 3 a 4 opções instrumentais (scripts/music.py) ou licencie faixas. Crie um arquivo de trecho A/B/C/D (scripts/music_options.sh) e deixe a pessoa escolher ouvindo.
• Meça a faixa escolhida (scripts/music_qa.py); faixas geradas raramente seguem o tempo ou seções solicitadas, então ajuste os cortes às batidas detectadas (scripts/build_timing.py). Se o final natural cair no lugar errado, alongue o tempo em alguns por cento (scripts/stretch_music.sh).

6. Construa

• Configure o template (template/README.md), defina tokens de marca, logotipo e CTA, e escreva o storyboard em video.config.tsx.
• Antes da VO existir, scripts/draft_timing.py fornece temporização de animatic para que as cenas possam ser construídas; depois, build_timing.py substitui pelos tempos reais das palavras.
• Construa uma cena de cada vez. Após cada uma, renderize 6 a 10 stills ao longo dela pela metade da escala e veja-os como uma folha de contato (scripts/sheet.py).
• Renderize e envie a composição StyleTest (gancho, revelação, primeira funcionalidade) para aprovação antes de construir o restante.

7. Revise e itere

• Renderize o corte completo, execute scripts/finalize.sh (−14 LUFS, arte de capa, folha de contato a 1 fps, transcrição da mixagem final) e passe por references/review-checklist.md.
• Para cada rodada de notas, mude apenas o que foi solicitado, renderize novamente e diga exatamente o que mudou em relação à versão anterior. Faça commit de cada versão.
• Você não pode assistir em tempo real: diga quais verificações fez (stills, transcrição, volume) e peça para a pessoa assistir uma vez antes de compartilhar.

8. Entregue

• Master 1920×1080, 30 fps (60 para motion UI denso), H.264 CRF 16–18, AAC 256k, −14 LUFS, −1 dBTP.
• Miniatura: a composição Thumbnail, legível a ~360px de largura; também é o quadro 0 do vídeo (muitos apps pré-visualizam o primeiro quadro) e a arte de capa do MP4. Exporte um PNG e um JPG 1280×720 para plataformas com miniaturas personalizadas.
• Cortes quando solicitados: um corte de gancho de 15 a 20s, 1:1 e 9:16 (tipo empilhado acima da UI), um loop silencioso para site, legendas SRT a partir dos timings das palavras da VO.

Vídeos explicativos e para redes sociais

O mesmo pipeline faz curtas explicativos (um post de blog, artigo, funcionalidade ou ideia) para LinkedIn e X. O que muda:

• Fatos vêm da fonte, lidos por completo. Resumos de ferramentas de busca web podem inventar ou mesclar números. Crie uma lista de verificação de fatos a partir do texto original antes de roteirizar.
• Roteiro para qualquer pessoa, não especialistas. Uma ideia por tela, no máximo ~10 palavras difíceis, uma analogia cotidiana para o conceito central (por exemplo, um eval se torna "um teste prático vs o teste real"), sem jargão ou nomes de modelos, no máximo dois números arredondados e termine com algo que o espectador possa fazer. "Preciso, mas técnico demais" é a nota mais provável inicial.
• Ritmo: o conteúdo de cada tela aparece dentro de cerca de um segundo (entradas rápidas, cortes rápidos de ~0,12s na batida), depois mantém-se por 4–5s para leitura. No template, envolva uma cena em SpeedCtx.Provider value={1.6} para reproduzir uma entrada criada mais rápido sem reajustar o tempo.
• Formato: 4:5 (1080×1350) para o feed do LinkedIn/X, 30–50s, apenas música. O texto na tela é a legenda (a maioria dos vídeos no feed é assistida sem som). O quadro 0 é uma capa finalizada.
• Aparência: combine com a identidade visual existente da pessoa (seus carrosséis, site), não com o template do produto.
• Música: para redes sociais, faixas de anúncio de produto com batida forte (bumbo claro, caixa, palmas, baixo profundo, começando na batida um) geralmente vencem faixas ambientes suaves. Gere 3 opções e deixe a pessoa escolher ouvindo; faixas com o mesmo andamento podem compartilhar uma grade de batidas.
• Entregue com o post: texto do post, colocação de links, tags, texto alternativo, capa e um horário de postagem baseado na própria análise de audiência da pessoa (onde os seguidores estão, quando sua rede está acordada).

Regras

• Apenas dados fictícios na tela; nenhuma pessoa real a menos que tenham concordado.
• Não afirme números ou capacidades que o produto não possui. Confirme se qualquer "centenas de…" ou estatística é verdadeira e aprovada.
• Escreva texto original. Não reutilize o gancho, slogan ou bordão de outro vídeo, e não adote uma fórmula padrão entre vídeos.
• Permaneça na paleta da marca; cenas fora da paleta repentinas são lidas como falhas.
• Mantenha a música abaixo da linha de desfecho (queda suave, nunca quase silêncio).
• Use marcas oficiais para logotipos de terceiros, nunca aproximações.