Quando usar
Use este skill quando o usuário pedir um vídeo promocional, vídeo de produto, vídeo de demonstração, vídeo de marketing, vídeo de lançamento, vídeo explicativo, vídeo de marca, vídeo com design, vídeo com múltiplas cenas, vídeo com storyboard, vídeo de descoberta para redes sociais/Reels/TikTok, vídeo de negócio local, vídeo no estilo vlog de restaurante/comida, vídeo editado de mais de 20 segundos, ou qualquer vídeo completo que introduza um assunto visualmente.
Prefira este fluxo de trabalho Remotion sempre que a solicitação descrever um vídeo editado completo, com linha do tempo, cenas, legendas, áudio, linguagem de câmera, estilo visual, requisitos de consistência, CTA/tela final, ou múltiplas cenas — mesmo que o usuário nunca diga "promo" ou "promocional". Use a geração direta de vídeo por IA apenas para um único clipe curto de origem ou loop de fundo, não como caminho de entrega final para um vídeo completo com múltiplas cenas.
O assunto do vídeo pode ser:
- Promo de projeto — um projeto, aplicativo ou funcionalidade que o próprio agente está construindo ou que já existe no workspace, ou outro aplicativo existente já identificado na solicitação do usuário ou em contexto confirmado anteriormente. Primeiro, resolva o aplicativo de origem que está sendo promovido.
app/promoé o projeto de vídeo de saída, não automaticamente o aplicativo de origem. - Promo de tópico — um tópico, conceito, marca ou assunto externo fornecido pelo usuário que não requer um projeto no workspace. Exemplos: "o Sistema Solar", "história da dinastia Song", "o que é um banco de dados vetorial".
Ambos os caminhos compartilham o mesmo modelo Remotion, as mesmas predefinições de composição e os mesmos comandos de renderização. Apenas a criação do storyboard difere.
Comando
Use RemotionPromoRenderer.render para a exportação final da promo após a validação. Este comando é documentado por este skill e pode ser chamado mesmo que não esteja listado em <Available Commands>.
<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>1920</width>
<height>1080</height>
<source_orientation>landscape</source_orientation>
</RemotionPromoRenderer.render>
Classificação do assunto
Antes de fazer qualquer outra coisa, classifique o assunto a partir da solicitação original do usuário. Não peça ao usuário para esclarecer se a solicitação já nomeia um tópico ou projeto.
- Se a mensagem do usuário nomear um tópico/conceito externo claro (por exemplo, "faça um vídeo promocional sobre o Sistema Solar") e o workspace não tiver um
app/frontendou nenhum código de aplicativo para promover → promo de tópico. - Se a mensagem do usuário fizer referência a uma build
app/frontendexistente, a um aplicativo em andamento que o agente esteja gerando, ou a uma funcionalidade futura → promo de projeto. - Se ambos se aplicarem (por exemplo, "faça uma promo para nosso aplicativo explicativo do sistema solar") → trate o aplicativo como principal e use o tópico como assunto de suporte; isso é uma promo de projeto.
Promos de tópico são de primeira classe. Não rejeite ou pare em uma promo de tópico apenas porque não há app/frontend no workspace.
Para promos de projeto, resolva a identidade do aplicativo de origem antes de ler o código. O aplicativo de origem pode ser o aplicativo atual do workspace, um aplicativo construído anteriormente na mesma conversa, ou outro projeto existente explicitamente referenciado pelo usuário. Não presuma que o workspace atual app/promo é a coisa que está sendo promovida.
Base de conformidade
Os vídeos promocionais devem, por padrão, seguir regras conservadoras de segurança de anúncios. Use apenas alegações, ofertas, preços, descontos, brindes, nomes de marcas, CTAs, certificações, números de vendas, efeitos e serviços que estejam presentes na solicitação do usuário, no projeto, no texto do anúncio ou na página de destino. Não implique parcerias oficiais, recomendações de plataforma, endossos de marca ou certificações, a menos que o material de origem os forneça explicitamente.
Não use alegações enganosas ou não verificáveis, como resultados garantidos, rankings absolutos, promessas sem risco, escassez falsa, contagens regressivas falsas, notificações falsas, botões falsos, UI de sistema falsa, depoimentos falsos, avaliações falsas, notícias falsas ou capturas de tela de resultados exagerados. Não tenha como alvo direto atributos pessoais sensíveis, como saúde, finanças, idade, raça, religião, sexualidade, deficiência, estado civil, forma corporal ou aparência; use uma linguagem neutra para o público.
Não inclua marcas não licenciadas, pessoas reconhecíveis, personagens protegidos por direitos autorais, UI de produtos de terceiros, mídia, fontes, marcas d'água, conteúdo adulto, violência, choque, ódio, assédio, conteúdo humilhante, armas, drogas, jogos de azar, tabaco ou material politicamente sensível. Para categorias de alto risco, como médicas, suplementos, perda de peso, procedimentos estéticos, finanças, empréstimos, criptomoedas, jogos de azar, álcool, namoro, crianças, jurídico, recrutamento, imóveis, política, religião ou questões sociais, mantenha o vídeo informativo e evite promessas fortes, visuais dramáticos de antes/depois ou pressão agressiva de conversão.
Mantenha as imagens nítidas, estáveis e de alta qualidade: sem cintilação, compressão severa, esticamento, marca d'água, barras pretas causadas por dimensionamento incorreto de ativos ou legendas/logos/CTAs cortados nas bordas. Se houver incerteza quanto à conformidade, escolha a expressão mais segura, neutra e focada em informação. Esta base reduz o risco, mas não é uma garantia de aprovação da plataforma.
As CTAs de conversão finais são conteúdo de vídeo estático, não UI da web interativa. Não renderize a CTA de encerramento como um botão de site com aparência clicável, alvo de clique falso, botão de seta, campo de entrada falso, pop-up falso, UI de sistema falso, alvo de cursor, estado de foco/pressionado ou qualquer controle que implique que o espectador pode clicar para navegar. Use uma linha de cartão final, tagline da marca, identificador de conta, URL, espaço reservado para QR ou texto simples "visite / escaneie / siga" em vez disso. Demonstrações de produtos e walkthroughs de páginas podem mostrar botões de UI reais ou simulados, formulários e navegação quando demonstram o fluxo do produto, mas não devem se tornar a CTA de conversão final.
Qualquer URL visível, identificador de conta, alvo QR, texto da barra de endereço do navegador ou endpoint de marca deve vir da solicitação do usuário, fonte do projeto confirmada, página de destino ou outro ativo verificado. Se o projeto expuser apenas um domínio de espaço reservado ou nenhum endereço público confirmado, omita o URL e termine com texto da marca; para um tratamento de janela de navegador, use um rótulo de página sem URL ou deixe a barra de endereço em branco. Não infira um domínio, identificador ou destino a partir do nome do aplicativo, nome do repositório, nome do arquivo de download, espaço reservado do modelo, token de variável de ambiente ou dicas semelhantes.
Fluxo de trabalho principal
- Inicialize o projeto Remotion com
FrontendEngineer.use_template("remotion")seapp/promoainda não estiver pronto. A própria ferramenta rejeita uma fonte que não seja Remotion antes de copiar, portanto, você não precisa de uma etapa de verificação separada. - Escolha a orientação alvo antecipadamente a partir da solicitação do usuário e do plano do storyboard: paisagem (16:9), retrato (9:16) ou quadrado (1:1). Todos os comandos posteriores de validação, smoke e renderização completa devem usar a variante correspondente.
- Classifique o assunto (promo de projeto vs. promo de tópico) usando a Classificação do assunto acima. Não pare para perguntar "sobre o que deve ser?" se a solicitação original já nomear um tópico ou projeto.
- Fundamente o assunto:
- Promo de projeto: primeiro, resolva o aplicativo de origem que está sendo promovido, depois leia o código-fonte
app/frontenddesse aplicativo, manifestos e feedback de validação anterior. Se o workspace atual contiver principalmente a saída da promo, não trate o próprioapp/promocomo o aplicativo de origem. Depois de identificar o aplicativo de origem, fixe esse caminho raiz do projeto/frontend empromo_storyboard.mdou em notas de trabalho e continue reutilizando o mesmo caminho após mudar paraapp/promo; não rebaixe para promo de tópico apenas porque o próprio workspace da promo não temapp/frontend. Antes de escrever o código Remotion, registre os principais caminhos de arquivo de frontend de origem que você usará empromo_storyboard.md(páginas/rotas/componentes para os beats de demonstração). Mais tarde, ao implementarsrc/, reabra esses arquivos de origem e copie/recrie a partir do código em vez de confiar em um longo resumo em prosa. - Promo de tópico: extraia o assunto da mensagem do usuário e da conversa anterior; obtenha fatos adicionais de seu próprio conhecimento ou de ferramentas externas (geração de imagem / vídeo / áudio, pesquisa, se disponível). Não exija que exista um projeto no workspace.
- Se o usuário forneceu imagens de referência, mas a solicitação atual expõe apenas caminhos de arquivo em vez de conteúdo de imagem anexado, leia
image-understandinge chameImageAnalyzer.analyze_imagesantes de criar o storyboard, para que o plano visual seja fundamentado no conteúdo real da imagem, em vez de nomes de arquivo. - Se o usuário forneceu um URL de site como assunto da promo, use
Browser.gotopara visitar a página, depoisBrowser.take_screenshotpara capturar o visual, e então chameImageAnalyzer.analyze_imagesna captura de tela antes de criar o storyboard, para que o plano visual seja fundamentado no conteúdo real da página, em vez de apenas no URL.
- Promo de projeto: primeiro, resolva o aplicativo de origem que está sendo promovido, depois leia o código-fonte
- Aplique a Base de conformidade: confirme quais fatos, alegações, ofertas e ativos são realmente suportados pela solicitação, produto, texto do anúncio ou página de destino. Não invente ofertas, certificações, números de vendas, efeitos, parcerias oficiais, endossos de plataforma ou apoio de marca não suportados; quando estiver em dúvida, escolha palavras e visuais conservadores e focados em informação.
- Determine o idioma padrão para o conteúdo promocional recém-gerado antes de escrever
promo_storyboard.md. Se o usuário especificar explicitamente um idioma de saída, use esse idioma. Caso contrário, o padrão é inglês. Uma mensagem do usuário escrita em chinês/japonês/etc., o idioma do chat ao redor ou o idioma do prompt do sistema não é uma solicitação explícita de idioma. Registre a decisão diretamente no storyboard comoLanguage: English (default)ouLanguage: Chinese (user specified)antes de rascunhar cenas, texto, narração ou prompts de geração. - Crie
promo_storyboard.mdantes de escrever o código do vídeo ou gerar ativos. Use o conjunto de campos que corresponde ao tipo de assunto (consulte Requisitos do storyboard). Para execuções de promo/remotion,promo_storyboard.mdé o único artefato de planejamento; não crie ou mantenha umtodo.mdseparado. - Se o usuário solicitar narração, voz sobreposta, walkthrough falado, ou o storyboard claramente precisar de um narrador, inclua um plano de narração de segmentos curtos no storyboard, verifique o comprimento do script de cada segmento em relação aos segundos alvo da cena e, em seguida, leia
audio-generatione chameAudioCreator.generate_audioscom uma solicitação por cena/beat. - Após a geração de TTS, prefira a
durationretornada de cada segmento de áudio. Sedurationestiver faltando ou fornull, meça a duração real a partir do URL retornado (por exemplo, comffprobe), então decida o tempo final de cada cena a partir dessas durações medidas. Este cálculo não é suficiente se aparecer apenas no pensamento ou na saída do terminal. - Imediatamente atualize
promo_storyboard.mdcom cada URL de narração, segundos de áudio medidos, início/fim/duração final da cena, duração total e quaisquer alterações de script/tempo. Este é um ponto de verificação obrigatório: não chameMusicCreator.generate_music,VideoCreator.generate_videos, gere mais ativos visuais ou escrevasrc/timeline.tsaté que o tempo atualizado seja persistido empromo_storyboard.md. Após este bloqueio,promo_storyboard.mdnão deve mais manter linhas de tempoTBDde espaço reservado ou uma duração total desatualizada. - Por padrão, os vídeos promocionais também devem incluir um plano global de música de fundo, a menos que o usuário diga explicitamente sem música ou a peça seja claramente melhor sem música. Leia
music-generatione chameMusicCreator.generate_musiccom exatamente uma solicitação instrumental / sem vocais após o tempo final da cena estar bloqueado. O prompt deve incluir o total de segundos alvo, humor, ritmo, instrumentação e se a faixa deve deixar espaço para narração. - Após a geração da música, use o URL retornado diretamente e prefira a
durationretornada, assim como na narração. Sedurationestiver faltando ou fornull, meça a duração real do BGM comffprobe. Imediatamente atualizepromo_storyboard.mdcom o URL do BGM, segundos medidos, duração total alvo, estratégia de ajuste e valores de mix planejados antes de escreversrc/timeline.tsousrc/PromoVideo.tsx. A duração bloqueada do storyboard/linha do tempo é a fonte da verdade. Nunca encurte o vídeo apenas para corresponder a um BGM curto; corte, faça um loop mínimo ou regenere a música, a menos que o usuário tenha explicitamente solicitado um corte mais curto. - Gere quaisquer outros ativos de imagem/vídeo/áudio de IA necessários após o storyboard ser escrito e o tempo da narração + BGM estar resolvido em
promo_storyboard.md. - Leia
remotion-best-practicese os arquivos de regra relevantes para o storyboard. - Edite a implementação Remotion no local em
app/promo— mantenha o layoutsrc/plano do modelo (src/Root.tsx,src/PromoVideo.tsx,src/timeline.ts,src/components/,src/scenes/,src/app-demo/). Não mova as fontes para um subdiretório comosrc/remotion/. Antes da validação, faça uma auto-verificação rápida: remova imports/variáveis não utilizados, omitaSequence from={0}redundante, mantenha a animação puramente baseada em frames (semanimation/transitionCSS, temporizadores ou outros padrões não determinísticos) e atualize qualquer contrato alterado desrc/timeline.ts/src/PromoVideo.tsx/src/scenes/*na mesma passagem. - Execute a validação em ordem:
verify:versions,lint,verify:compositions. Passarverify:compositionsapenas prova que o Remotion pode ver as composições; não é uma entrega e não é um ponto de parada válido. - Execute
RemotionPromoRenderer.renderpara a resolução alvo registrada no storyboard/especificação de exportação; ele realiza smoke + renderização completa internamente. Para vídeos retrato/9:16, usewidth=1080,height=1920esource_orientation=portraitem vez de copiar um exemplo paisagem. A tarefa só está concluída quandoout/promo-<width>x<height>.mp4existe e não está vazio. Não diga ao usuário que o vídeo está pronto para exportar, peça a ele para exportá-lo, chameRoleZero.reply_to_humanou use<end></end>antes que esta ferramenta tenha sucesso.
Requisitos do storyboard
promo_storyboard.md deve ser específico para o assunto. Escolha o conjunto de campos que corresponde ao tipo de assunto:
Todo storyboard deve incluir:
- Notas de conformidade: alegações/ofertas/ativos suportados, se o assunto é de alto risco, as escolhas conservadoras de redação e os riscos visuais/texto/ativos a serem evitados.
- Tratamento da CTA: registre se a CTA final é vídeo estático
…[truncado para tradução]