Communitygithub.com

countdown-video

制作榜单倒计时或逐年“进化”视频(电影、票房、评分或任何排名列表),以动画卡片形式展示排名/年份揭示,可选预告片剪辑、音乐、音效和YouTube章节,渲染为MP4。

countdown-video 是什么?

Countdown-video是一个AI Agent技能,用于将排名列表自动渲染成专业风格的榜单视频,支持两种模式:倒计时模式(从No.N到No.1,带橙色“No.X”冲击动画)和时间线模式(按年份排序的“进化”视频,如“LAIKA动画进化2005–2022”)。每个条目可包含全屏预告片剪辑,配合音乐、音效和YouTube章节生成,最终输出MP4文件。该技能支持Claude Code、Cursor和Codex等多种AI平台,通过读取`items.json`数据文件驱动整个流程,包括研究排名、编写JSON、构建HTML预览、并行渲染和音频合成。用户需自行提供海报图片和预告片文件,AI负责搜索排名来源(如Box Office Mojo、IMDb、Rotten Tomatoes)并验证数据准确性,但不会自动下载媒体文件。整个流水线通过`make_countdown.sh`脚本自动化执行,支持自定义主题颜色、音乐轨道和语音旁白,最终交付可发布的视频、章节文件、来源列表和推荐标题描述。

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

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

倒计时视频

将排名列表转化为电影/列表频道风格的成品列表视频。两种模式:

  • "mode": "countdown"(默认):从No.N到No.1,每个条目开始前出现橙色“No.X”冲击动画。
  • "mode": "timeline":“进化”视频(例如 LAIKA动画进化 2005–2022),从最旧到最新,每个条目开始前出现大字年份卡片。

两种模式下,条目可以携带预告片剪辑,在卡片显示后全屏播放,并带有左下角标题和预告片自身的音效(音乐在其下方减弱)。在列表频道上,卡片 + 每部电影约25–30秒预告片是保持观众最久的格式。

视频包含开场、每个条目的“No.X”排名冲击动画、动画卡片(图片、标题、年份、类型、带柱状图的金统计、评分、趣闻)、进度追踪器和结尾屏幕(预留YouTube结尾元素插槽)。一切由数据驱动:研究结果写入items.json,引擎渲染输出。

用用户首选语言与用户交流;代码和items.json保留英文,除非用户要求屏幕文字使用其他语言。

文件(相对于该技能文件夹)

文件用途
templates/countdown_template.html引擎:开场、排名卡片、条目卡片、追踪器、结尾。主题和时间可通过items.json覆盖。
scripts/build_countdown.py从items.json生成_work/build.html、timeline.json、cues.json(音效)、chapters.txt;标记缺失/不可读的图片。
scripts/render.py确定性帧范围渲染器(Playwright → x264)。
scripts/compose_clips.py将每个条目的预告片剪辑以全帧(信箱模式)放置,加上左下角“预告片 · 标题(年份)”字样,并提取剪辑音频。由make_countdown.sh自动运行。
scripts/countdown_audio.py原始乐观音乐循环(或--music your_track.mp3),根据提示的嗖嗖/打击/爆破/滴答音效,预告片音频以音乐减弱至--clip-music(默认0.12),可选排名字幕旁白。
scripts/make_countdown.sh完整流水线:构建 → 并行渲染 → 音频 → MP4 + 质量检查表 + 章节。

设置:pip install playwright soundfile scipy pillow --break-system-packages 并 playwright install chromium(如缺失);ffmpeg需在PATH中。可选旁白:Kokoro TTS(参见PPT动画技能的voiceover.py)。

工作流程

  1. 简要说明。 主题、模式(倒计时或时间线)、条目数量(N)、排名指标(例如全球票房)、要显示的字段、是否包含预告片剪辑(以及时长,默认25秒)、视频长度(≈ 5秒开场 + N ×(~11秒 + 剪辑)+ 12秒结尾)、音乐(用户提供的曲目或生成)。如果用户在场,只询问一次;否则选择合理的默认值并告知用户。
  2. 研究排名。 使用网络搜索并打开源页面;切勿凭记忆填写数字。推荐来源:Box Office Mojo / The Numbers(预算、全球总票房)、IMDb、Rotten Tomatoes、Metacritic(评分)、Wikipedia(年份和类型)。在每个条目的sources中记录URL。如果两个来源不一致,对排名指标一致使用其中一个来源并注明。如果找不到某个值,则省略该字段(卡片会自适应)——切勿编造。
  3. 编写items.json(架构见下文),排名1..N,其中1为最佳条目。视频从N倒计时到1("order": "up"则反转)。
  4. 图片和剪辑。 使用用户提供的图片和预告片文件(posters/<slug>.jpg,2:3竖版;clips/<slug>.mp4)。不要自行从网络下载海报、预告片、剧照或人物照片;请用户将文件放入文件夹。没有图片时,卡片显示干净的标题占位符;缺少剪辑时跳过,因此可以先渲染草稿。对于每个剪辑,选择start(跳过制片厂标志和黑帧)和duration。预告片可能在YouTube上引发Content ID声明;这是频道所有者需要处理的问题,因此提及一次。
  5. 构建 + 预览。 运行python3 scripts/build_countdown.py items.json _work/,然后截图若干时刻(开场约3秒、一张排名卡片、一张完整的条目卡片结尾、结尾屏幕)并检查:没有重叠、长标题能容纳、数字在360p下可读。
  6. 渲染。 运行bash scripts/make_countdown.sh items.json out.mp4 [chunks] [-- --music track.mp3 --music-vol 0.5 --voice vo_dir]。
  7. 质量检查。 打开out_sheet.png;对照items.json抽查数字;确认时长以及每个排名只出现一次。
  8. 交付。 MP4文件、章节文件(out_chapters.txt,粘贴到YouTube描述中)、来源列表以及建议的标题/描述/标签。提醒用户在YouTube Studio中为结尾屏幕插槽添加结尾元素。

items.json 架构

以下值为占位符,仅展示结构,非真实数据。

{
  "title": "Top 5 Highest-Grossing Stop-Motion Movies",
  "subtitle": "Ranked by worldwide box office",
  "channel": "Channel Name",
  "currency": "$",
  "order": "down",
  "mode": "countdown",
  "intro_image": "logo.png",
  "outro_title": "Which one is your favourite?",
  "outro_subtitle": "Tell us in the comments!",
  "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": "Family/Comedy",
      "image": "posters/chicken-run.jpg",
      "stats": [{"label": "Budget", "value": 45000000}, {"label": "Box Office", "value": 225100000}],
      "multiple": "5x its budget",
      "ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
      "fact": "One short, sourced sentence.",
      "teaser": "optional line under the No.X slam",
      "clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
      "label": "optional text for the slam card instead of No.X / the year",
      "seconds": 9,
      "sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
    }
  ]
}
  • stats[].value为数字时 → 动画计数并带比较柱状图(每个卡片内柱状图共享同一比例尺);为字符串时 → 原样显示(例如"N/A"、"8,848 m")。任何标签都适用,因此同一引擎可用于非电影类倒计时(最高建筑、最富有的人、最快汽车)。
  • ratings键可选:imdb(0–10,星级)、rt / rt_audience / metacritic(0–100,环形)。缺失键不显示;没有评分的卡片会居中其他信息框。
  • clip.start接受秒或m:ss格式;剪辑以16:9信箱模式显示,并在卡片后播放。章节和结尾屏幕时间会自动考虑剪辑长度。
  • intro_image(例如用户提供的制片厂标志)替代开场中的TOP N / EVOLUTION徽章。
  • 时间线模式下,条目按year排序;卡片上的排名徽标隐藏,章节显示为“标题(年份)”。
  • multiple是金钱框下的简短高亮标签;根据来源数字计算(四舍五入至一位小数)。
  • 评分仅以文字标签显示——无品牌标志。
  • 屏幕上显示的任何评分、数字或趣闻必须来自sources中的来源。

风格说明

  • 默认主题符合经典列表频道风格:交替的绿色/黄色蜡笔纹理卡片、红色边框、带光芒的橙色“No.X”冲击动画、紫色金钱框、蓝色评分框。可在theme中覆盖任何颜色。
  • 360p下可读性:保持标题简短(副标题承载类型),趣闻不超过2行,不要添加超过4个统计项。
  • 留存率:每个条目约11秒;将最强条目放在最后;排名冲击动画+嗖嗖/打击音效每次重新吸引注意力;开场不超过5秒。
  • YouTube章节每段需要≥10秒,因此开场自动折叠到第一个排名的章节中。

相关技能