YouTube Clipper Skill
面向 Claude Code 的 AI 驱动的 YouTube 视频剪辑技能，可下载视频、生成语义章节、剪辑片段、翻译字幕为双语并烧录到视频中。
社区作者 · zZz
它解决什么问题
YouTube Clipper Skill 是一个专为 Claude Code 设计的 AI 视频剪辑工具。它通过 AI 语义分析理解视频内容，自动生成细粒度章节（每段 2-5 分钟），利用 FFmpeg 进行帧级精确剪辑，并支持将字幕批量翻译为中英双语（减少 95% API 调用），还能将双语字幕以自定义样式烧录进视频。该工具同时支持自动生成适用于小红书、抖音、微信等平台的社交媒体内容总结。
项目采用 MIT 许可证，适用于希望快速从 YouTube 视频中提取精华片段、制作双语字幕视频的内容创作者、课程开发者和社交媒体运营者。安装方式包括 npx skills 一键安装和手动脚本安装两种，需预先安装 Python 3.8+、yt-dlp 和带 libass 的 FFmpeg。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
一、准备环境
需要 Python 3.8+、最新版 yt-dlp、带 libass 的 FFmpeg。各依赖安装命令
Python 从 python.org 下载；macOS 执行 brew install yt-dlp、brew install ffmpeg-full；Ubuntu 执行 sudo apt install yt-dlp、sudo apt install ffmpeg libass-dev；也可用 pip install yt-dlp 安装。注意：macOS 用户必须安装 ffmpeg-full 而非标准 ffmpeg，因为标准包不支持 libass（字幕烧录需要）。安装后验证 libass 支持：执行 ffmpeg -filters 2>&1 | grep subtitles，应输出 subtitles V->V (...) 类似内容。二、安装方式一（推荐）
执行
npx skills add https://github.com/op7418/Youtube-clipper-skill，该命令会自动安装到 ~/.claude/skills/youtube-clipper/ 目录。
三、安装方式二（手动）
执行
git clone https://github.com/op7418/Youtube-clipper-skill.git && cd Youtube-clipper-skill && bash install_as_skill.sh。脚本会自动完成：复制文件到 ~/.claude/skills/youtube-clipper/；安装 Python 依赖（yt-dlp、pysrt、python-dotenv）；检查系统依赖（Python、yt-dlp、FFmpeg）；创建 .env 配置文件。
四、首次运行
在 Claude Code 环境中对 Claude 说“Clip this YouTube video: https://youtube.com/watch?v=VIDEO_ID”或“剪辑这个 YouTube 视频：https://youtube.com/watch?v=VIDEO_ID”。工作流会自动执行环境检查、视频下载（最高 1080p）和英文字幕获取、AI 章节分析、用户选择、剪辑处理，输出结果保存在 ./youtube-clips/<时间戳>/ 目录下。
五、常见问题
1）字幕烧录失败，提示 Option not found: subtitles 时，macOS 执行
brew uninstall ffmpeg && brew install ffmpeg-full，Ubuntu 执行 sudo apt install ffmpeg libass-dev。2）视频下载慢时，在 .env 中设置 YT_DLP_PROXY=http://proxy-server:port 或 socks5://proxy-server:port。3）字幕翻译失败时，工具会自动重试最多 3 次；若仍失败请检查网络、Claude API 状态，或调低 .env 中的 TRANSLATION_BATCH_SIZE。4）文件名含特殊字符（: / ? 等）时，工具会自动清理特殊字符、空格替换为下划线，并限制长度不超过 100 字符。