Communitygithub.com

hyperspell/vídeo-release-notes

Crie vídeos musicais de release notes ou atualizações semanais usando Suno, revisão de áudio Gemini, animação Dreamina/Seedance, Blender e composição de vídeo temporizada.

O que é vídeo-release-notes?

Este skill permite que um agente de IA produza vídeos musicais envolventes para release notes públicos ou atualizações internas, combinando música gerada por IA, animação e demonstrações reais do produto. Ele orquestra um fluxo de trabalho completo: desde a definição do briefing com aprovação humana, passando pela escrita de letras, geração e comparação de takes musicais (usando Suno e Gemini para avaliação de áudio), criação de storyboard e animação (com Dreamina/Seedance e Blender), captura de tela do produto (com Playwright e HTML Canvas), até a sincronização precisa de lábios e batidas, mixagem final com FFmpeg e entrega de um kit de pós-produção. O agente deve trabalhar no diretório do projeto do usuário, respeitar decisões aprovadas (como letras bloqueadas e música selecionada), tratar geração paga e publicação como ações distintas que exigem autorização, e manter invariantes como usar comportamento real do produto com dados aprovados e manter credenciais fora do skill. A documentação detalhada orienta o agente sobre cada etapa (briefing, gênero musical, sincronia, composição visual, mixagem e QA), com scripts utilitários locais para análise de áudio, alinhamento de letras, renderização e verificação de ativos. O resultado é um vídeo polido que torna a atualização inesquecível, adequado para formatos sociais (1080×1350 4:5) ou apresentações internas (16:9), com o gancho nos primeiros segundos e cada palavra cantada em sincronia.

Funciona com~Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/hyperspell/release-notes-video-skill/tree/HEAD/skills/release-notes-video

Perguntar na sua IA favorita

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

Documentação

Vídeo de release notes musical

Faça um vídeo que as pessoas queiram assistir e que também torne a atualização inconfundível. O gênero define a música, o mundo visual, a tipografia e a edição. Demonstrações reais carregam a explicação; a música e as piadas visuais tornam a experiência memorável.

Use Suno para música, Gemini para comparar gravações, geração de imagens OpenAI para stills, Dreamina/Seedance para animação, Blender para 3D e controle de câmera, Playwright com HTML Canvas para captura e composição de produto, Demucs/Whisper/librosa para sincronia e FFmpeg para mixagem e entrega. Adicione efeitos ElevenLabs quando necessário. Leia Ferramentas e configuração antes da produção; ele explica as transferências e o fluxo de trabalho da CLI Dreamina. Se uma ferramenta estiver indisponível, explique a capacidade ausente e concorde com um substituto, em vez de descartá-la silenciosamente.

Estabeleça o briefing

Resolva o público, prazo, duração alvo, formato de exibição pretendido, notas de origem, ferramentas disponíveis e aprovador. Pergunte apenas sobre informações ausentes que alterem materialmente o trabalho. Use escolhas e autorizações existentes da conversa.

  • Release notes públicos: alegações de funcionalidades devem estar lançadas, disponíveis e verificadas para o público-alvo. Uma implementação ou mudança mergeada por si só não prova disponibilidade.
  • All-hands interno: trabalho planejado, experimentos e métricas podem ser incluídos se o usuário os aprovar para aquele público e seu status for explícito. Não transforme planos em lançamentos silenciosamente.
  • Formato: padrão é 1080×1350 nativo, 4:5 para redes sociais. Confirme a exibição para um all-hands; 16:9 pode ser apropriado. O scaffold exige --aspect para episódios internos por esse motivo. Entregue um formato, a menos que mais sejam solicitados.
  • Duração: concorde com um alvo. Cerca de 60–90 segundos é uma proposta inicial útil para um episódio público; atualizações internas podem precisar de uma duração diferente. Escreva para a duração escolhida desde o início.

Trabalhe no próprio diretório do projeto do usuário, nunca dentro do diretório deste skill. Em comandos, <skill> significa o caminho absoluto do diretório deste skill. Crie uma pasta de episódio com python3 <skill>/scripts/new_episode.py <project>/episodes/<data>-<slug> --audience public --duration 60, ou use uma estrutura de projeto existente.

Mantenha estas invariantes

  • Use comportamento real do produto com dados fictícios ou explicitamente aprovados. Uma captura de tela de produção não é automaticamente adequada para um serviço externo ou vídeo público.
  • Mantenha credenciais, valores de sessão, detalhes de negócios não publicados e mídia de referência pessoal fora do skill distribuído. Use as contas escolhidas pelo usuário e ferramentas autorizadas.
  • Trate geração paga e publicação como ações distintas. Obtenha qualquer orçamento ausente ou autorização de publicação, e reutilize autorização já concedida para o mesmo escopo. A aprovação de uma música ou vídeo não é permissão para publicá-lo.
  • Preserve letras bloqueadas e a música selecionada. Altere-as apenas quando o usuário autorizar. Referências a artistas descrevem qualidades criativas; escreva letras e melodias originais.
  • Compare o áudio real antes de julgar uma performance. Medições, transcrição e julgamentos auditivos são evidências separadas.
  • Cada palavra cantada aparece em sincronia. Uma frase legível de capacidade explica cada funcionalidade demonstrada; ela não repete a letra.
  • Coloque o gancho nos primeiros segundos. Use um problema reconhecível ou imagem marcante, com contexto suficiente para saber o que o vídeo está anunciando.
  • Personagens e efeitos ganham seu tempo de tela. As imagens do produto mostram uma ação, resultado útil e evidência quando relevante.
  • Mantenha o skill de distribuição separado dos dados do episódio. Não arquive ou publique o diretório de trabalho em massa.

Execute a produção

Use a sequência a seguir, adaptando-se às ferramentas e aprovações já disponíveis:

  1. Escolha a história. Verifique a janela de origem e o status de cada candidato. Favoreça um título significativo com capacidades de suporte, ou um pequeno conjunto de atualizações substanciais. Apresente a história proposta para aprovação antes de bloqueá-la. Leia Brief e texto.
  2. Escolha um mundo musical. Sugira três direções distintas com uma referência reconhecível, som preciso, imagem de abertura, narrador e piada de formato. Deixe o usuário escolher. Leia Gênero e história.
  3. Bloqueie as letras. Escreva uma canção curta e completa com detalhes específicos, um gancho memorável e piadas que sirvam à atualização. Mostre de onde vem cada alegação. Resolva edições antes de gerar um lote no Suno. Letras e seleção de take: Música.
  4. Gere e compare takes. Com o orçamento autorizado, use Suno para fazer arranjos e abordagens vocais significativamente diferentes. Peça ao modelo Gemini mais recente com capacidade de áudio para comparar as gravações completas juntas, quando o acesso e a permissão permitirem; sem acesso ao Gemini, use outro modelo que possa ouvir várias gravações completas em uma única solicitação. Verifique a disponibilidade em vez de inventar um nome de modelo. A seleção do usuário substitui a recomendação.
  5. Construa dados de temporização. Retenha o original escolhido, registre qualquer corte/fade, alinhe palavras cantadas e estabeleça a grade de batida. Leia Sincronia e use os auxiliares de produção incluídos para análise de batida/tempo de ataque e alinhamento. Inspecione cada palavra não resolvida antes de aceitar a linha do tempo.
  6. Planeje e construa a imagem. Crie um storyboard de toda a linha do tempo antes de preenchê-la com animação. Capture demonstrações de produto com Playwright, gere stills de primeiro frame e anime cenas selecionadas com Dreamina/Seedance. Use Blender para cenas que precisam de geometria 3D controlada ou movimento de câmera, como renders finais ou referências de movimento. Construa primeiro a explicação do produto, depois adicione o mundo do gênero, personagens aprovados e absurdidade visual intencional. Leia Imagem.
  7. Mix, renderize e inspecione. Use efeitos sonoros sutis e intencionais. Verifique cada corte, legenda, pausa de leitura e limite de clipe, depois exporte uma revisão de qualidade total. Leia Som e entrega e QA.
  8. Revise e entregue. Aborde o feedback sem alterar a música bloqueada desnecessariamente. Após a aprovação, promova os bytes aprovados para um nome de arquivo final estável. Faça demonstrações de produto silenciosas independentes e um kit de postagem se solicitado. Registre o inventário de origem e verifique o arquivo antes da limpeza. Atualize o histórico privado de gênero/dispositivo e salve lições reutilizáveis na referência relevante, sem importar transcrições de feedback privadas.

Não prossiga além de uma história, gênero, letra ou decisão de música não resolvida que exija a escolha do usuário. Uma vez que uma decisão é tomada, continue dentro do escopo aprovado sem perguntar novamente. Distribuição interna e postagem pública continuam sendo escolhas separadas.

Utilitários opcionais

Todos os scripts incluídos operam localmente e não exigem credenciais de serviço:

ScriptPropósito
scripts/new_episode.pyCriar uma pasta de episódio, briefing e manifesto do kit
scripts/inspect_media.pyRelatar streams/dimensões/duração e validar um clipe silencioso ou exportação esperada
scripts/contact_sheet.pyCriar uma folha de contato com timestamps usando FFmpeg e Pillow
scripts/build_posting_kit.pyConstruir um kit HTML offline e ZIP com clipes de demonstração silenciosos originais
scripts/analyze_audio.pyAjustar a grade de batida alinhada ao kick ou medir um ataque vocal/tempo de envelope
scripts/align_lyrics.pyAlinhar a folha de letras cantadas, preservar evidências de tempo e sinalizar palavras não resolvidas
scripts/render.mjsCapturar a composição de um episódio em tempos exatos da música; renderizar stills, imagens silenciosas e demonstrações
scripts/master_audio.pyCopiar a imagem e multiplexar uma trilha sonora com duração correspondente usando ganho plano medido
scripts/flicker.pySinalizar lapsos, mergulhos e pulsos espaciais perdidos por folhas de contato esparsas
scripts/asset_manifest.pyCriar e verificar um inventário de checksum para um arquivo de episódio restaurado

O agente escreve a composição do episódio com HTML Canvas e Playwright; o renderizador incluído a captura e o FFmpeg codifica/multiplexa o resultado. Comandos e contratos de entrada/saída estão em Auxiliares de produção. Use outro editor quando o usuário o escolher. Preserve o modelo de temporização e os ativos de origem para que outro agente possa reconstruir o episódio.

Habilidades Relacionadas