Communitygithub.com

Anhvu1107/all-agent-skill

要求匹配 YouTube 视频总结器时始终使用此技能:提取 YouTube 视频的转录文本,并利用智能分析框架生成全面、详细的总结。

all-agent-skill 是什么?

该技能专为需要深入分析 YouTube 视频内容的用户设计。它利用 `youtube-transcript-api` Python 库提取视频转录,并采用增强的 STAR + R-I-S-E 框架生成详尽的结构化总结。技能首先验证视频 URL 的有效性以及转录的可获取性,然后提取完整的文字记录。接着,通过 AI 模型(如 Claude 或 GPT)应用高级提示,生成包含视频元数据、执行摘要、逐节分析、关键见解、概念术语表以及结论的综合文档。该技能适用于教育视频、讲座、教程和知识性内容,帮助用户在不重新观看的情况下获取完整的参考文档。支持所有标准 YouTube URL 格式,并在缺少依赖时提示用户安装。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Anhvu1107/all-agent-skill/tree/HEAD/.agent/skills/youtube-summarizer

在你喜欢的 AI 中提问

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

文档

视频总结器 (YouTube Summarizer)

选择性阅读规则

请先阅读以下文件:

  • references/senior-master-standard.md
  • references/usage-routing.md
  • references/quality-checklist.md

然后仅加载与用户实际任务相关的继承文档、脚本、资源或示例。

目的

此技能从 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 之前显示初始状态框:

╔══════════════════════════════════════════════════════════════╗
║     📹  视频总结器 - 正在处理视频                              ║
╠══════════════════════════════════════════════════════════════╣
║ → 第 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
成功安装 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.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches 007: Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Agentfolio: Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Animejs Animation: Advanced JavaScript animation library skill for creating complex, high-performance web animations.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astropy: Astropy is the core Python package for astronomy, providing essential functionality for astronomical research and data analysis.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Astro: Build content-focused websites with Astro — zero JS by default, islands architecture, multi-framework components, and Markdown/MDX support.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Emotional ARC Designer: One sentence - what this skill does and when to invoke it

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Fixing Motion Performance: Audit and fix animation performance issues including layout thrashing, compositor properties, scroll-linked motion, and blur effects.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches I18n Localization: Internationalization and localization patterns.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Interactive Portfolio: Expert in building portfolios that actually land jobs and clients - not just showing work, but creating memorable experiences.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches JQ: Expert jq usage for JSON querying, filtering, transformation, and pipeline integration.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Landing Page Generator: Generates high-converting Next.js/React landing pages with Tailwind CSS.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches LEX: Centralized ''Truth Engine'' for cross-jurisdictional legal context (US, EU, CA) and contract scaffolding.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Magic Animator: AI-powered animation tool for creating motion in logos, UI, icons, and social media assets.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Makepad Animation: CRITICAL: Use for Makepad animation system.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs APP Router Patterns: Comprehensive patterns for Next.js 14+ App Router architecture, Server Components, and modern full-stack React development.

Anhvu1107/all-agent-skill

ALWAYS use this when the user mentions Nextjs Best Practices, asks to build, debug, review, document, automate, test, configure, migrate, or make decisions in this domain, or the task clearly depends on Nextjs Best Practices; scope: Next.js App Router principles. Apply the bundled workflow, references, scripts, Senior Master standard, and Codex strict review gate before final output.

Anhvu1107/all-agent-skill

description: ALWAYS use this when the work is specifically about modern Next.js or React architecture, data flow, rendering strategy, routing, or performance-sensitive frontend behavior.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches Nextjs Supabase Auth: Expert integration of Supabase Auth with Next.js App Router

Anhvu1107/all-agent-skill

ALWAYS use this when the task involves reading, extracting, splitting, merging, rotating, creating, validating, OCR-ing, form-filling, or otherwise producing or modifying PDF files.

Anhvu1107/all-agent-skill

ALWAYS use this when the request matches React Nextjs Development: React and Next.js 14+ application development with App Router, Server Components, TypeScript, Tailwind CSS, and modern frontend patterns.

相关技能