Communitygithub.com

カウントダウンビデオ

ランキングリストや年次進化ビデオを、順位発表カードとアニメーションで自動生成し、MP4にレンダリングします。

カウントダウンビデオ とは?

このスキル(Countdown Video)は、映画ランキングや年次進化をテーマにしたリストビデオを自動生成するために設計された強力なツールです。ユーザーは「mode」パラメータで「countdown」(No.1までカウントダウン)または「timeline」(時系列の進化)を選択でき、各エントリに画像、タイトル、年、収益データ、評価、豆知識をアニメーションカードとして表示します。さらに、各エントリに予告編クリップを追加でき、フルスクリーンで再生され、下部にタイトルが表示されます。このビデオはWeb検索で収集したデータに基づいて自動構築され、`items.json`で定義したスキーマに従って、イントロ、ランクカード、アイテムカード、プログレストラッカー、アウトロで構成されます。対応プラットフォームはYouTubeなど、MP4をアップロードできるすべてのプラットフォームです。処理パイプラインは完全自動化(`make_countdown.sh`でビルド→レンダリング→オーディオ合成→MP4出力)されており、Playwrightとffmpegを使用します。コードはすべて英語で記述されていますが、画面テキストはユーザーの希望言語に翻訳可能です。

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

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

カウントダウンビデオ は何をしますか?

ランキングリストを、映画/リストチャンネル風の完成済みリストビデオに変換します。2つのモードがあります:

  • "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.pyitems.json → _work/build.html、timeline.json、cues.json(SFX)、chapters.txt;欠落/読み取り不能な画像をフラグ付け。
scripts/render.py決定論的フレーム範囲レンダラー(Playwright → x264)。
scripts/compose_clips.py各エントリの予告編クリップをフルフレーム(レターボックス)で配置し、下部に「TRAILER · タイトル(年)」を表示、クリップ音声を抽出します。make_countdown.shによって自動実行されます。
scripts/countdown_audio.pyオリジナルのアップビート音楽ループ(または--music your_track.mp3)、キューに合わせてウーッシュ/ヒット/ポップ/チックのSFX、予告編音声(音楽は--clip-music(デフォルト0.12)でダック)、オプションのランク音声。
scripts/make_countdown.shパイプライン全体:ビルド → パラレルレンダリング → オーディオ → MP4 + QAシート + チャプター。

セットアップ:pip install soundfile scipy pillow --break-system-packages と playwright install chromium(不足している場合)、ffmpegをPATHに追加。オプションの音声:Kokoro TTS(PPTアニメーションスキルのvoiceover.pyを参照)。

ワークフロー

  1. ブリーフィング。 トピック、モード(countdown または timeline)、エントリ数(N)、ランキング基準(例:全世界興行収入)、表示するフィールド、予告編クリップを含めるかどうか(および時間、デフォルト25秒)、ビデオ長(約5秒のイントロ + N ×(約11秒 + クリップ)+ 12秒のアウトロ)、音楽(ユーザーのトラックまたは生成)。ユーザーがいる場合は一度確認し、いない場合は適切なデフォルトを選択してその旨を伝えます。
  2. ランキングを調査する。 Web検索を使用し、ソースページを開きます。記憶から数値を埋めないでください。推奨ソース:Box Office Mojo / The Numbers(予算、全世界興行収入)、IMDb、Rotten Tomatoes、Metacritic(評価)、Wikipedia(年、ジャンル)。各アイテムのsourcesにURLを記録します。2つのソースが一致しない場合は、ランキング基準に1つのソースを一貫して使用し、その旨をメモします。値が見つからない場合はフィールドを省略します(カードが適応します)。決して値を発明しないでください。
  3. items.jsonを書く(以下のスキーマ)、ランク1~N(1がトップエントリ)。ビデオはNから1へカウントダウンします("order": "up"で逆転)。
  4. 画像とクリップ。 ユーザーが提供する画像と予告編ファイルを使用します(posters/<slug>.jpg、2:3縦長;clips/<slug>.mp4)。自分でWebからポスター、予告編、静止画、人物の写真をダウンロードしないでください。フォルダにドロップするようユーザーに依頼します。画像がない場合、カードはクリーンなタイトルプレースホルダーを表示し、クリップがない場合はスキップされるため、下書きを先にレンダリングできます。各クリップに対して、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. QA。 out_sheet.pngを開き、items.jsonと数値をスポットチェックし、再生時間を確認し、すべてのランクが1回ずつ出現することを確認します。
  8. 納品。 MP4、チャプター(out_chapters.txt。YouTubeの説明欄に貼り付け)、ソースリスト、推奨タイトル/説明/タグ。YouTube Studioでアウトロスロットにエンド画面要素を追加するようユーザーに伝えてください。

items.json スキーマ

以下の値は構造を示すプレースホルダーであり、実際のデータではありません。

{
  "title": "ストップモーション映画トップ5",
  "subtitle": "全世界興行収入ランキング",
  "channel": "チャンネル名",
  "currency": "$",
  "order": "down",
  "mode": "countdown",
  "intro_image": "logo.png",
  "outro_title": "あなたのお気に入りはどれ?",
  "outro_subtitle": "コメントで教えてください!",
  "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": "チキンラン", "year": 2000, "subtitle": "ファミリー/コメディ",
      "image": "posters/chicken-run.jpg",
      "stats": [{"label": "予算", "value": 45000000}, {"label": "興行収入", "value": 225100000}],
      "multiple": "予算の5倍",
      "ratings": {"imdb": 7.0, "rt": 90, "rt_audience": 75, "metacritic": 80},
      "fact": "短い、ソース付きの文。",
      "teaser": "No.Xスラムの下の任意の行",
      "clip": {"file": "clips/chicken-run-trailer.mp4", "start": "0:12", "duration": 25},
      "label": "スラムカードにNo.X/年の代わりに表示する任意テキスト",
      "seconds": 9,
      "sources": ["https://www.boxofficemojo.com/title/tt0120630/"]
    }
  ]
}
  • stats[].value が数値の場合→アニメーションカウントアップ+比較棒グラフ(棒はカードごとに同じスケールを共有);文字列の場合→そのまま表示(例:"N/A"、"8,848 м")。任意のラベルが機能するため、同じエンジンで映画以外のカウントダウン(最も高い建物、最も裕福な人、最速の車)にも対応します。
  • ratings キーはオプション:imdb(0–10、星)、rt / rt_audience / metacritic(0–100、リング)。欠落したキーは非表示になり;評価がないカードは他のボックスを中央に配置します。
  • clip.start は秒数または m:ss を受け入れ、クリップは16:9にレターボックス化され、カードの後に再生されます。チャプターとエンド画面のタイミングはクリップ長を自動的に考慮します。
  • intro_image(例:ユーザーが提供するスタジオロゴ)は、イントロの TOP N / EVOLUTION バッジを置き換えます。
  • タイムラインモードではエントリは year でソートされ、カードのランクバッジは非表示になり、チャプターは「タイトル(年)」と表示されます。
  • multiple はマネーボックスの下の短いハイライトピルです。ソースの数値から計算し(小数点1桁に丸める)。
  • 評価はテキストラベルのみで表示され、ブランドロゴはありません。
  • 画面に表示される評価、数値、豆知識はすべて sources 内のソースに由来している必要があります。

スタイルノート

  • デフォルトのテーマはクラシックなリストチャンネルと一致:緑/黄色のクレヨンテクスチャカード、赤い枠、オレンジの「No.X」スラム(光線付き)、紫のマネーボックス、青の評価ボックス。theme で任意の色を上書きできます。
  • 360pでの読みやすさ:タイトルは短く保ち(サブタイトルがジャンルを伝える)、豆知識は2行以内に、統計は4つまでにします。
  • 視聴維持:エントリあたり約11秒。最も強いエントリは最後に配置。ランクスラム+ウーッシュ/ヒットSFXが各エントリで視聴者の注意をリセット。イントロは5秒以内に。
  • YouTubeチャプターはそれぞれ10秒以上必要なので、イントロは自動的に最初のランクのチャプターに折り込まれます。

関連スキル