Communitygithub.com

ASoudy/AGS

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

AGS とは?

このスキルは、YouTube動画のトランスクリプトを抽出し、STAR + R-I-S-Eフレームワークを用いて詳細な要約を生成するために設計されています。動画の有効性を検証し、`youtube-transcript-api` Pythonライブラリを使用してトランスクリプトを抽出し、すべての洞察、議論、キーポイントを捉えた包括的なドキュメントを生成します。このスキルは、教育動画、講義、チュートリアル、情報コンテンツから徹底的なコンテンツ分析とリファレンスドキュメントを必要とするユーザーに最適です。対応プラットフォームはClaude Code、Cursor、CodexなどのAIエージェントで動作し、URLの検証、トランスクリプトの取得、構造化された要約の生成、マークダウン形式での出力を段階的に実行します。進捗状況を視覚的なゲージで表示しながら処理を進めるため、ユーザーは常に現在の状態を把握できます。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ASoudy/AGS/tree/HEAD/AGAS/plugins/antigravity-awesome-skills-claude/skills/youtube-summarizer

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

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

ドキュメント

YouTube要約ツール

目的

このスキルは、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. 包括的なマークダウン出力を生成する
# 4. ヘッダー、リスト、ハイライトで構造化する

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

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

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

進捗:

echo "[████████████████████] 100% - ステップ5/5: 出力のフォーマット"

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

出力構造:

# [動画タイトル]

**チャンネル:** [チャンネル名]  
**長さ:** [長さ]  
**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でインストール
- [ ] いいえ - 手動でインストールします

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

$ 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 20 individual skills — each has its own dedicated page.

ASoudy/AGS

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

ASoudy/AGS

Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

ASoudy/AGS

Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

Pull a YouTube video transcript into a queryable markdown vault with yt-dlp subtitle discovery, VTT cleanup, metadata frontmatter, and capture-seed stubs.

ASoudy/AGS

Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences. Covers developer portfolios, designer portfolios, creative portfolios, and portfolios that convert visitors into opportunities.

ASoudy/AGS

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.

ASoudy/AGS

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

ASoudy/AGS

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 悬停效果

ASoudy/AGS

Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

ASoudy/AGS

Next.js App Router principles. Server Components, data fetching, routing patterns.

ASoudy/AGS

Expert integration of Supabase Auth with Next.js App Router

ASoudy/AGS

React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

ASoudy/AGS

Best practices for Remotion - Video creation in React

ASoudy/AGS

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

ASoudy/AGS

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

ASoudy/AGS

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.

ASoudy/AGS

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

関連スキル