Communitygithub.com

video-cuenta-atrás

Crea vídeos de cuenta atrás o evolución año por año con tarjetas animadas, clips de tráiler opcionales, música, efectos de sonido y capítulos para YouTube, renderizados en MP4.

¿Qué es video-cuenta-atrás?

Este skill genera vídeos de listas animados al estilo de canales de cine, en dos modos principales: 'cuenta atrás' (del No.N al No.1) y 'línea de tiempo' (evolución cronológica). Cada entrada puede incluir una tarjeta animada con rango, título, año, estadísticas financieras, puntuaciones, un dato curioso y un tráiler de hasta 25 segundos. El skill automatiza todo el flujo: desde la investigación de datos y la generación del archivo JSON de items, la construcción de la página HTML animada, la renderización con Playwright y la composición de audio con música y efectos de sonido. Soporta temas personalizables, imágenes de póster proporcionadas por el usuario y clips de tráiler. Está diseñado para funcionar en sistemas con Python, Playwright y ffmpeg instalados. El asistente guía al usuario en la investigación de fuentes fiables, la redacción del archivo items.json, la previsualización de fotogramas clave y la renderización final del MP4. También incluye herramientas de QA para verificar números y duraciones.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Vídeo Cuenta Atrás

Convierte una lista clasificada en un vídeo de lista terminado al estilo de los canales de películas/listas. Dos modos:

  • "mode": "countdown" (predeterminado): No.N → No.1, una cartela naranja "No.X" antes de cada entrada.
  • "mode": "timeline": un vídeo de "evolución" (por ejemplo, Evolución de la animación LAIKA 2005–2022), del más antiguo al más reciente, una cartela grande de año antes de cada entrada.

En ambos modos, una entrada puede incluir un clip de tráiler que se reproduce a pantalla completa justo después de su tarjeta, con un título en tercio inferior y el sonido propio del tráiler (la música baja de volumen debajo). En los canales de listas, el formato de tarjeta + ~25–30 s de tráiler por película es el que retiene mejor a los espectadores.

El vídeo tiene una introducción, luego para cada entrada un golpe de rango "No.X" seguido de una tarjeta animada (imagen, título, año, género, estadísticas de dinero con barras, puntuaciones, un dato curioso), un rastreador de progreso y una pantalla final con espacios para elementos de pantalla final de YouTube. Todo está basado en datos: la investigación se vuelca en items.json, el motor lo renderiza.

Habla al usuario en su idioma preferido; conserva el código y items.json en inglés a menos que quiera el texto en pantalla en otro idioma.

Archivos (relativos a esta carpeta del skill)

ArchivoPropósito
templates/countdown_template.htmlEl motor: introducción, tarjetas de rango, tarjetas de ítem, rastreador, final. Tema y tiempos se pueden sobrescribir desde items.json.
scripts/build_countdown.pyitems.json → _work/build.html, timeline.json, cues.json (SFX), chapters.txt; avisa de imágenes faltantes o ilegibles.
scripts/render.pyRenderizador determinista por rango de fotogramas (Playwright → x264).
scripts/compose_clips.pyColoca el clip de tráiler de cada entrada a pantalla completa (con letterbox) con un tercio inferior "TRÁILER · Título (Año)" y extrae el audio del clip. Se ejecuta automáticamente con make_countdown.sh.
scripts/countdown_audio.pyBucle musical alegre original (o --music tu_pista.mp3), SFX de whoosh/golpe/pop/tick sobre señales, audio del tráiler con música bajada a --clip-music (por defecto 0.12), voz de rango opcional.
scripts/make_countdown.shTodo el pipeline: construir → renderizar en paralelo → audio → MP4 + hoja QA + capítulos.

Instalación: pip install playwright soundfile scipy pillow --break-system-packages y playwright install chromium si falta; ffmpeg en PATH. Voz opcional: Kokoro TTS (ver el skill de Animación PPT voiceover.py).

Flujo de trabajo

  1. Brief. Tema, modo (cuenta atrás o línea de tiempo), número de entradas (N), métrica de clasificación (p. ej., taquilla mundial), qué campos mostrar, si incluir clips de tráiler (y cuántos segundos, por defecto 25), duración del vídeo (≈ 5 s de intro + N × (~11 s + clip) + 12 s de outro), música (pista del usuario o generada). Pregunta una vez si el usuario está presente; de lo contrario, elige valores predeterminados sensatos y dilos.
  2. Investigar la clasificación. Usa búsqueda web y abre las páginas fuente; nunca rellenes números de memoria. Fuentes preferidas: Box Office Mojo / The Numbers (presupuesto, recaudación mundial), IMDb, Rotten Tomatoes, Metacritic (puntuaciones), Wikipedia para años y géneros. Anota la(s) URL(s) en las sources de cada ítem. Si dos fuentes discrepan, usa una fuente de forma consistente para la métrica de clasificación e indícalo. Si no se puede encontrar un valor, omite el campo (la tarjeta se adapta) — nunca lo inventes.
  3. Escribir items.json (esquema más abajo), rangos 1..N donde 1 es la entrada principal. El vídeo cuenta hacia abajo N → 1 ("order": "up" lo invierte).
  4. Imágenes y clips. Usa imágenes y archivos de tráiler que proporcione el usuario (posters/<slug>.jpg, 2:3 retrato; clips/<slug>.mp4). No descargues pósteres, tráileres, fotos fijas o fotos de personas de la web tú mismo; pide al usuario que los coloque en la carpeta. Sin imagen, la tarjeta muestra un marcador de posición de título limpio, y un clip faltante se omite, por lo que se puede renderizar un borrador primero. Para cada clip, elige start (saltar logotipos de estudio y fotogramas negros) y duration. Los tráileres pueden recibir reclamaciones de Content ID en YouTube; eso es decisión del propietario del canal, así que menciónalo una vez.
  5. Construir + vista previa. python3 scripts/build_countdown.py items.json _work/ y luego captura algunos momentos (intro ~3 s, una tarjeta de rango, una tarjeta de ítem completa al final, el outro) y MIRA: nada superpuesto, títulos largos caben, números legibles a 360p.
  6. Renderizar. bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music pista.mp3 --music-vol 0.5 --voice dir_voz].
  7. QA. Abre out_sheet.png; verifica números al azar contra items.json; confirma la duración y que cada rango aparezca una vez.
  8. Entregar. El MP4, los capítulos (out_chapters.txt, pégalos en la descripción de YouTube), la lista de fuentes y un título / descripción / etiquetas sugeridos. Recuerda al usuario que añada los elementos de pantalla final sobre los espacios del outro en YouTube Studio.

Esquema de items.json

Los valores siguientes son marcadores de posición que muestran la forma, no datos reales.

{
  "title": "Top 5 Películas Stop-Motion Más Taquilleras",
  "subtitle": "Clasificadas por taquilla mundial",
  "channel": "Nombre del Canal",
  "currency": "€",
  "order": "down",
  "mode": "countdown",
  "intro_image": "logo.png",
  "outro_title": "¿Cuál es tu favorita?",
  "outro_subtitle": "¡Dínoslo en los comentarios!",
  "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": "Familiar/Comedia",
      "image": "posters/chicken-run.jpg",
      "stats": [{"label": "Presupuesto", "value": 45000000}, {"label": "Taquilla", "value": 225100000}],
      "multiple": "5x su presupuesto",
      "ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
      "fact": "Una frase corta con fuente.",
      "teaser": "línea opcional bajo el golpe No.X",
      "clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
      "label": "texto opcional para la cartela de rango en lugar de No.X / el año",
      "seconds": 9,
      "sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
    }
  ]
}
  • stats[].value como número → cuenta animada hacia arriba + barra de comparación (las barras comparten una escala por tarjeta); como cadena → se muestra tal cual (p. ej. "N/A", "8.848 m"). Cualquier etiqueta funciona, por lo que el mismo motor sirve para cuentas atrás no cinematográficas (edificios más altos, personas más ricas, coches más rápidos).
  • Las claves de ratings son opcionales: imdb (0–10, estrella), rt / rt_audience / metacritic (0–100, anillo). Las claves que faltan desaparecen; una tarjeta sin puntuaciones centra sus otras cajas.
  • clip.start acepta segundos o m:ss; el clip se ajusta con letterbox a 16:9 y se reproduce después de la tarjeta. Los capítulos y el tiempo de la pantalla final se ajustan automáticamente a la duración del clip.
  • intro_image (por ejemplo, un logotipo de estudio proporcionado por el usuario) reemplaza la placa TOP N / EVOLUCIÓN en la introducción.
  • En modo línea de tiempo, las entradas se ordenan por año; la placa de rango en la tarjeta se oculta y los capítulos muestran "Título (Año)".
  • multiple es una píldora destacada corta debajo de la caja de dinero; calcúlala a partir de los números con fuente (redondea a un decimal).
  • Las puntuaciones se muestran solo como etiquetas de texto — sin logotipos de marca.
  • Cualquier puntuación, número o dato que se muestre en pantalla debe provenir de una fuente en sources.

Notas de estilo

  • El tema predeterminado coincide con los canales de listas clásicos: tarjetas alternas de textura de crayón verde/amarillo, borde rojo, golpe naranja "No.X" con rayos, caja de dinero púrpura, caja de puntuaciones azul. Sobrescribe cualquier color en theme.
  • Legibilidad a 360p: mantén los títulos cortos (el subtítulo carga el género), mantén los datos en ≤ 2 líneas, no añadas más de 4 estadísticas.
  • Retención: ~11 s por entrada; coloca las entradas más fuertes al final; el golpe de rango + SFX de whoosh/golpe reajusta la atención cada entrada; mantén la intro ≤ 5 s.
  • Los capítulos de YouTube necesitan ≥ 10 s cada uno, por lo que la intro se fusiona automáticamente en el capítulo del primer rango.

Skills relacionados