Agent skill

Youtube Clipper

by op7418 in op7418/Youtube-clipper-skill

YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。

MITAuto-check: notesMedia & Creative

Install Youtube Clipper

skills CLI
$ npx skills add op7418/Youtube-clipper-skill --skill youtube-clipper -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install op7418/Youtube-clipper-skill youtube-clipper --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
youtube-clipper
GitHub stars
2.2k
Token cost
~1.6k tokens
SKILL.md length
445 words
Files
25 (incl. scripts, references)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。

  • Works in 4 steps: FFmpeg 路径空格问题 → 批量翻译优化 → 章节分析精细度 → …
  • Media & Creative work in your project
  • SKILL.md covers 工作流程, 关键技术点, 错误处理 and 输出文件命名规范, plus 2 more sections
  • Runs Python and Shell scripts from its folder; calls python3, ffmpeg and brew

What it does

Youtube Clipper is an agent skill from op7418/Youtube-clipper-skill. YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 27 other files, including scripts and reference files (for example `.github/REPOSITORY_SETTINGS.md`, `FIXES_AND_IMPROVEMENTS.md` and `README.md`).

It sits in Media & Creative. It works with YouTube, FFmpeg, Homebrew and Python. The licence is MIT.

When your agent uses it

  • Media & Creative work in your project

Example prompts

  • “/youtube-clipper”

Requirements

  • Python 3
  • Node.js
  • A Bash shell
  • Pre-approved tools (allowed-tools): Read, Write, Bash, Glob, AskUserQuestion

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. FFmpeg 路径空格问题
  2. 批量翻译优化
  3. 章节分析精细度
  4. FFmpeg vs ffmpeg-full

What it can do on your machine

Read from SKILL.md and the folder at commit f31f077. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Read
    • Write
    • Bash
    • Glob
    • AskUserQuestion

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 5 files in scripts/ (Python and Shell, from the files we listed), which the agent can run.

    Shell commands in SKILL.md call:

    • python3
    • ffmpeg
    • brew
    • pip
    • yt-dlp
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use pip and npx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Youtube Clipper loads about 1.6k tokens when it runs, and up to ~6.1k if it reads all its reference files. Until then it costs about 46 tokens; SKILL.md has 445 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~46
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Read, Write, Bash, Glob, AskUserQuestion

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from op7418/Youtube-clipper-skill at commit f31f077, republished under its MIT licence (© op7418). 445 words, ~1,605 tokens.

Download SKILL.mdSave it as .claude/skills/youtube-clipper/SKILL.md (or your agent's skills folder). This skill also uses 24 other files; get the full folder from GitHub.
name
youtube-clipper
description
YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。 使用场景:当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。 关键词:视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video
allowed-tools
Read, Write, Bash, Glob, AskUserQuestion
model
claude-sonnet-4-5-20250514

YouTube 视频智能剪辑工具

Installation: If you're installing this skill from GitHub, please refer to README.md for installation instructions. The recommended method is npx skills add https://github.com/op7418/Youtube-clipper-skill.

工作流程

你将按照以下 6 个阶段执行 YouTube 视频剪辑任务:

阶段 1: 环境检测

目标: 确保所有必需工具和依赖都已安装

  1. 检测 yt-dlp 是否可用

    bash
    yt-dlp --version
  2. 检测 FFmpeg 版本和 libass 支持

    bash
    # 优先检查 ffmpeg-full(macOS)
    /opt/homebrew/opt/ffmpeg-full/bin/ffmpeg -version
    
    # 检查标准 FFmpeg
    ffmpeg -version
    
    # 验证 libass 支持(字幕烧录必需)
    ffmpeg -filters 2>&1 | grep subtitles
  3. 检测 Python 依赖

    bash
    python3 -c "import yt_dlp; print('✅ yt-dlp available')"
    python3 -c "import pysrt; print('✅ pysrt available')"

如果环境检测失败:

  • yt-dlp 未安装: 提示 brew install yt-dlp 或 pip install yt-dlp
  • FFmpeg 无 libass: 提示安装 ffmpeg-full
    bash
    brew install ffmpeg-full  # macOS
  • Python 依赖缺失: 提示 pip install pysrt python-dotenv

注意:

  • 标准 Homebrew FFmpeg 不包含 libass,无法烧录字幕
  • ffmpeg-full 路径: /opt/homebrew/opt/ffmpeg-full/bin/ffmpeg (Apple Silicon)
  • 必须先通过环境检测才能继续

阶段 2: 下载视频

目标: 下载 YouTube 视频和英文字幕

  1. 询问用户 YouTube URL

  2. 调用 download_video.py 脚本

    bash
    cd ~/.claude/skills/youtube-clipper
    python3 scripts/download_video.py <youtube_url>
  3. 脚本会:

    • 下载视频(最高 1080p,mp4 格式)
    • 下载英文字幕(VTT 格式,自动字幕作为备选)
    • 输出文件路径和视频信息
  4. 向用户展示:

    • 视频标题
    • 视频时长
    • 文件大小
    • 下载路径

输出:

  • 视频文件: <id>.mp4(使用视频 ID 命名,避免特殊字符问题)
  • 字幕文件: <id>.en.vtt

阶段 3: 分析章节(核心差异化功能)

目标: 使用 Claude AI 分析字幕内容,生成精细章节(2-5 分钟级别)

  1. 调用 analyze_subtitles.py 解析 VTT 字幕

    bash
    python3 scripts/analyze_subtitles.py <subtitle_path>
  2. 脚本会输出结构化字幕数据:

    • 完整字幕文本(带时间戳)
    • 总时长
    • 字幕条数
  3. 你需要执行 AI 分析(这是最关键的步骤):

    • 阅读完整字幕内容
    • 理解内容语义和主题转换点
    • 识别自然的话题切换位置
    • 生成 2-5 分钟粒度的章节(避免半小时粗粒度切分)
  4. 为每个章节生成:

    • 标题: 精炼的主题概括(10-20 字)
    • 时间范围: 起始和结束时间(格式: MM:SS 或 HH:MM:SS)
    • 核心摘要: 1-2 句话说明这段讲了什么(50-100 字)
    • 关键词: 3-5 个核心概念词
  5. 章节生成原则:

    • 粒度:每个章节 2-5 分钟(避免太短或太长)
    • 完整性:确保所有视频内容都被覆盖,无遗漏
    • 有意义:每个章节是一个相对独立的话题
    • 自然切分:在主题转换点切分,不要机械地按时间切
  6. 向用户展示章节列表:

    📊 分析完成,生成 X 个章节:
    
    1. [00:00 - 03:15] AGI 不是时间点,是指数曲线
       核心: AI 模型能力每 4-12 月翻倍,工程师已用 Claude 写代码
       关键词: AGI、指数增长、Claude Code
    
    2. [03:15 - 06:30] 中国在 AI 上的差距
       核心: 芯片禁运卡住中国,DeepSeek benchmark 优化不代表实力
       关键词: 中国、芯片禁运、DeepSeek
    
    ... (所有章节)
    
    ✓ 所有内容已覆盖,无遗漏

阶段 4: 用户选择

目标: 让用户选择要剪辑的章节和处理选项

  1. 使用 AskUserQuestion 工具让用户选择章节

    • 提供章节编号供用户选择
    • 支持多选(可以选择多个章节)
  2. 询问处理选项:

    • 是否生成双语字幕?(英文 + 中文)
    • 是否烧录字幕到视频?(硬字幕)
    • 是否生成总结文案?
  3. 确认用户选择并展示处理计划


阶段 5: 剪辑处理(核心执行阶段)

目标: 并行执行多个处理任务

对于每个用户选择的章节,执行以下步骤:

5.1 剪辑视频片段
bash
python3 scripts/clip_video.py <video_path> <start_time> <end_time> <output_path>
  • 使用 FFmpeg 精确剪辑
  • 保持原始视频质量
  • 输出: <章节标题>_clip.mp4
5.2 提取字幕片段
  • 从完整字幕中过滤出该时间段的字幕
  • 调整时间戳(减去起始时间,从 00:00:00 开始)
  • 转换为 SRT 格式
  • 输出: <章节标题>_original.srt
5.3 翻译字幕(如果用户选择)
bash
python3 scripts/translate_subtitles.py <subtitle_path>
  • 批量翻译优化: 每批 20 条字幕一起翻译(节省 95% API 调用)
  • 翻译策略:
    • 保持技术术语的准确性
    • 口语化表达(适合短视频)
    • 简洁流畅(避免冗长)
  • 输出: <章节标题>_translated.srt
5.4 生成双语字幕文件(如果用户选择)
  • 合并英文和中文字幕
  • 格式: SRT 双语(每条字幕包含英文和中文)
  • 样式: 英文在上,中文在下
  • 输出: <章节标题>_bilingual.srt
Show full SKILL.md (224 more words)Show less
5.5 烧录字幕到视频(如果用户选择)
bash
python3 scripts/burn_subtitles.py <video_path> <subtitle_path> <output_path>
  • 使用 ffmpeg-full(libass 支持)
  • 使用临时目录解决路径空格问题(关键!)
  • 字幕样式:
    • 字体大小: 24
    • 底部边距: 30
    • 颜色: 白色文字 + 黑色描边
  • 输出: <章节标题>_with_subtitles.mp4
5.6 生成总结文案(如果用户选择)
bash
python3 scripts/generate_summary.py <chapter_info>
  • 基于章节标题、摘要和关键词
  • 生成适合社交媒体的文案
  • 包含: 标题、核心观点、适合平台(小红书、抖音等)
  • 输出: <章节标题>_summary.md

进度展示:

🎬 开始处理章节 1/3: AGI 不是时间点,是指数曲线

1/6 剪辑视频片段... ✅
2/6 提取字幕片段... ✅
3/6 翻译字幕为中文... [=====>    ] 50% (26/52)
4/6 生成双语字幕文件... ✅
5/6 烧录字幕到视频... ✅
6/6 生成总结文案... ✅

✨ 章节 1 处理完成

阶段 6: 输出结果

目标: 组织输出文件并展示给用户

  1. 创建输出目录

    ./youtube-clips/<日期时间>/

    输出目录位于当前工作目录下

  2. 组织文件结构:

    <章节标题>/
    ├── <章节标题>_clip.mp4              # 原始剪辑(无字幕)
    ├── <章节标题>_with_subtitles.mp4   # 烧录字幕版本
    ├── <章节标题>_bilingual.srt        # 双语字幕文件
    └── <章节标题>_summary.md           # 总结文案
  3. 向用户展示:

    • 输出目录路径
    • 文件列表(带文件大小)
    • 快速预览命令
    ✨ 处理完成!
    
    📁 输出目录: ./youtube-clips/20260121_143022/
    
    文件列表:
      🎬 AGI_指数曲线_双语硬字幕.mp4 (14 MB)
      📄 AGI_指数曲线_双语字幕.srt (2.3 KB)
      📝 AGI_指数曲线_总结.md (3.2 KB)
    
    快速预览:
    open ./youtube-clips/20260121_143022/AGI_指数曲线_双语硬字幕.mp4
  4. 询问是否继续剪辑其他章节

    • 如果是,返回阶段 4(用户选择)
    • 如果否,结束 Skill

关键技术点

1. FFmpeg 路径空格问题

问题: FFmpeg subtitles 滤镜无法正确解析包含空格的路径

解决方案: burn_subtitles.py 使用临时目录

  • 创建无空格临时目录
  • 复制文件到临时目录
  • 执行 FFmpeg
  • 移动输出文件回目标位置
2. 批量翻译优化

问题: 逐条翻译会产生大量 API 调用

解决方案: 每批 20 条字幕一起翻译

  • 节省 95% API 调用
  • 提高翻译速度
  • 保持翻译一致性
3. 章节分析精细度

目标: 生成 2-5 分钟粒度的章节,避免半小时粗粒度

方法:

  • 理解字幕语义,识别主题转换
  • 寻找自然的话题切换点
  • 确保每个章节有完整的论述
  • 避免机械按时间切分
4. FFmpeg vs ffmpeg-full

区别:

  • 标准 FFmpeg: 无 libass 支持,无法烧录字幕
  • ffmpeg-full: 包含 libass,支持字幕烧录

路径:

  • 标准: /opt/homebrew/bin/ffmpeg
  • ffmpeg-full: /opt/homebrew/opt/ffmpeg-full/bin/ffmpeg (Apple Silicon)

错误处理

环境问题
  • 缺少工具 → 提示安装命令
  • FFmpeg 无 libass → 引导安装 ffmpeg-full
  • Python 依赖缺失 → 提示 pip install
下载问题
  • 无效 URL → 提示检查 URL 格式
  • 字幕缺失 → 尝试自动字幕
  • 网络错误 → 提示重试
处理问题
  • FFmpeg 执行失败 → 显示详细错误信息
  • 翻译失败 → 重试机制(最多 3 次)
  • 磁盘空间不足 → 提示清理空间

输出文件命名规范

  • 视频片段: <章节标题>_clip.mp4
  • 字幕文件: <章节标题>_bilingual.srt
  • 烧录版本: <章节标题>_with_subtitles.mp4
  • 总结文案: <章节标题>_summary.md

文件名处理:

  • 移除特殊字符(/, \, :, *, ?, ", <, >, |)
  • 空格替换为下划线
  • 限制长度(最多 100 字符)

用户体验要点

  1. 进度可见: 每个步骤都展示进度和状态
  2. 错误友好: 清晰的错误信息和解决方案
  3. 可控性: 用户选择要剪辑的章节和处理选项
  4. 高质量: 章节分析有意义,翻译准确流畅
  5. 完整性: 提供原始和处理后的多个版本

开始执行

当用户触发这个 Skill 时:

  1. 立即开始阶段 1(环境检测)
  2. 按照 6 个阶段顺序执行
  3. 每个阶段完成后自动进入下一阶段
  4. 遇到问题时提供清晰的解决方案
  5. 最后展示完整的输出结果

记住:这个 Skill 的核心价值在于 AI 精细章节分析 和 无缝的技术处理,让用户能快速从长视频中提取高质量的短视频片段。

© op7418, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 24 other files (scripts, references) in the repository root of op7418/Youtube-clipper-skill.

  • SKILL.md
  • .env.example
  • .github/REPOSITORY_SETTINGS.md
  • .gitignore
  • FIXES_AND_IMPROVEMENTS.md
  • LICENSE
  • README.md
  • README.zh-CN.md
  • TECHNICAL_NOTES.md
  • install_as_skill.sh
  • references/ffmpeg-guide.md
  • references/subtitle-formatting.md
  • references/yt-dlp-guide.md
  • scripts/__init__.py
  • scripts/analyze_subtitles.py
  • scripts/burn_subtitles.py
  • scripts/clip_video.py
  • scripts/download_video.py
  • … and 7 more

Open the folder on GitHubat commit f31f077

Compare with similar skills

Youtube Clipper next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Youtube Clipper compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Youtube Clipper this skillop7418/Youtube-clipper-skill2.2k—~1.6kAutomated safety check: NotesMIT
Ffmpeg Skillkajisho5/ffmpeg-skill1.9k—~7.4kAutomated safety check: PassMIT
Claude Real VideoHUANGCHIHHUNGLeo/claude-real-video2.2k—~639Automated safety check: PassMIT
Claude Real VideoHUANGCHIHHUNGLeo/claude-real-video2.2k—~559Automated safety check: PassMIT
Youtube Transcribekennyzir/7deer_skills322—~1.7kAutomated safety check: PassMIT
Watchmathiaschu/watch142—~4kAutomated safety check: WarnMIT

Similar skills

  • Ffmpeg Skill

    kajisho5/ffmpeg-skill

    Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…

    1.9k GitHub stars~7.4k tokensUpdated 4 days ago
    Media & CreativeAuto-check passed
  • Claude Real Video

    HUANGCHIHHUNGLeo/claude-real-video

    Watch a video for the user. An agent skill from HUANGCHIHHUNGLeo/claude-real-video.

    2.2k GitHub stars~639 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Claude Real Video

    HUANGCHIHHUNGLeo/claude-real-video

    幫 Leo 看影片。當 Leo 丟影片連結(YouTube/IG/TikTok)或本機影片檔,要摘要、分析、拆解對標時使用——Claude 不能直接吃影片,先用這個工具抽關鍵幀+逐字稿+運鏡節奏+聲音/語氣/手勢時間軸再讀。

    2.2k GitHub stars~559 tokensUpdated yesterday
    Media & CreativeAuto-check passed
  • Youtube Transcribe

    kennyzir/7deer_skills

    YouTube video transcription and memory workflow. An agent skill from kennyzir/7deer_skills.

    322 GitHub stars~1.7k tokensUpdated 10 days ago
    Media & CreativeAuto-check passed
  • Watch

    mathiaschu/watch

    Watch a video from YouTube, Instagram, X/Twitter, Vimeo, TikTok or any of ~1800 yt-dlp sites (or a local path).

    142 GitHub stars~4k tokensUpdated 4 mo ago
    Media & CreativeAuto-check: warnings
  • Setup

    barefootford/buttercut

    Sets up a Mac or Windows PC for ButterCut. An agent skill from barefootford/buttercut.

    601 GitHub stars~892 tokensUpdated 16 days ago
    Media & CreativeAuto-check passed

Questions about Youtube Clipper

What does Youtube Clipper do?

YouTube 视频智能剪辑工具。下载视频和字幕,AI 分析生成精细章节(几分钟级别), 用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频,并生成总结文案。. Youtube Clipper is an agent skill from op7418/Youtube-clipper-skill.

When should I use Youtube Clipper?

Youtube Clipper fits situations like: media & Creative work in your project.

How do I install Youtube Clipper in Claude Code?

Run `npx skills add op7418/Youtube-clipper-skill --skill youtube-clipper -a claude-code`. Or copy the skill folder (the op7418/Youtube-clipper-skill repository) into .claude/skills/youtube-clipper in your project. Claude Code loads it when a task matches its description.

How do I install Youtube Clipper in Codex?

Run `npx skills add op7418/Youtube-clipper-skill --skill youtube-clipper -a codex`. Or copy the skill folder (the op7418/Youtube-clipper-skill repository) into .agents/skills/youtube-clipper in your project. Codex loads it when a task matches its description.

Can I use Youtube Clipper in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add op7418/Youtube-clipper-skill --skill youtube-clipper -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/youtube-clipper, .gemini/skills/youtube-clipper, .github/skills/youtube-clipper and .opencode/skills/youtube-clipper in your project.

What does Youtube Clipper need to run?

Going by SKILL.md and its folder, Youtube Clipper needs Python and a shell for the scripts in its folder and the command-line tools its instructions call (python3, ffmpeg, brew, pip, yt-dlp and npx). Our summary lists: Python 3; Node.js; A Bash shell. Its frontmatter pre-approves these tools: Read, Write, Bash, Glob, AskUserQuestion.

Does Youtube Clipper access the network?

SKILL.md contains no URLs. Its commands use pip and npx, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Youtube Clipper safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Youtube Clipper use?

Youtube Clipper is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Youtube Clipper use?

About 1.6k tokens (SKILL.md is roughly 6.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.5k tokens, read only when the agent opens those files.

What are the alternatives to Youtube Clipper?

Skills that share tags, products or a category with Youtube Clipper: Ffmpeg Skill (kajisho5/ffmpeg-skill, 1.9k stars), Claude Real Video (HUANGCHIHHUNGLeo/claude-real-video, 2.2k stars), Claude Real Video (HUANGCHIHHUNGLeo/claude-real-video, 2.2k stars) and Youtube Transcribe (kennyzir/7deer_skills, 322 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Youtube Clipper?

op7418 (a GitHub user) maintains it in op7418/Youtube-clipper-skill, which has 2,227 GitHub stars. The repository was last updated on January 22, 2026.

Source: op7418/Youtube-clipper-skill on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.