Communitygithub.com

youtube-summarizer

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

youtube-summarizer とは?

このスキルは、YouTube動画の文字起こしを抽出し、STAR + R-I-S-E フレームワークを用いて包括的で詳細な要約を生成します。動画の可用性を検証し、`youtube-transcript-api` Pythonライブラリを使用して文字起こしを抽出し、すべての洞察、議論、重要なポイントを捉えた詳細なドキュメントを生成します。教育用動画、講義、チュートリアル、または情報コンテンツから徹底的なコンテンツ分析と参照ドキュメントを必要とするユーザー向けに設計されています。主な機能は、URL検証、文字起こしの抽出、構造化された要約の生成、そして見やすいマークダウン形式での出力です。進捗状況を視覚的に表示するプログレスバーを備え、依存関係のチェックと不足時のインストール案内も行います。ClaudeやGPTなどのAIモデルと連携し、YouTube動画の内容を効率的に理解・文書化したい開発者やリサーチャーにとって強力なツールです。

対応✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/sickn33/youtube-summarizer

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

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

ドキュメント

youtube-summarizer は何をしますか?

目的

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

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

このスキルを使用するタイミング

このスキルは以下の場合に使用してください。

  • ユーザーがYouTube動画のURLを提供し、詳細な要約を希望する場合
  • ユーザーが動画を再視聴することなく、動画コンテンツを参照用に文書化したい場合
  • ユーザーが教育コンテンツから洞察、重要なポイント、議論を抽出したい場合
  • ユーザーが分析のためにYouTube動画の文字起こしを必要とする場合
  • ユーザーがYouTube動画の「要約」、「まとめ」、または「コンテンツ抽出」を依頼した場合
  • 簡潔さよりも完全性を優先した包括的なドキュメントをユーザーが希望する場合

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

ステップ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%               ║
╚══════════════════════════════════════════════════════════════╝

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

アクション:

# 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

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

ステップ 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"公開動画を依頼

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

文字起こし処理:

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

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

進捗状況:

echo "[████████████████░░░░] 80% - Step 4/5: Generating Summary"

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

適用するプロンプト:

フェーズ2(STAR + R-I-S-Eフレームワーク)の拡張プロンプトを入力として抽出された文字起こしとともに使用します。

アクション:

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

実装:

# 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

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

ステップ 5: 出力をフォーマットして提示

進捗状況:

echo "[████████████████████] 100% - Step 5/5: Formatting Output"

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

出力構造:

# [Video Title]

**Canal:** [Channel Name]  
**Duração:** [Duration]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**Data de Publicação:** [Date if available]


## 📝 Detailed Summary

### [Topic 1]

[Comprehensive explanation with examples, data, quotes...]

#### [Subtopic 1.1]

[Detailed breakdown...]

### [Topic 2]

[Continued detailed analysis...]


## 📚 Concepts and Terminology

- **[Term 1]:** [Definition and context]
- **[Term 2]:** [Definition and context]


## 📌 Conclusion

[Final synthesis and takeaways]

例2: 依存関係の欠如

ユーザー入力:

claude> summarize this youtube video https://youtu.be/abc123

スキルの応答:

⚠️  youtube-transcript-api not installed

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

今すぐインストールしますか?
- [ ] はい - pipでインストール
- [ ] いいえ - 手動でインストールします

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

$ 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の技術的基礎と実用的応用を理解したい初心者や専門家向けに設計されています。講師は、基本的な定義から機械学習アルゴリズムまで、実際の例と視覚化を使用して理解を促進します。

[... 詳細な要約が続く ...]

📚 Concepts and Terminology

  • [Term 1]: [Definition and context]
  • [Term 2]: [Definition and context]

保存オプション

何を保存しますか?
→ 要約 + 生の文字起こし

✅ File saved: resumo-exemplo123-2026-02-01.md (includes raw transcript)
[████████████████████] 100% - ✓ Processing complete!

Examples

Example 1: Successful Summary

User Input:

claude> summarize this video https://www.youtube.com/watch?v=dQw4w9WgXcQ

Skill Flow:

  1. Validates URL ✓
  2. Checks availability ✓
  3. Extracts transcript ✓
  4. Generates summary ✓
  5. Displays formatted output with save options

Output:

Welcome to this comprehensive tutorial on machine learning fundamentals. In today's video, we'll explore the core concepts that power modern AI systems...


**Version:** 1.2.0
**Last Updated:** 2026-02-02
**Maintained By:** Eric Andrade

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

関連スキル