Communitygithub.com

Tech7516/Inventaire_PCP16

Use esta habilidade ao criar um vídeo editado completo — promocional, demonstração de produto, vídeo explicativo, tópico, redes sociais/Reels/TikTok, tour/local, e-commerce/packshot/360, DTC/antes-depois, ou qualquer peça com múltiplas cenas/roteirizada — para o projeto atual ou um assunto fornecido pelo usuário. Use também sempre que o vídeo for pareado com narração/voiceover ou uma trilha de áudio separada, ou precisar ser sincronizado com uma duração de áudio medida (mesmo que seja um único clipe de imagem-para-vídeo com uma linha de voiceover), pois apenas a linha do tempo do Remotion impede que o áudio seja cortado.

O que é Inventaire_PCP16?

Esta skill é especializada na criação de vídeos promocionais completos e editados usando o framework Remotion, cobrindo uma ampla gama de tipos de vídeo: desde vídeos promocionais de projetos de software e demonstrações de produtos até vídeos explicativos, conteúdo para redes sociais (Reels/TikTok), tours de negócios locais (探店), e-commerce com packshots ou rotação 360, e anúncios de resposta direta (DTC/antes-depois). Ela é útil quando o vídeo requer uma linha do tempo com múltiplas cenas, legendas, áudio sincronizado (narração ou música) e uma chamada para ação final (CTA), garantindo que o áudio não seja cortado, algo que o Remotion resolve ao contrário de outras ferramentas de geração direta de vídeo por IA. A skill suporta tanto vídeos promocionais de projetos (aplicativos existentes no workspace) quanto de tópicos externos (como um conceito ou lugar físico), orientando o usuário na classificação do assunto, criação de storyboard, seleção de orientação (paisagem, retrato ou quadrado), e na aplicação de uma linha de base de conformidade para evitar alegações enganosas ou conteúdo sensível. O fluxo de trabalho inclui inicialização do projeto Remotion, classificação do assunto, pesquisa de contexto (código-fonte ou URL), geração de assets (áudio, música, vídeo, imagens) e edição in-place dos componentes do Remotion, garantindo que a duração final do vídeo seja baseada na duração real dos segmentos de áudio gerados.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Tech7516/Inventaire_PCP16/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 esta habilidade quando o usuário solicitar 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 para redes sociais/Reels/TikTok de descoberta, vídeo de negócio local, vídeo estilo vlog de restaurante/comida, anúncio de produto, vídeo de produto estilo e-commerce/Amazon, packshot ou vídeo de rotação 360 de produto, vídeo de fachada de loja / 探店, anúncio de conversão DTC / resposta direta / antes-depois, vídeo editado com 20s+, 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, tomadas, 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 "promocional" ou "promo". 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 prévio confirmado. 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 template Remotion, as mesmas predefinições de composição e os mesmos comandos de renderização. Apenas a autoria do storyboard difere.

Comando

Use RemotionPromoRenderer.render para a exportação final da promo após a validação. Este comando é documentado por esta habilidade e pode ser chamado mesmo que não esteja listado em <Available Commands>.

width/height/source_orientation DEVEM vir da Especificação de Exportação do storyboard, não deste exemplo. O exemplo abaixo mostra valores de paisagem como placeholders; se o storyboard for retrato, passe width=1080 height=1920 source_orientation=portrait (e quadrado → 1080/1080/square). O nome do arquivo de saída é promo-<width>x<height>.mp4, portanto uma renderização em retrato que use 1920x1080 incorretamente é um sinal de que você copiou o exemplo em vez de ler o storyboard.

<RemotionPromoRenderer.render>
<promo_dir>/absolute/path/to/app/promo</promo_dir>
<width>WIDTH_FROM_STORYBOARD</width>
<height>HEIGHT_FROM_STORYBOARD</height>
<source_orientation>ORIENTATION_FROM_STORYBOARD</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 pergunte 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 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, um aplicativo em andamento que o agente está gerando, ou uma funcionalidade futura → promo de projeto.
  • Se o assunto for um produto físico, um negócio local/loja ou lugar, ou uma oferta de resposta direta sem uma UI de aplicativo reconstruível como assunto principal (por exemplo, um anúncio de difusor de carro, uma rotação 360 de joias, um 探店 de loja de ramen, um anúncio DTC de removedor de pelos de animais) → promo de comércio.
  • Se ambos se aplicarem (por exemplo, "faça uma promo para nosso aplicativo explicativo sobre o Sistema Solar") → trate o aplicativo como principal e use o tópico como assunto de suporte; esta é uma promo de projeto.

Use estes critérios de desempate quando mais de um se encaixar: uma UI de software reconstruível é o assunto → promo de projeto; um produto físico / lugar físico / oferta sem UI reconstruível → promo de comércio; um conceito ou conhecimento externo sem produto → promo de tópico. Um caso misto (por exemplo, um produto de software DTC cujo anúncio também mostra uma tela de checkout real) é classificado pelo que as tomadas principais vendem, e pode emprestar regras da outra classe por tomada (por exemplo, um batimento ui-demo de checkout dentro de uma promo de comércio).

Promos de tópico e promos de comércio são primárias. Não rejeite ou trave em uma promo de tópico apenas porque não há app/frontend no workspace, e não rebaixe uma promo de comércio para promo de tópico apenas porque o produto não tem app/frontend para reconstruir.

Linha de base de conformidade

Os vídeos promocionais devem padronizar regras conservadoras de segurança de anúncios. Use apenas alegações, ofertas, preços, descontos, brindes, nomes de marca, 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 landing page. 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 exageradas. Não segmente diretamente atributos pessoais sensíveis como saúde, finanças, idade, raça, religião, sexualidade, deficiência, estado civil, tipo corporal ou aparência; use redação de público neutra.

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 gráfica, 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édico, 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 informacional 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 inadequado de assets, ou legendas/logos/CTAs cortados nas bordas. Se a conformidade for incerta, escolha a expressão mais segura, neutra e informativa. Esta linha de base reduz o risco, mas não é uma garantia de aprovação da plataforma.

CTAs finais de conversão são conteúdo de vídeo estático, não UI web interativa. Não renderize o CTA de encerramento como um botão de site com aparência clicável, falso alvo de clique, botão de seta, campo de entrada falso, popup falso, UI de sistema falsa, alvo de cursor, estado de hover/pressionado, ou qualquer controle que implique que o espectador pode clicar para navegar. Use uma linha de tela final, slogan da marca, identificador da conta, URL, espaço reservado para QR, ou texto simples de "visite / escaneie / siga". Demonstrações de produto e walkthroughs de página 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 o CTA final de conversão.

Qualquer URL visível, identificador de conta, alvo de QR, texto de barra de endereço do navegador ou endpoint de marca deve vir da solicitação do usuário, da fonte do projeto confirmada, da landing page ou de outro asset verificado. Se o projeto expuser apenas um domínio placeholder ou nenhum endereço público confirmado, omita a URL e termine com texto da marca; para um tratamento de janela de navegador, use um rótulo de página que não seja URL ou deixe a barra de endereço em branco. Não infira um domínio, identificador ou destino a partir do nome do app, nome do repositório, nome do arquivo de download, placeholder do template, token de env var 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, teste e renderização completa devem usar a variante correspondente.
  3. Classifique o assunto (promo de projeto vs. promo de tópico) usando 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 app/promo como o aplicativo de origem. Depois de identificar o aplicativo de origem, fixe esse diretório raiz do projeto origem / caminho do frontend em promo_storyboard.md ou anotações 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 workspace da promo em si não tem app/frontend. Antes de escrever código Remotion, registre os caminhos dos principais arquivos de frontend de origem que você usará em promo_storyboard.md (páginas/rotas/componentes para os batimentos de demonstração). Mais tarde, ao implementar src/, reabra esses arquivos de origem e copie/recrie a partir do código em vez de depender de um resumo longo em prosa.
    • Promo de tópico: extraia o assunto da mensagem do usuário e da conversa anterior; obtenha fatos adicionais do seu próprio conhecimento ou 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 do 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 uma URL de site como assunto da promo, use Browser.goto para visitar a página, depois Browser.take_screenshot para capturar o visual, depois chame ImageAnalyzer.analyze_images na captura de tela antes do storyboard para que o plano visual seja fundamentado no conteúdo real da página, em vez da URL sozinha.
  5. Aplique a Linha de base de conformidade: confirme quais fatos, alegações, ofertas e assets são realmente suportados pela solicitação, produto, texto do anúncio ou landing page. Não invente ofertas, certificações, números de vendas, efeitos, parcerias oficiais, endossos de plataforma ou apoio de marca não suportados; quando incerto, escolha redação e visuais conservadores e informativos.
  6. Determine o idioma padrão para o conteúdo da promo 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, padrão para 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 Idioma: Inglês (padrão) ou Idioma: Chinês (especificado pelo usuário) antes de redigir tomadas, texto, narração ou prompts de geração.
  7. Crie promo_storyboard.md antes de escrever código de vídeo ou gerar assets. Use o conjunto de campos que corresponda 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, voice-over, walkthrough falado, ou o storyboard claramente precisar de um narrador, inclua um plano de narração de segmento curto no storyboard, verifique o comprimento do script de cada segmento em relação aos segundos alvo da tomada, depois leia audio-generation e chame AudioCreator.generate_audios com uma solicitação por tomada/batimento.
  9. Após a geração TTS, prefira o duration retornado de cada segmento de áudio. Se duration estiver ausente ou null, meça a duração real a partir da URL retornada (por exemplo com ffprobe), depois decida o tempo final por tomada a partir dessas durações medidas. Este cálculo não é suficiente se aparecer apenas no pensamento ou na saída do terminal.
  10. Atualize imediatamente promo_storyboard.md com cada URL de narração, segundos de áudio medidos, início/fim/duração final da tomada, duração total e quaisquer alterações de script/tempo. Este é um checkpoint difícil: não chame MusicCreator.generate_music, VideoCreator.generate_videos, gerar mais assets visuais, ou escrever 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 placeholder TBD ou uma duração total desatualizada.
  11. Por padrão, os vídeos promocionais também devem incluir um plano de música de fundo global, 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 tomada estar bloqueado. O prompt deve incluir os segundos totais 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 a URL retornada diretamente e prefira o duration retornado, como na narração. Se duration estiver ausente ou null, meça a duração real do BGM com ffprobe. Atualize imediatamente promo_storyboard.md com a URL do BGM, segundos medidos, duração total alvo, estratégia de encaixe 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; apare, faça um loop mínimo ou regenere a música, a menos que o usuário tenha solicitado explicitamente um corte mais curto.
  13. Gere quaisquer outros assets de IA (imagem/vídeo/áudio) necessários após o storyboard estar escrito e o tempo da narração + BGM estar definido em promo_storyboard.md.
  14. Leia remotion-best-practices e concentre-se nas seções relevantes ao storyboard.
  15. Edite a implementação Remotion no local em app/promo — mantenha o layout plano src/ do template (src/Root.tsx, src/PromoVideo.tsx, src/timeline.ts, src/components/, src/scenes/, src/app-demo/). Não mova os fontes para um subdiretório como src/remotion/. Antes da validação, faça uma auto-verificação rápida: remova imports/vars não utilizados, omita Sequence from={0} redundantes, mantenha o movimento puramente baseado em frames (sem animation / transition CSS, tempo...

[truncado para tradução]

Habilidades Relacionadas