Communitygithub.com

promo-de-produto-a-partir-do-repo

Prepare um vídeo promocional / de lançamento para um produto de software cujo código-fonte está em um repositório git — roteiros, um storyboard tomada a tomada, narração (MiniMax), trilha sonora original sintetizada em código e as telas do produto redesenhadas em HTML a partir do código frontend e backend do repositório.

O que é promo-de-produto-a-partir-do-repo?

Esta skill gera automaticamente um vídeo promocional de 30 a 45 segundos para um produto de software diretamente a partir do seu repositório Git. Ela analisa o código real para extrair fatos como navegação, fluxo de tarefas, dados de demonstração e limites de produto, garantindo que cada afirmação no vídeo seja rastreável ao código-fonte. A skill suporta a criação de storyboards (STORYLINES.md), narração via API MiniMax, trilha sonora original sintetizada com numpy/ scipy em scripts/score.py, e a reconstrução das telas em HTML puro sem executar o aplicativo. É ideal para desenvolvedores que desejam um vídeo de demonstração realista e acionável para apresentar seu projeto, evitando impressões genéricas e vídeos genéricos de IA.

Funciona com~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/rayest/ai-video-skills/tree/HEAD/skills/product-promo-from-repo

Perguntar na sua IA favorita

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

Documentação

Promo de produto a partir de um repositório

Um filme de 30 a 45 segundos que mostra um único usuário realizando uma tarefa real no produto, com rótulos reais do código, narração e trilha sonora original. Esta skill cobre a obtenção correta do produto a partir do seu código, a história, a voz, a música e as telas redesenhadas. Ela não prescreve um mecanismo de renderização; escolha um com o usuário (prefira ferramentas gratuitas).

1. Leia o código certo

  • git fetch --all e compare branches (git log -1 origin/<b> para cada) antes de ler qualquer coisa. O branch padrão pode estar desatualizado — main pode ainda ser o commit inicial enquanto o produto foi renomeado e reconstruído em dev. Construir roteiros no branch errado desperdiça uma rodada completa. Se o usuário disser que o nome ou os recursos mudaram, acredite nele e encontre o branch que tem o novo (git grep -c <novo nome> origin/<b>).
  • Colete fatos, não impressões: a navegação (o próprio mapa do produto do que ele faz), os componentes de página do fluxo de tarefa principal, nomes de catálogos nos dados de seed do backend, limites e números reais (comprimentos máximos, fórmulas como "tempo estimado = palavras ÷ 4,5"). Cada afirmação no filme deve ser rastreável a um desses fatos.
  • Copie o logotipo e miniaturas/ícones do repositório para assets/. Verifique se o logotipo não possui texto de marca antigo.

2. Roteiros, depois pare

Escreva três roteiros em STORYLINES.md (cada um: premissa de uma linha, lista de beats com tempos, a transição que carrega cada emenda) e pare para o usuário escolher. O que funcionou melhor para um produto de várias etapas: um objeto viaja pelas etapas do produto (uma postagem encontrada → um cartão de tópico → um roteiro → um vídeo finalizado), inserido pelo cursor que o agarra. Coloque sua recomendação primeiro.

Declare as suposições em uma linha: duração 30–40 s, 1920×1080, música + efeitos, narração sim/não, dados do produto na tela são dados de demonstração.

3. Narração (MiniMax)

Apenas quando solicitado. Insira $MINIMAX_API_KEY ou a primeira linha de ~/.minimax_key; nunca imprima.

  1. Uma linha curta por beat em voice/script.json ([{"id", "text"}]), ~4,5 caracteres chineses por segundo, ~120–140 caracteres para 35–40 s. As linhas são causa e efeito, não slogans; a tela mostra palavras-chave, nunca a frase falada literalmente.
  2. Mostre ao usuário as linhas, o ID da voz e o modelo, e obtenha um sim — cada chamada é faturada. python3 -I scripts/tts_minimax.py voice --dry-run imprime a contagem de caracteres e o tempo estimado.
  3. Gere uma vez: python3 -I scripts/tts_minimax.py voice [--voice ID] → vo-<id>.mp3 e durations.json. Regere uma linha com --only id.
  4. A voz é o relógio: disponha as cenas a partir de durations.json (cada linha começa ~0,15–0,25 s em sua cena; cena ≈ linha + 0,3–0,6 s).

4. Telas do produto: redesenhar a partir do código

Não execute o aplicativo nem simule seu backend para capturas de tela; reconstrua as telas em HTML a partir dos componentes, CSS e dados do backend. Leia references/ui-redraw.md antes da primeira cena do produto.

Rotule os dados de demonstração como 演示数据 · 虚构 (Dados de demonstração · Fictícios). Nunca mostre um nome ou logotipo de produto antigo e nunca invente um botão que o código não possui.

5. Música e efeitos

  • scripts/score.py sintetiza uma trilha original cuja grade de compassos coloca uma batida forte no payoff e o logotipo atinge um número inteiro de batidas depois (requer numpy + scipy): score.py assets/bgm/score.wav --total 38.5 --bpm 104 --hook-end 4.6 --reveal 9.8 --build 24.2 --payoff 27.0 --claim 31.6 --logo-beats 13 Escolha --logo-beats para que payoff + beats × 60/bpm caia onde a marca do cartão final cai.
  • Efeitos de fontes gratuitas (clique, whoosh, pop, digitação, riser, impacto, brilho). Um som por causa visível.

6. Especificação e revisão

  • Escreva SPEC.md antes das cenas: GOAL, OUTPUT, TIME, VOICE, DATA, LOOK, OBJECTS, MOTION, SHOTS com tempos, BANNED, QA frames.
  • Verifique cada beat e emenda: corrija emendas cuja direção de movimento inverte (um objeto saindo pela direita deve entrar na próxima cena pela direita), elementos que desaparecem antes de pousar, metades vazias de um quadro principal.
  • Escreva REVIEW.md: decisões criativas, o que foi medido vs. apenas observado, a tomada mais fraca.
  • Áudio final: cerca de -16 a -14 LUFS, pico verdadeiro ≤ -1 dBTP, sem clipping. Diga que o som foi medido, não ouvido.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas