Communitygithub.com

youtube-summarizer / YouTube サマライザー

YouTube 動画からトランスクリプトを抽出し、STAR + R-I-S-E フレームワークを用いて詳細な要約を生成します。

YouTube サマライザー とは?

このスキルは YouTube 動画の URL を受け取り、`youtube-transcript-api` ライブラリを使ってトランスクリプトを抽出し、STAR (Situation, Task, Action, Result) と R-I-S-E (Reflection, Insight, Summary, Evaluation) の複合フレームワークを適用して徹底的で構造化された要約を生成します。主に教育用動画、講義、チュートリアル、情報コンテンツの分析に最適で、ユーザーは動画を再視聴することなく主要なポイント、概念、背景を把握できます。対応プラットフォームは Claude Code・Cursor・Codex などの AI エージェント環境を想定しており、スキルは Python の依存関係チェックから開始し、URL 検証、動画・トランスクリプトの可用性確認、トランスクリプト抽出、要約生成、Markdown 形式による出力の 5 ステップで進みます。出力は動画メタデータを含むヘッダー、エグゼクティブサマリー、セクションごとの詳細分析、重要用語集、結論から構成され、必要に応じて生のトランスクリプトも保存可能です。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Desesbraker/agentes-vip/tree/HEAD/full%20skill/plugins/antigravity-awesome-skills-claude/skills/youtube-summarizer

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

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

ドキュメント

youtube-summarizer

目的

このスキルは YouTube 動画からトランスクリプトを抽出し、STAR + R-I-S-E フレームワークを用いて包括的で冗長な要約を生成します。動画の可用性を検証し、youtube-transcript-api Python ライブラリを使用してトランスクリプトを抽出し、すべての洞察、議論、キーポイントを捉えた詳細なドキュメントを生成します。

このスキルは、教育用動画、講義、チュートリアル、情報コンテンツから徹底的なコンテンツ分析とリファレンスドキュメントを必要とするユーザー向けに設計されています。

使用すべきタイミング

このスキルは以下の場合に使用します:

  • ユーザーが YouTube 動画の URL を提供し、詳細な要約を希望する場合
  • 動画を再視聴せずにコンテンツをリファレンスとして文書化する必要がある場合
  • 教育コンテンツから洞察、キーポイント、議論を抽出したい場合
  • 分析のために YouTube 動画のトランスクリプトが必要な場合
  • ユーザーが YouTube 動画の「要約」「まとめ」「内容抽出」を依頼した場合
  • 簡潔さよりも完全性を優先する包括的なドキュメントが必要な場合

ステップ 0: 環境確認とセットアップ

動画を処理する前に、環境と依存関係を検証します:

# youtube-transcript-api がインストールされているか確認
python3 -c "import youtube_transcript_api" 2>/dev/null
if [ $? -ne 0 ]; then
    echo "⚠️  youtube-transcript-api が見つかりません"
    # インストールを提案
fi

# Python の可用性を確認
if ! command -v python3 &>/dev/null; then
    echo "❌ Python 3 が必要ですがインストールされていません"
    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 のインストールに成功しました')"

メインワークフロー

進捗表示のガイドライン

ワークフロー全体を通じて、各ステップの前に視覚的な進捗ゲージを表示し、ユーザーに情報を提供します。ゲージのフォーマットは次の通りです:

echo "[████░░░░░░░░░░░░░░░░] 20% - Step 1/5:  URL を検証中"

フォーマット仕様:

  • 20 文字幅(完了部分は █、未完了部分は ░ を使用)
  • パーセンテージの増分:Step 1=20%、Step 2=40%、Step 3=60%、Step 4=80%、Step 5=100%
  • 現在/全体のステップカウンター(例:「Step 3/5」)
  • 現在のフェーズの簡単な説明

Step 1 の前に初期ステータスボックスを表示:

╔══════════════════════════════════════════════════════════════╗
║     📹  YouTube サマライザー - 動画を処理中                 ║
╠══════════════════════════════════════════════════════════════╣
║ → Step 1: URL を検証                        [処理中]        ║
║ ○ Step 2: 可用性を確認                                      ║
║ ○ Step 3: トランスクリプトを抽出                            ║
║ ○ Step 4: 要約を生成                                        ║
║ ○ Step 5: 出力をフォーマット                                ║
╠══════════════════════════════════════════════════════════════╣
║ 進捗: ██████░░░░░░░░░░░░░░░░░░░░░░░░  20%                  ║
╚══════════════════════════════════════════════════════════════╝

Step 1: YouTube URL を検証

目的: 動画 ID を抽出し、URL の形式を検証します。

対応 URL 形式:

  • https://www.youtube.com/watch?v=VIDEO_ID
  • https://youtube.com/watch?v=VIDEO_ID
  • https://youtu.be/VIDEO_ID
  • https://m.youtube.com/watch?v=VIDEO_ID

アクション:

# 正規表現または URL 解析を使用して動画 ID を抽出
URL="$USER_PROVIDED_URL"

# パターン 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/')
# パターン 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 "❌ 無効な YouTube URL 形式です"
    exit 1
fi

echo "📹 動画 ID を抽出しました: $VIDEO_ID"

URL が無効な場合:

❌ 無効な 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: 可用性を確認中"

目的: 動画が存在し、トランスクリプトが利用可能であることを確認します。

アクション:

from youtube_transcript_api import YouTubeTranscriptApi, TranscriptsDisabled, NoTranscriptFound
import sys

video_id = sys.argv[1]

try:
    # 利用可能なトランスクリプトのリストを取得
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print(f"✅ 動画にアクセス可能: {video_id}")
    print("📝 利用可能なトランスクリプト:")
    
    for transcript in transcript_list:
        print(f"  - {transcript.language} ({transcript.language_code})")
        if transcript.is_generated:
            print("    [自動生成]")
    
except TranscriptsDisabled:
    print(f"❌ 動画 {video_id} ではトランスクリプトが無効になっています")
    sys.exit(1)
    
except NoTranscriptFound:
    print(f"❌ 動画 {video_id} のトランスクリプトが見つかりません")
    sys.exit(1)
    
except Exception as e:
    print(f"❌ 動画へのアクセス中にエラーが発生しました: {e}")
    sys.exit(1)

エラーハンドリング:

エラーメッセージアクション
動画が見つからない"❌ 動画が存在しないか、非公開です"URL の確認をユーザーに依頼
トランスクリプトが無効"❌ この動画ではトランスクリプトが無効です"処理を続行不可
トランスクリプトが利用できない"❌ トランスクリプトが見つかりません(自動生成または手動追加されていません)"処理を続行不可
プライベート/制限付き動画"❌ 動画は非公開または制限されています"公開動画を依頼

Step 3: トランスクリプトを抽出

進捗:

echo "[████████████░░░░░░░░] 60% - Step 3/5: トランスクリプトを抽出中"

目的: 優先言語でトランスクリプトを取得します。

アクション:

from youtube_transcript_api import YouTubeTranscriptApi

video_id = "VIDEO_ID"

try:
    # まずユーザーの優先言語でトランスクリプトを取得
    # 利用できない場合は英語にフォールバック
    transcript = YouTubeTranscriptApi.get_transcript(
        video_id, 
        languages=['pt', 'en']  # ポルトガル語を優先、英語にフォールバック
    )
    
    # トランスクリプトセグメントを結合して完全なテキストに
    full_text = " ".join([entry['text'] for entry in transcript])
    
    # 動画のメタデータを取得
    from youtube_transcript_api import YouTubeTranscriptApi
    transcript_list = YouTubeTranscriptApi.list_transcripts(video_id)
    
    print("✅ トランスクリプトの抽出に成功しました")
    print(f"📊 トランスクリプトの長さ: {len(full_text)} 文字")
    
    # 処理用に一時ファイルに保存
    with open(f"/tmp/transcript_{video_id}.txt", "w") as f:
        f.write(full_text)
    
except Exception as e:
    print(f"❌ トランスクリプトの抽出中にエラーが発生しました: {e}")
    exit(1)

トランスクリプト処理:

  • すべてのトランスクリプトセグメントを結合して一貫したテキストにする
  • 利用可能な場合は句読点とフォーマットを保持する
  • 重複または重複するセグメントを削除する(自動生成のアーティファクトがある場合)
  • 分析のために一時ファイルに保存する

Step 4: 包括的な要約を生成

進捗:

echo "[████████████████░░░░] 80% - Step 4/5: 要約を生成中"

目的: 拡張された STAR + R-I-S-E プロンプトを適用して詳細な要約を作成します。

適用するプロンプト:

フェーズ 2 の拡張プロンプト(STAR + R-I-S-E フレームワーク)を抽出したトランスクリプトを入力として使用します。

アクション:

  1. 完全なトランスクリプトテキストを読み込む
  2. 包括的な要約プロンプトを適用する
  3. AI モデル(Claude/GPT)を使用して構造化された要約を生成する
  4. 出力が定義された構造に従っていることを確認する:
    • 動画メタデータを含むヘッダー
    • エグゼクティブサマリー
    • セクションごとの詳細な内訳
    • 重要な洞察と結論
    • 概念と用語
    • リソースと参考文献

実装:

# トランスクリプトファイルを AI プロンプトへの入力として使用
TRANSCRIPT_FILE="/tmp/transcript_${VIDEO_ID}.txt"

# AI エージェントは以下の処理を行います:
# 1. トランスクリプトを読み込む
# 2. STAR + R-I-S-E 要約フレームワークを適用する
# 3. 包括的な Markdown 出力を生成する
# 4. ヘッダー、リスト、ハイライトで構造化する

Read "$TRANSCRIPT_FILE"  # トランスクリプトをコンテキストに読み込む

次に、完全な要約プロンプト(フェーズ 2 の拡張バージョン)を適用します。

Step 5: 出力をフォーマットして提示

進捗:

echo "[████████████████████] 100% - Step 5/5: 出力をフォーマット中"

目的: 要約をクリーンで構造化された Markdown で提供します。

出力構造:

# [動画タイトル]

**チャンネル:** [チャンネル名]
**長さ:** [再生時間]
**URL:** [https://youtube.com/watch?v=VIDEO_ID]
**公開日:** [日付(利用可能な場合)]


## 📝 詳細な要約

### [トピック 1]

[例、データ、引用などを含む包括的な説明...]

#### [サブトピック 1.1]

[詳細な内訳...]

### [トピック 2]

[続きの詳細な分析...]


## 📚 概念と用語

- **[用語 1]:** [定義とコンテキスト]
- **[用語 2]:** [定義とコンテキスト]


## 📌 結論

[最終的な統合とポイント]


### **例 2: 依存関係がない場合**

**ユーザー入力:**

claude> この YouTube 動画を要約してください https://youtu.be/abc123


**スキルの応答:**

⚠️ youtube-transcript-api がインストールされていません

このスキルには Python ライブラリ 'youtube-transcript-api' が必要です。

今すぐインストールしますか?

  • はい - pip でインストール
  • いいえ - 手動でインストールします

**ユーザーが「はい」を選択:**

```bash
$ pip install youtube-transcript-api
Successfully installed youtube-transcript-api-0.6.1

✅ インストール完了!動画の要約を続行します...

例 4: 無効な URL

ユーザー入力:

claude> youtube 動画を要約 www.youtube.com/some-video

スキルの応答:

❌ 無効な YouTube URL 形式です

期待される形式の例:
- https://www.youtube.com/watch?v=VIDEO_ID
- https://youtu.be/VIDEO_ID

有効な YouTube 動画の URL を入力してください。

📊 エグゼクティブサマリー

この動画は、最新の AI の技術的基礎と実用的応用を理解したい初心者や専門家向けに、人工知能(AI)の基本概念を包括的に紹介しています。インストラクターは基本的な定義から機械学習アルゴリズムまでをカバーし、理解を促進するために実践的な例と視覚化を使用しています。

[... 続きの詳細な要約 ...]


**保存オプション:**

何を保存しますか? → 要約 + 生のトランスクリプト

✅ ファイルを保存しました: resumo-exemplo123-2026-02-01.md(生のトランスクリプトを含む) [████████████████████] 100% - ✓ 処理が完了しました!



機械学習の基礎に関するこの包括的なチュートリアルへようこそ。今日の動画では、現代の AI システムを支える中核概念を探求します...

バージョン: 1.2.0 最終更新日: 2026-02-02 メンテナー: Eric Andrade

Individual skills in this repo

This repo contains 16 individual skills — each has its own dedicated page.

Desesbraker/agentes-vip

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Desesbraker/agentes-vip

Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Desesbraker/agentes-vip

Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects. Use when animations stutter, transitions jank, or reviewing CSS/JS animation performance.

Desesbraker/agentes-vip

Internationalization and localization patterns. Detecting hardcoded strings, managing translations, locale files, RTL support.

Desesbraker/agentes-vip

AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Desesbraker/agentes-vip

CRITICAL: Use for Makepad animation system. Triggers on: makepad animation, makepad animator, makepad hover, makepad state, makepad transition, "from: { all: Forward", makepad pressed, makepad 动画, makepad 状态, makepad 过渡, makepad 悬停效果

Desesbraker/agentes-vip

Best practices for Remotion - Video creation in React

Desesbraker/agentes-vip

Generate walkthrough videos from Stitch projects using Remotion with smooth transitions, zooming, and text overlays

Desesbraker/agentes-vip

Seek and analyze video content using Memories.ai Large Visual Memory Model for persistent video intelligence

Desesbraker/agentes-vip

Three.js animation - keyframe animation, skeletal animation, morph targets, animation mixing. Use when animating objects, playing GLTF animations, creating procedural motion, or blending animations.

Desesbraker/agentes-vip

Automate TikTok tasks via Rube MCP (Composio): upload/publish videos, post photos, manage content, and view user profiles/stats. Always search tools first for current schemas.

Desesbraker/agentes-vip

Video and audio perception, indexing, and editing. Ingest files/URLs/live streams, build visual/spoken indexes, search with timestamps, edit timelines, add overlays/subtitles, generate media, and create real-time alerts.

Desesbraker/agentes-vip

Upload, stream, search, edit, transcribe, and generate AI video and audio using the VideoDB SDK.

Desesbraker/agentes-vip

Automate YouTube tasks via Rube MCP (Composio): upload videos, manage playlists, search content, get analytics, and handle comments. Always search tools first for current schemas.

Desesbraker/agentes-vip

Generates high-converting Next.js/React landing pages with Tailwind CSS. Uses PAS, AIDA, and BAB frameworks for optimized copy/components (Heroes, Features, Pricing). Focuses on Core Web Vitals/SEO.

Desesbraker/agentes-vip

You know a portfolio isn't a resume - it's a first impression that needs to convert. You balance creativity with usability. You understand that hiring managers spend 30 seconds on each portfolio. You make those 30 seconds count. You help people stand out without being gimmicky.

関連スキル