Communitygithub.com

Desesbraker/agentes-vip

从YouTube视频中提取转录文本,并使用智能分析框架生成全面、详细的摘要。

agentes-vip 是什么?

这个技能可以从YouTube视频中提取转录文本,并基于STAR + R-I-S-E框架生成结构化的详细摘要。它首先验证视频的可用性和URL格式,然后使用`youtube-transcript-api` Python库提取转录,最后利用AI模型(如Claude或GPT)生成包含视频元数据、执行摘要、逐节详细分析、关键概念和结论的综合文档。该技能特别适用于需要深度分析教育视频、讲座、教程或参考内容的场景,用户可以通过简单的指令(如“summarize”或“extract content”)触发整个工作流。它支持多种YouTube URL格式,并提供了清晰的进度跟踪和错误处理机制,确保用户获得完整的、优先考虑详尽性而非简洁性的内容文档。

兼容平台✓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 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

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 提示词,创建详细摘要。

应用提示词:

使用第二阶段(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"  # 将转录内容读入上下文

然后应用完整的摘要提示词(来自第二阶段的增强版本)。

步骤 5:格式化并呈现输出

进度:

echo "[████████████████████] 100% - 步骤 5/5:格式化输出"

目标: 以整洁、结构良好的 Markdown 格式交付摘要。

输出结构:

# [视频标题]

**频道:** [频道名称]  
**时长:** [时长]  
**URL:** [https://youtube.com/watch?v=VIDEO_ID]  
**发布时间:** [发布日期(如有)]


## 📝 详细摘要

### [主题 1]

[包含示例、数据、引用等的全面解释...]

#### [子主题 1.1]

[详细分解...]

### [主题 2]

[继续详细分析...]


## 📚 概念和术语

- **[术语 1]:** [定义和上下文]
- **[术语 2]:** [定义和上下文]


## 📌 结论

[最终综合和要点]

示例 2:缺少依赖项

用户输入:

claude> summarize this youtube video 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> summarize youtube video 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.

相关技能