Communitygithub.com

vídeo-contagem-regressiva

Crie vídeos de contagem regressiva Top-N ou de "evolução" ano a ano (filmes, bilheterias, classificações ou qualquer lista ranqueada) com cartões animados que revelam posição/ano, clipes de trailer opcionais, música, efeitos sonoros e capítulos do YouTube, renderizados em MP4.

O que é vídeo-contagem-regressiva?

Esta skill permite transformar uma lista ranqueada em um vídeo finalizado no estilo de canais de listas de filmes, suportando dois modos principais: contagem regressiva (do NºN ao Nº1) e linha do tempo (evolução do mais antigo para o mais recente). Cada entrada pode incluir um clipe de trailer que toca em tela cheia após seu cartão, com título inferior e som próprio (a música é atenuada). O vídeo é gerado inteiramente a partir de um arquivo `items.json` que descreve os dados, imagens, clipes, estatísticas e preferências de tema. A skill utiliza uma pipeline de scripts em Python: `build_countdown.py` constrói o HTML, `render.py` renderiza quadros deterministicamente com Playwright e x264, `compose_clips.py` insere os clipes de trailer, e `countdown_audio.py` adiciona música e efeitos sonoros. O resultado final é um MP4 com capítulos para YouTube, prontos para colar na descrição. Ideal para criadores de conteúdo que desejam produzir vídeos de listas de forma rápida e profissional, com controle total sobre os dados exibidos e sem necessidade de edição manual.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/i-smiling-buddha/countdown-video-skill/tree/HEAD/skills/countdown-video

Perguntar na sua IA favorita

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

Documentação

Vídeo de Contagem Regressiva

Transforme uma lista ranqueada em um vídeo de lista finalizado no estilo de canais de filmes/listas. Dois modos:

  • "mode": "countdown" (padrão): NºN → Nº1, um "NºX" laranja com impacto antes de cada entrada.
  • "mode": "timeline": um vídeo de "evolução" (ex.: Evolução da Animação LAIKA 2005–2022), do mais antigo ao mais novo, um grande cartão de ano antes de cada entrada.

Em ambos os modos, uma entrada pode incluir um clipe de trailer que toca em tela cheia logo após seu cartão, com um título inferior e o som próprio do trailer (a música é atenuada por baixo). Em canais de listas, o formato cartão + ~25–30 s de trailer por filme é o que mantém a atenção dos espectadores por mais tempo.

O vídeo tem uma introdução, depois para cada entrada um impacto "NºX" seguido de um cartão animado (imagem, título, ano, gênero, estatísticas financeiras com barras, classificações, um fato curioso), um indicador de progresso e uma tela final com espaços para elementos de tela final do YouTube. Tudo é orientado a dados: a pesquisa vai para items.json, o motor renderiza.

Converse com o usuário no idioma de sua preferência; mantenha o código e items.json em inglês, a menos que o usuário queira texto na tela em outro idioma.

Arquivos (relativos a esta pasta da skill)

ArquivoFinalidade
templates/countdown_template.htmlO motor: introdução, cartões de posição, cartões de item, indicador, encerramento. Tema e temporização podem ser sobrescritos em items.json.
scripts/build_countdown.pyitems.json → _work/build.html, timeline.json, cues.json (efeitos sonoros), chapters.txt; sinaliza imagens ausentes/ilegíveis.
scripts/render.pyRenderizador determinístico de intervalos de quadros (Playwright → x264).
scripts/compose_clips.pyInsere o clipe de trailer de cada entrada em quadro cheio (com letterbox) com um título inferior "TRAILER · Título (Ano)", e extrai o áudio do clipe. Executado automaticamente por make_countdown.sh.
scripts/countdown_audio.pyLoop de música animada original (ou --music sua_musica.mp3), efeitos sonoros de whoosh/golpe/pop/tique nos momentos indicados, áudio do trailer com música atenuada para --clip-music (padrão 0.12), voz de classificação opcional.
scripts/make_countdown.shPipeline completo: construção → renderização paralela → áudio → MP4 + folha de QA + capítulos.

Configuração: pip install playwright soundfile scipy pillow --break-system-packages e playwright install chromium se faltar; ffmpeg no PATH. Voz opcional: Kokoro TTS (veja a skill de Animação PPT voiceover.py).

Fluxo de trabalho

  1. Briefing. Tópico, modo (contagem regressiva ou linha do tempo), quantas entradas (N), métrica de classificação (ex.: bilheteria mundial), quais campos mostrar, se deve incluir clipes de trailer (e por quanto tempo, padrão 25 s), duração do vídeo (≈ 5 s de intro + N × (~11 s + clipe) + 12 s de encerramento), música (faixa do usuário ou gerada). Pergunte uma vez se o usuário estiver presente; caso contrário, escolha padrões sensatos e informe.
  2. Pesquise a classificação. Use pesquisa na web e abra as páginas de origem; nunca preencha números de memória. Fontes preferidas: Box Office Mojo / The Numbers (orçamento, bilheteria mundial), IMDb, Rotten Tomatoes, Metacritic (classificações), Wikipedia para anos e gêneros. Registre a(s) URL(s) em sources de cada item. Se duas fontes discordarem, use uma fonte consistentemente para a métrica de classificação e anote. Se um valor não puder ser encontrado, omita o campo (o cartão se adapta) — nunca o invente.
  3. Escreva items.json (esquema abaixo), classificações 1..N onde 1 é a entrada principal. O vídeo conta de N → 1 ("order": "up" inverte).
  4. Imagens e clipes. Use imagens e arquivos de trailer fornecidos pelo usuário (posters/<slug>.jpg, 2:3 retrato; clips/<slug>.mp4). Não baixe pôsteres, trailers, imagens fixas ou fotos de pessoas da web; peça ao usuário para colocá-los na pasta. Sem imagem, o cartão mostra um espaço reservado de título limpo, e um clipe ausente é ignorado, permitindo renderizar um rascunho primeiro. Para cada clipe, escolha start (pule logotipos de estúdio e quadros pretos) e duration. Trailers podem gerar reivindicações Content ID no YouTube; isso é decisão do proprietário do canal, então mencione isso uma vez.
  5. Construção + pré-visualização. python3 scripts/build_countdown.py items.json _work/ e depois tire prints de alguns momentos (intro ~3 s, um cartão de classificação, um cartão de item completo no final, o encerramento) e VERIFIQUE: nada sobreposto, títulos longos cabem, números legíveis a 360p.
  6. Renderização. bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir].
  7. QA. Abra out_sheet.png; verifique números contra items.json; confirme a duração e que cada classificação aparece uma vez.
  8. Entrega. O MP4, os capítulos (out_chapters.txt, cole na descrição do YouTube), a lista de fontes e um título/descrição/tags sugeridos. Lembre o usuário de adicionar os elementos de tela final sobre os espaços de encerramento no YouTube Studio.

Esquema items.json

Os valores abaixo são placeholders que mostram a forma, não dados reais.

{
  "title": "Top 5 Filmes Stop-Motion de Maior Bilheteria",
  "subtitle": "Classificados por bilheteria mundial",
  "channel": "Nome do Canal",
  "currency": "$",
  "order": "down",
  "mode": "countdown",
  "intro_image": "logo.png",
  "outro_title": "Qual é o seu favorito?",
  "outro_subtitle": "Diga-nos nos comentários!",
  "timing": {"intro": 5, "rank": 1.8, "item": 9, "outro": 12},
  "theme": {"bgA": "#8BE36A", "bgB": "#F7E25A", "border": "#F0385C", "money": "#9B59D0", "ratings": "#5BD3F5"},
  "items": [
    {
      "rank": 1, "title": "Chicken Run", "year": 2000, "subtitle": "Família/Comédia",
      "image": "posters/chicken-run.jpg",
      "stats": [{"label": "Orçamento", "value": 45000000}, {"label": "Bilheteria", "value": 225100000}],
      "multiple": "5x seu orçamento",
      "ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
      "fact": "Uma frase curta e com fonte.",
      "teaser": "linha opcional sob o impacto NºX",
      "clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
      "label": "texto opcional para o cartão de impacto em vez de NºX / o ano",
      "seconds": 9,
      "sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
    }
  ]
}
  • stats[].value como número → contagem animada + barra de comparação (barras compartilham uma escala por cartão); como string → exibido como está (ex.: "N/A", "8.848 m"). Qualquer rótulo funciona, então o mesmo motor serve para contagens regressivas não cinematográficas (prédios mais altos, pessoas mais ricas, carros mais rápidos).
  • As chaves de ratings são opcionais: imdb (0–10, estrela), rt / rt_audience / metacritic (0–100, anel). Chaves ausentes desaparecem; um cartão sem classificações centraliza suas outras caixas.
  • clip.start aceita segundos ou m:ss; o clipe é letterboxado para 16:9 e é reproduzido após o cartão. Capítulos e a temporização da tela final levam em conta a duração do clipe automaticamente.
  • intro_image (ex.: logotipo do estúdio fornecido pelo usuário) substitui o selo TOP N / EVOLUÇÃO na introdução.
  • No modo linha do tempo, as entradas são ordenadas por year; o selo de classificação no cartão é ocultado e os capítulos exibem "Título (Ano)".
  • multiple é uma pequena pílula de destaque abaixo da caixa de dinheiro; calcule-a a partir dos números com fonte (arredonde para uma casa decimal).
  • As classificações são exibidas apenas como rótulos de texto — sem logotipos de marcas.
  • Qualquer classificação, número ou fato exibido na tela deve vir de uma fonte em sources.

Notas de estilo

  • O tema padrão combina com canais de listas clássicas: cartões alternados com textura de giz verde/amarelo, borda vermelha, impacto "NºX" laranja com raios, caixa de dinheiro roxa, caixa de classificações azul. Substitua qualquer cor em theme.
  • Legibilidade a 360p: mantenha títulos curtos (o subtítulo carrega o gênero), mantenha fatos com ≤ 2 linhas, não adicione mais de 4 estatísticas.
  • Retenção: ~11 s por entrada; coloque as entradas mais fortes por último; o impacto da classificação + efeitos sonoros de whoosh/golpe resetam a atenção a cada entrada; mantenha a introdução ≤ 5 s.
  • Capítulos do YouTube precisam de ≥ 10 s cada, então a introdução é automaticamente incorporada ao capítulo da primeira classificação.

Habilidades Relacionadas