youtube-summarizer
Selective Reading Rule
まずは以下を確認してください:
references/senior-master-standard.mdreferences/usage-routing.mdreferences/quality-checklist.md
その後、ユーザーの実際のタスクに合致する継承ドキュメント、スクリプト、アセット、または例のみを読み込んでください。
目的
このスキルは、YouTube 動画から文字起こし(トランスクリプト)を抽出し、STAR + R-I-S-E フレームワークを使用して包括的で詳細な要約を生成します。動画の可用性を検証し、youtube-transcript-api Python ライブラリを使用して文字起こしを抽出し、すべての洞察、議論、重要なポイントを捉えた詳細なドキュメントを作成します。
このスキルは、教育動画、講義、チュートリアル、または情報提供コンテンツから徹底的なコンテンツ分析と参照ドキュメントを必要とするユーザー向けに設計されています。
このスキルを使用するタイミング
このスキルは以下の場合に使用してください:
- ユーザーが YouTube 動画の URL を提供し、詳細な要約を希望する場合
- ユーザーが再視聴せずに動画コンテンツを参照ドキュメント化したい場合
- ユーザーが教育コンテンツから洞察、主要ポイント、議論を抽出したい場合
- ユーザーが分析のために YouTube 動画から文字起こしを必要とする場合
- ユーザーが YouTube 動画の「要約」「まとめ」「内容抽出」を依頼した場合
- ユーザーが簡潔さよりも完全性を優先した包括的なドキュメントを希望する場合
Step 0: 発見とセットアップ
動画を処理する前に、環境と依存関係を検証してください:
# Check if youtube-transcript-api is installed
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
echo "⚠️ youtube-transcript-api not found"
# Offer to install
fi
# Check Python availability
if ! command -v python3 &>/dev/null; then
echo "❌ Python 3 is required but not installed"
exit 1
fi
依存関係がない場合、ユーザーに確認します:
youtube-transcript-api が必要ですが、インストールされていません。
今すぐインストールしますか?
- [ ] はい - pip でインストール (pip install youtube-transcript-api)
- [ ] いいえ - 手動でインストールします
ユーザーが「はい」を選択した場合:
pip install youtube-transcript-api
インストールを確認:
python3 -c "import youtube_transcript_api; print('✅ youtube-transcript-api installed successfully')"
メインワークフロー
進捗状況の表示ガイドライン
ワークフロー全体を通じて、各ステップの前に視覚的な進捗ゲージを表示し、ユーザーに情報を提供し続けてください。ゲージの形式は以下のとおりです:
echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5: Validating URL"
フォーマット仕様:
- 20文字幅(塗りつぶしは █、空は ░)
- パーセンテージ増分:Step 1=20%、Step 2=40%、Step 3=60%、Step 4=80%、Step 5=100%
- 現在/合計を示すステップカウンター(例:「Step 3/5」)
- 現在のフェーズの簡単な説明
Step 1 の前に初期ステータスボックスを表示:
╔══════════════════════════════════════════════════════════════╗
║ 📹 YOUTUBE SUMMARIZER - Processing Video ║
╠══════════════════════════════════════════════════════════════╣
║ → Step 1: Validating URL [IN PROGRESS] ║
║ ○ Step 2: Checking Availability ║
║ ○ Step 3: Extracting Transcript ║
║ ○ Step 4: Generating Summary ║
║ ○ Step 5: Formatting Output ║
╠══════════════════════════════════════════════════════════════╣
║ Progress: ██████░░░░░░░░░░░░░░░░░░░░░░░░ 20% ║
╚══════════════════════════════════════════════════════════════╝
Step 1: YouTube URL の検証
目的: 動画 ID を抽出し、URL 形式を検証します。
対応 URL 形式:
https://www.youtube.com/watch?v=VIDEO_IDhttps://youtube.com/watch?v=VIDEO_IDhttps://youtu.be/VIDEO_IDhttps://m.youtube.com/watch?v=VIDEO_ID
アクション:
# Extract video ID using regex or URL parsing
URL="$USER_PROVIDED_URL"
# Pattern 1: youtube.com/watch?v=VIDEO_ID
if echo "$URL" | grep -qE 'youtube\.com/watch\?v='; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*[?&]v=([^&]+).*/\1/')
# Pattern 2: youtu.be/VIDEO_ID
elif echo "$URL" | grep -qE 'youtu\.be/'; then
VIDEO_ID=$(echo "$URL" | sed -E 's/.*youtu\.be\/([^?]+).*/\1/')
else
echo "❌ Invalid YouTube URL format"
exit 1
fi
echo "📹 Video ID extracted: $VIDEO_ID"
URL が無効な場合:
❌ Invalid YouTube URL
有効な YouTube URL を以下のいずれかの形式で入力してください:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
例:https://www.youtube.com/watch?v=dQw4w9WgXcQ
Step 2: 動画と文字起こしの可用性確認
進捗状況:
echo "[████████░░░░░░░░░░░░] 40% - Step 2/5: Checking Availability"
目的: 動画が存在し、文字起こしにアクセス可能であることを確認します。
アクション:
from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys
video_id = sys.argv[1]
try:
# Get list of available transcripts
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print(f"✅ Video accessible: {video_id}")
print("📝 Available transcripts:")
for transcript in transcript_list:
print(f" - {transcript.language} ({transcript.language_code})")
if transcript.is_generated:
print(" [Auto-generated]")
except TranscriptsDisabled:
print(f"❌ Transcripts are disabled for video {video_id}")
sys.exit(1)
except NoTranscriptFound:
print(f"❌ No transcript found for video {video_id}")
sys.exit(1)
except Exception as e:
print(f"❌ Error accessing video: {e}")
sys.exit(1)
エラーハンドリング:
| エラー | メッセージ | アクション |
|---|---|---|
| 動画が見つからない | "❌ Video does not exist or is private" | ユーザーに URL の確認を依頼 |
| 文字起こしが無効 | "❌ Transcripts are disabled for this video" | 処理を続行不可 |
| 文字起こしがない | "❌ No transcript found (not auto-generated or manually added)" | 処理を続行不可 |
| プライベート/制限付き動画 | "❌ Video is private or restricted" | 公開動画を依頼 |
Step 3: 文字起こしの抽出
進捗状況:
echo "[████████████░░░░░░░░] 60% - Step 3/5: Extracting Transcript"
目的: ユーザーの希望する言語で文字起こしを取得します。
アクション:
from youtube_transcript_api import YouTubeTranscriptApi
video_id = "VIDEO_ID"
try:
# Try to get transcript in user's preferred language first
# Fall back to English if not available
transcript = YouTubeTranscriptApi.get_transcript(
video_id,
languages=['pt', 'en'] # Prefer Portuguese, fallback to English
)
# Combine transcript segments into full text
full_text = " ".join([entry['text'] for entry in transcript])
# Get video metadata
from youtube_transcript_api import YouTubeTranscriptApi
transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
print("✅ Transcript extracted successfully")
print(f"📊 Transcript length: {len(full_text)} characters")
# Save to temporary file for processing
with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
f.write(full_text)
except Exception as e:
print(f"❌ Error extracting transcript: {e}")
exit(1)
文字起こしの処理:
- すべての文字起こしセグメントを統合し、一貫性のあるテキストにする
- 利用可能な場合は句読点と書式を保持
- 重複または重なり合うセグメントがある場合は削除(自動生成のアーティファクトの場合)
- 分析のために一時ファイルに保存
Step 4: 包括的な要約の生成
進捗状況:
echo "[████████████████░░░░] 80% - Step 4/5: Generating Summary"
目的: 拡張された STAR + R-I-S-E プロンプトを適用し、詳細な要約を作成します。
適用するプロンプト:
抽出された文字起こしを入力として、Phase 2(STAR + R-I-S-E フレームワーク)の拡張プロンプトを使用します。
アクション:
- 完全な文字起こしテキストを読み込む
- 包括的な要約プロンプトを適用する
- AI モデル(Claude/GPT)を使用して構造化された要約を生成する
- 出力が定義された構造に従っていることを確認する:
- 動画メタデータを含むヘッダー
- エグゼクティブサマリー
- セクションごとの詳細な内訳
- 主要な洞察と結論
- 概念と用語
- リソースと参照
実装:
# Use the transcript file as input to the AI prompt
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"
# The AI agent will:
# 1. Read the transcript
# 2. Apply the STAR + R-I-S-E summarization framework
# 3. Generate comprehensive Markdown output
# 4. Structure with headers, lists, and highlights
Read "$TRANSCRIPT_FILE" # Read transcript into context
その後、完全な要約プロンプト(Phase 2 の拡張バージョン)を適用します。
Step 5: 出力のフォーマットと表示
進捗状況:
echo "[████████████████████] 100% - Step 5/5: Formatting Output"
目的: クリーンで構造化されたマークダウンで要約を提供します。
出力構造:
# [Video Title]
**チャンネル:** [Channel Name]
**長さ:** [Duration]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**公開日:** [Date if available]
## 📝 詳細な要約
### [トピック 1]
[例、データ、引用などを含む包括的な説明...]
#### [サブトピック 1.1]
[詳細な内訳...]
### [トピック 2]
[詳細な分析の続き...]
## 📚 概念と用語
- **[用語 1]:** [定義とコンテキスト]
- **[用語 2]:** [定義とコンテキスト]
## 📌 結論
[最終的な統合とポイント]
### **例 2: 依存関係が見つからない場合**
**ユーザー入力:**
claude> summarize this youtube video https://youtu.be/abc123
**スキルの応答:**
⚠️ youtube-transcript-api not installed
このスキルには Python ライブラリ 'youtube-transcript-api' が必要です。
今すぐインストールしますか?
- はい - pip でインストール
- いいえ - 手動でインストールします
**ユーザーが「はい」を選択:**
```bash
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1
✅ Installation complete! Proceeding with video summary...
例 4: 無効な URL
ユーザー入力:
claude> summarize youtube video www.youtube.com/some-video
スキルの応答:
❌ Invalid YouTube URL format
期待される形式の例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID
有効な YouTube 動画の URL を入力してください。
📊 エグゼクティブサマリー
この動画は、人工知能(AI)の基本的な概念について、初心者からプロフェッショナルまでを対象に、現代の AI の技術的基盤と実用的なアプリケーションを理解するための包括的な入門を提供します。インストラクターは、基本的な定義から機械学習アルゴリズムまで、実用的な例と視覚化を使用して理解を促進します。
[... 続く詳細な要約 ...]
**保存オプション:**
何を保存しますか? → 要約 + 生の文字起こし
✅ File saved: resumo-exemplo123-2026-02-01.md (includes raw transcript) [████████████████████] 100% - ✓ Processing complete!
機械学習の基礎に関するこの包括的なチュートリアルへようこそ。今日の動画では、現代の AI システムを支える中核的な概念を探求します...
バージョン: 1.2.0 最終更新日: 2026-02-02 メンテナー: Eric Andrade
制限事項
- このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
- 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
- 必要な入力、権限、安全境界、成功基準が欠けている場合は、停止して明確化を求めてください。