YouTube Clipper Skill

YouTube Clipper Skill 是一款专为 Claude Code 设计的智能视频处理Skill，能自动下载 YouTube 视频、理解内容语义、生成精细章节、剪辑片段、翻译中英双语字幕，并将字幕烧录进视频——全程无需手动操作，输出可直接用于小红书、抖音、微信公众号等平台。

它不是简单的“按时间切片”，而是让 AI 真正读懂视频内容，提取最有价值的片段。

核心功能

AI 语义章节分析（非机械切分）

• 基于字幕内容理解主题结构
• 自动识别自然话题转换点（如“AGI 定义” → “中国 AI 格局” → “芯片禁令影响”）
• 生成 2–5 分钟的有意义章节，每段配有标题与摘要
• 确保内容完整覆盖，无遗漏或截断

❌ 传统方式：[0:00–30:00]、[30:00–60:00]
✅ AI 方式：[00:00–03:15] AGI 是指数曲线而非时间点

帧级精准剪辑

• 使用 FFmpeg 进行帧精度视频切割
• 支持 720p 至 2160p 多种分辨率
• 输出原始剪辑 + 带字幕版本，满足不同用途

中英双语字幕

• 批量翻译字幕，一次处理 20 条，减少 95% API 调用
• 速度提升 10 倍，翻译一致性更高
• 输出标准 .srt 文件，格式如下：

  1
  00:00:00,000 --> 00:00:03,500
  This is the English subtitle
  这是中文字幕
  

字幕烧录（硬编码）

• 将双语字幕永久嵌入视频画面
• 支持自定义字体、大小、位置（通过 FFmpeg libass）
• macOS 用户需安装 ffmpeg-full（标准版不支持字幕渲染）

社交媒体就绪

• 自动生成适合 小红书、抖音、微信公众号 的文案（.md 格式）
• 包含章节摘要、关键观点、金句提炼

如何使用？

在 Claude Code 中直接输入：

Clip this YouTube video: https://youtube.com/watch?v=VIDEO_ID

或中文：

剪辑这个 YouTube 视频：https://youtube.com/watch?v=VIDEO_ID

Claude 会自动执行完整流程，并返回可交互的章节列表供你选择。

安装方式

推荐：一键安装（npx）

npx skills add https://github.com/op7418/Youtube-clipper-skill

手动安装

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 ≥3.8, FFmpeg with libass）
• 生成 .env 配置文件

系统要求

⚠️ macOS 用户注意：必须安装 ffmpeg-full，否则字幕烧录失败：

brew uninstall ffmpeg
brew install ffmpeg-full

验证命令：ffmpeg -filters 2>&1 | grep subtitles

输出结构

每个剪辑任务生成独立时间戳目录：

./youtube-clips/20260122_143022/
└── AGI_is_an_exponential_curve/
    ├── AGI_is_an_exponential_curve_clip.mp4          # 原始剪辑
    ├── AGI_is_an_exponential_curve_with_subtitles.mp4 # 带字幕视频
    ├── AGI_is_an_exponential_curve_bilingual.srt      # 双语字幕
    └── AGI_is_an_exponential_curve_summary.md         # 社交文案

高级配置（.env）

编辑 ~/.claude/skills/youtube-clipper/.env 自定义行为：

# 视频质量上限
MAX_VIDEO_HEIGHT=1080

# 翻译批次大小（20–25 推荐）
TRANSLATION_BATCH_SIZE=20

# 目标语言
TARGET_LANGUAGE=中文

# 单章时长（秒）
TARGET_CHAPTER_DURATION=180

# 代理设置（如需）
YT_DLP_PROXY=http://proxy-server:port

常见问题解决

❌ 字幕烧录失败？

• 错误：Option not found: subtitles
• 解决：确保安装了 ffmpeg-full（macOS）或 libass-dev（Ubuntu）

🐢 下载慢？

• 在 .env 中配置 YT_DLP_PROXY

🔁 翻译失败？

• 自动重试 3 次
• 若持续失败，降低 TRANSLATION_BATCH_SIZE

📁 文件名报错？

• 插件已自动清理非法字符（: / ? * 等），无需手动干预

为什么值得使用？

• 省时：1 小时视频 → 几分钟内生成精华片段
• 精准：AI 理解内容，而非盲目切分
• 多语言友好：中英双语字幕，助力跨文化传播
• 本地优先：所有处理在你的机器上完成，视频不上传云端
• 开箱即用：一条指令触发完整工作流