mcpField
R
recreate-thumbnails

recreate-thumbnails

github.com/aiagentwithdhruvクリエイティブ・メディア2045 回インストール15 週間前に更新
リポジトリ

recreate-thumbnails について

recreate-thumbnails は、Your Name を使った YouTube サムネイルを作成するスキルです。顔の向きを分析して参考写真のポーズを照合し、複数の画像を生成してプロンプトで編集できます。

主な機能

  1. 01動画や画像からサムネイルを生成
  2. 02顔の向きを分析して参考写真と照合
  3. 03複数のサムネイル案を作成
  4. 04プロンプトによる生成画像の編集

活用シーン

  1. 01YouTube 動画用の顔差し替えサムネイル作成
  2. 02顔と参考写真のポーズのマッチング
  3. 03文字、色、背景の調整

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/aiagentwithdhruv/skills --skill recreate-thumbnails

インストール後、Claude Code で/recreate-thumbnailsを入力して読み込まれたか確認します。

同梱ファイルscripts/analyze_face_directions.pyscripts/recreate_thumbnails.py

詳細

YouTube サムネイルを再現する

目標

Gemini 画像モデルを使用して、YouTube サムネイルの顔を入れ替え、Your Name を登場させます。システムは顔の向きを分析し、ポーズに合った参照写真を照合して、複数のバリエーションを生成します。

スクリプト

  • ./scripts/recreate_thumbnails.py - メインの生成スクリプト
  • ./scripts/analyze_face_directions.py - 参照写真の分析スクリプト

クイックスタート

# From YouTube video (auto-downloads thumbnail)
python3 ./scripts/recreate_thumbnails.py --youtube "https://youtube.com/watch?v=VIDEO_ID"

# From local thumbnail
python3 ./scripts/recreate_thumbnails.py --source ".tmp/thumbnails/source.jpg"

# Edit pass on generated thumbnail
python3 ./scripts/recreate_thumbnails.py --edit ".tmp/thumbnails/recreated_v3.png" \
  --prompt "Change colors to teal. Change 'AI GOLD RUSH' to 'AGENTIC FLOWS'."

全体のワークフロー

ステップ 1：参照写真バンクを作成する（初回のみ）
# Drop 30-40 photos of Nick into raw folder
mkdir -p .tmp/reference_photos/raw

# Analyze and rename with face direction metadata
python3 ./scripts/analyze_face_directions.py

次のようなファイルが作成されます：

  • nick_yawL30_pitchU10.jpg — 左を30°、上を10°向いている
  • nick_yawR45_pitch0.jpg — 右を45°向いている、水平
ステップ 2：サムネイルを生成する
# From YouTube URL (analyzes face, finds best reference, generates 3 variations)
python3 ./scripts/recreate_thumbnails.py --youtube "VIDEO_URL"

# Custom variation count
python3 ./scripts/recreate_thumbnails.py --source "thumbnail.jpg" -n 5

# Skip direction matching
python3 ./scripts/recreate_thumbnails.py --source "thumbnail.jpg" --no-match
ステップ 3：編集して仕上げる
# Single edit
python3 ./scripts/recreate_thumbnails.py --edit ".tmp/thumbnails/recreated_v3.png" \
  --prompt "Change colors to teal brand colors."

# Chain multiple edits
python3 ./scripts/recreate_thumbnails.py --edit ".tmp/thumbnails/edited_1.png" \
  --prompt "Make text bigger. Change background to white."

CLI リファレンス

フラグ説明
--youtube, -yYouTube 動画の URL
--source, -s元のサムネイルのパスまたは URL
--edit, -e編集する画像（編集モードを有効化）
--prompt, -p編集モードで必要な編集指示
--variations, -nバリエーション数（デフォルト：3）
--refs参照写真の数（デフォルト：2）
--no-match顔の向きの照合をスキップ

出力の整理

.tmp/thumbnails/
├── 20251205/              # Date folder
│   ├── 104016_1.png       # Variation 1
│   ├── 104016_2.png       # Variation 2
│   ├── 104016_3.png       # Variation 3
│   └── 104532_edited.png  # Edit pass

API の詳細

  • モデル： gemini-3-pro-image-preview（Nano Banana Pro）
  • コスト： 生成または編集1回あたり約$0.14～0.24
  • レイテンシ： 画像1枚あたり10～60秒以上
  • 出力： 約1376x768（16:9に近い）

わかったこと

  • 参照写真は2枚が最適です（1枚では類似性が失われ、3枚以上では再生成が発生します）
  • プロンプトで16:9形式を明示的に指定する必要があります
  • プロンプト内で画像にラベルを付けます：「IMAGE 1: Reference, IMAGE 2: Thumbnail」
  • 「顔以外は100%完全に複製する」という指示が効果的です
  • 編集の工程は、テキスト、色、グラフ、背景に有効です

環境

NANO_BANANA_API_KEY=your_key

スキーマ

入力
名前型必須説明
youtube_urlstringいいえYouTube 動画の URL（サムネイルを自動ダウンロード）
sourcefile_pathいいえ元のサムネイル画像のパス
variationsintegerいいえバリエーション数（デフォルト：3）
edit_imagefile_pathいいえ編集する画像（編集モードを有効化）
promptstringいいえ編集モード用の編集指示
出力
名前型説明
thumbnailsarray生成されたサムネイルのファイルパス（.tmp/thumbnails/内）
認証情報
名前ソース
NANO_BANANA_API_KEY.env
組み合わせ可能なツール

このツールと連携しやすいスキル：cross-niche-outliers、youtube-outliers

コスト

生成1回あたり$0.14～0.24

コメント

Markdown 対応