Communitygithub.com

BEKO2210/Firstbrain

YouTube動画からトランスクリプトを抽出し、インテリジェントな分析フレームワークを使用して詳細な要約を生成します。

Firstbrain とは?

このスキル(BEKO2210/Firstbrain)は、YouTube動画のトランスクリプト(文字起こし)を抽出し、STAR + R-I-S-Eフレームワークを用いて、詳細かつ網羅的な要約を自動生成します。動画のURLを検証し、公開状態やトランスクリプトの有無を確認した上で、`youtube-transcript-api`ライブラリを使って字幕データを取得。その後、高度なプロンプト処理により、教育、チュートリアル、講義などのコンテンツから重要な知見やキーポイントを漏れなく抽出し、構造化されたマークダウン文書として出力します。Claude CodeやCursorなどのAIエージェント環境で動作し、ユーザーが動画を再視聴することなく、内容を完全に文書化・参照できるようにします。進行状況は視覚的なプログレスバーで表示され、エラー時にはわかりやすいメッセージと対処法を提案します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BEKO2210/Firstbrain/tree/HEAD/03%20-%20Resources/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% - ステップ 1/5: URLの検証"

形式の仕様:

  • 20文字幅(完了部分は █、未完了部分は ░)
  • パーセンテージ増加: ステップ1=20%, ステップ2=40%, ステップ3=60%, ステップ4=80%, ステップ5=100%
  • 現在/全体のステップ数を表示(例: "ステップ 3/5")
  • 現在のフェーズの簡単な説明

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

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

ステップ 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

ステップ 2: 動画とトランスクリプトの利用可能性を確認

進捗状況:

echo "[████████░░░░░░░░░░░░] 40% - ステップ 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の確認を依頼
トランスクリプトが無効"❌ この動画ではトランスクリプトが無効になっています"処理を続行できません
トランスクリプトがない"❌ トランスクリプトが見つかりません(自動生成も手動追加もありません)"処理を続行できません
プライベート/制限付き動画"❌ 動画はプライベートまたは制限付きです"公開動画を依頼

ステップ 3: トランスクリプトの抽出

進捗状況:

echo "[████████████░░░░░░░░] 60% - ステップ 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)

トランスクリプトの処理:

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

ステップ 4: 包括的な要約の生成

進捗状況:

echo "[████████████████░░░░] 80% - ステップ 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の拡張版)を適用します。

ステップ 5: 出力のフォーマットと表示

進捗状況:

echo "[████████████████████] 100% - ステップ 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)の基本概念を初心者および専門家向けに包括的に紹介しており、実用的な例と可視化を使用して理解を促進しながら、基本的な定義から機械学習アルゴリズムまでをカバーしています。

[... 詳細な要約が続きます ...]


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

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

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



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

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

接続

  • ドメイン: [[Design & Kreativitaet]]
  • カテゴリ: [[Video & Audio Produktion]]
  • ファイル:
    • scripts/extract-transcript.py
    • scripts/install-dependencies.sh
  • ナビゲーション: [[Skills Uebersicht]], [[Home]]

Individual skills in this repo

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Expert in building portfolios that actually land jobs and clients -

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Best practices for Remotion - Video creation in React

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

Writes complete, structured landing pages optimized for SEO ranking, AEO citation, and visitor conversion. Activate when the user wants to write or generate a landing page for a product, service, or offer.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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.

BEKO2210/Firstbrain

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

BEKO2210/Firstbrain

One sentence - what this skill does and when to invoke it

BEKO2210/Firstbrain

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.

関連スキル