video-summarizer

動画要約ツール

Gemini API を使用してディレクトリ内の MP4 ファイルを分析し、各動画と同じ場所に .md 要約ファイルを作成します。

前提条件

• GEMINI_API_KEY 環境変数が設定されていること
• google-genai がインストールされていること：py -m pip install google-genai
• Python を py（Windows）または python3 として実行できること

ワークフロー

1. プロンプトを決定する

ユーザーがカスタムプロンプトや特定の抽出指示を指定しているか確認します。

• カスタムプロンプトがない場合 → デフォルトを使用します（タイトル、要約、重要なポイント、要点を含む構造化された要約）
• ユーザーがカスタム指示を指定した場合 → --prompt または --prompt-file で渡します

カスタムプロンプトを指定すると、デフォルトの内容は完全に置き換えられます。カスタムプロンプトの例：

• 「言及されているすべてのツールと、その価格、各ツールの一行説明を抽出する」
• 「この動画で言及されているすべてのアクション項目と期限を一覧にする」
• 「タイムスタンプ付きの文字起こしアウトラインを作成する」

2. スクリプトを実行する

# Default summary — all videos in current directory (recursive)
py scripts/summarize_videos.py

# Default summary — specific directory
py scripts/summarize_videos.py "C:/path/to/videos"

# Custom prompt (inline) — replaces default summary format
py scripts/summarize_videos.py --prompt "Extract all product names and prices mentioned"

# Custom prompt (from file) — replaces default summary format
py scripts/summarize_videos.py --prompt-file my-prompt.txt

# Both directory and custom prompt
py scripts/summarize_videos.py "C:/path/to/videos" --prompt "List all key decisions made"

3. Claude がユーザーの引数を処理する方法

ユーザーがこのスキルを呼び出した場合：

1. ユーザーがカスタムプロンプトや抽出の目的（例：「言及されているすべてのツールを抽出する」、 「価格に重点を置いて要約する」、「アクション項目を一覧にする」）を指定した場合は、--prompt "..." で渡します。
2. ユーザーがプロンプトファイルのパスを指定した場合は、--prompt-file path/to/file.txt で渡します。
3. ユーザーが具体的な指示を指定していない場合は、デフォルトの形式を使用するため、--prompt を指定せずに実行します。
4. ユーザーがディレクトリを指定した場合は、最初の位置引数として渡します。

4. デフォルトの出力形式（カスタムプロンプトが指定されていない場合）

# [Video Title]

## Summary
[2-3 sentence description]

## Key Points
- point 1
- point 2
- ...

## Core Content & Takeaways
[Central message and key insight]

---
*Auto-generated with Gemini API*

注意事項

• 要約の言語は動画の言語と一致します
• 処理後、ファイルは Gemini ストレージから自動的に削除されます（48 時間の制限）
• すでに要約済みの動画は、再実行時にスキップされます
• スクリプトのパス：scripts/summarize_videos.py
• モデル：gemini-3-flash-preview