用途：这是一个面向 YouTube 内容创作的研究型技能，包含三种模式——选题调研（了解竞争格局、内容缺口与策略洞察）、视频分析（对字幕做取证式拆解，提取爆款公式与留存机制）、API 查询（直接访问 YouTube Data API v3 做搜索、统计、评论与频道查询）。适用于制作视频前的选题调研、分析竞品视频为何有效、获取频道/视频指标与评论、发现细分领域的内容机会。
主要能力：选题调研会先阅读工作区上下文（strategy/brand.md、about/me.md、content/ideas.md、content/calendar.md），将研究保存到 ./youtube/episode/[episode_number]_[topic_short_name]/research.md；调研分步骤分析自身频道、5–8 个竞品视频、内容缺口（按 ⭐ 高/中/低评级）并给出推荐聚焦方向。视频分析按 11 个维度展开：钩子架构、结构蓝图、留存机制、情绪设计、叙事元素、语言模式、算法信号、CTA 架构、传播系数、可复用模板、落地手册，最后输出速查表。
使用方式：需先配置 API 密钥，在 Google Cloud Console 启用 YouTube Data API v3 并创建 API Key，然后设置环境变量 export YOUTUBE_API_KEY="your-api-key-here"。调用 curl 时请用 bash -c '...' 包裹以保留环境变量，例如搜索视频：bash -c 'curl -s "https://www.googleapis.com/youtube/v3/search?part=snippet&q=YOUR_QUERY&type=video&maxResults=10&order=viewCount&key=${YOUTUBE_API_KEY}"' | jq '.items[] | {videoId: .id.videoId, title: .snippet.title, channel: .snippet.channelTitle}'。获取视频详情、按句柄查频道、取评论、取热门视频也各有对应 curl 命令（见资料）。字幕可用脚本获取：python skills/youtube-research/scripts/fetch_transcript.py "YOUTUBE_URL_OR_VIDEO_ID"，或手动从 YouTube 转录面板粘贴。
限制：API 配额为每天 10000 单位，搜索消耗 100 单位，其余多数为 1 单位。需注意避免堆砌数据、缺口描述模糊、报告过长。资料未提供具体收费标准与平台支持细节。