Communitygithub.com

nntenzo/msl

Use quando você precisa criar um vídeo promocional, de produto, demo, explicativo, de tópico, com múltiplas cenas, storyboard, para redes sociais/Reels/TikTok, de negócio local, vlog de restaurante/comida ou vídeo editado de mais de 20 segundos — seja para o projeto atual ou para um assunto fornecido pelo usuário.

O que é msl?

Este skill permite a criação de vídeos promocionais completos e editados usando o framework Remotion, abrangendo desde vídeos de produto e demos até conteúdo para redes sociais e vlogs. Ele é ideal para desenvolvedores que desejam gerar vídeos de alta qualidade, com múltiplas cenas, storyboard, narração, música de fundo e elementos visuais consistentes. O skill suporta tanto a promoção de projetos existentes no workspace (como um aplicativo ou funcionalidade em desenvolvimento) quanto a criação de vídeos sobre tópicos externos fornecidos pelo usuário. O fluxo de trabalho é altamente estruturado, começando com a classificação do assunto, seguido pela criação de um storyboard detalhado, geração de ativos (imagens, áudio, vídeo), e renderização final com validações de conformidade e segurança para evitar alegações enganosas ou conteúdo sensível. A saída final é um arquivo de vídeo MP4 completo, pronto para uso.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/nntenzo/msl/tree/HEAD/.atoms/skills/promo-video-production

Perguntar na sua IA favorita

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

Documentação

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:

  1. 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.
  2. 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/frontend ou nenhum código de aplicativo para promover → promo de tópico.
  • Se a mensagem do usuário fizer referência a uma build app/frontend existente, 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

  1. Inicialize o projeto Remotion com FrontendEngineer.use_template("remotion") se app/promo ainda 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.
  2. 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.
  3. 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.
  4. Fundamente o assunto:
    • Promo de projeto: primeiro, resolva o aplicativo de origem que está sendo promovido, depois leia o código-fonte app/frontend desse aplicativo, manifestos e feedback de validação anterior. Se o workspace atual contiver principalmente a saída da promo, não trate o próprio app/promo como o aplicativo de origem. Depois de identificar o aplicativo de origem, fixe esse caminho raiz do projeto/frontend em promo_storyboard.md ou em notas de trabalho e continue reutilizando o mesmo caminho após mudar para app/promo; não rebaixe para promo de tópico apenas porque o próprio workspace da promo não tem app/frontend. Antes de escrever o código Remotion, registre os principais caminhos de arquivo de frontend de origem que você usará em promo_storyboard.md (páginas/rotas/componentes para os beats de demonstração). Mais tarde, ao implementar src/, 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-understanding e chame ImageAnalyzer.analyze_images antes 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.goto para visitar a página, depois Browser.take_screenshot para capturar o visual, e então chame ImageAnalyzer.analyze_images na 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.
  5. 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.
  6. 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 como Language: English (default) ou Language: Chinese (user specified) antes de rascunhar cenas, texto, narração ou prompts de geração.
  7. Crie promo_storyboard.md antes 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 um todo.md separado.
  8. 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-generation e chame AudioCreator.generate_audios com uma solicitação por cena/beat.
  9. Após a geração de TTS, prefira a duration retornada de cada segmento de áudio. Se duration estiver faltando ou for null, meça a duração real a partir do URL retornado (por exemplo, com ffprobe), 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.
  10. Imediatamente atualize promo_storyboard.md com 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 chame MusicCreator.generate_music, VideoCreator.generate_videos, gere mais ativos visuais ou escreva src/timeline.ts até que o tempo atualizado seja persistido em promo_storyboard.md. Após este bloqueio, promo_storyboard.md não deve mais manter linhas de tempo TBD de espaço reservado ou uma duração total desatualizada.
  11. 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-generation e chame MusicCreator.generate_music com 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.
  12. Após a geração da música, use o URL retornado diretamente e prefira a duration retornada, assim como na narração. Se duration estiver faltando ou for null, meça a duração real do BGM com ffprobe. Imediatamente atualize promo_storyboard.md com o URL do BGM, segundos medidos, duração total alvo, estratégia de ajuste e valores de mix planejados antes de escrever src/timeline.ts ou src/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.
  13. 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.
  14. Leia remotion-best-practices e os arquivos de regra relevantes para o storyboard.
  15. Edite a implementação Remotion no local em app/promo — mantenha o layout src/ 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 como src/remotion/. Antes da validação, faça uma auto-verificação rápida: remova imports/variáveis não utilizados, omita Sequence from={0} redundante, mantenha a animação puramente baseada em frames (sem animation / transition CSS, temporizadores ou outros padrões não determinísticos) e atualize qualquer contrato alterado de src/timeline.ts / src/PromoVideo.tsx / src/scenes/* na mesma passagem.
  16. Execute a validação em ordem: verify:versions, lint, verify:compositions. Passar verify:compositions apenas prova que o Remotion pode ver as composições; não é uma entrega e não é um ponto de parada válido.
  17. Execute RemotionPromoRenderer.render para 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, use width=1080, height=1920 e source_orientation=portrait em vez de copiar um exemplo paisagem. A tarefa só está concluída quando out/promo-<width>x<height>.mp4 existe 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, chame RoleZero.reply_to_human ou 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]

Habilidades Relacionadas