What it does
No summary yet. See the facts below or open the maker’s original description
- Connects Instruction files the AI reads
- Account or key Not confirmed (README mentions a key or .env file)
- Category Other
For makers: add a badge to your README
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/skills/op7418-youtube-clipper-skill)Similar Skills
Same kind of work, ordered like the Skills list
| This one Youtube-clipper-skill | llmfit | claude-video | VideoCaptioner | claude-cookbooks | |
|---|---|---|---|---|---|
| Maker | op7418 | AlexsJones | bradautomates | WEIFENG2333 | anthropics |
| Skills | 1 | 1 | 1 | 1 | 4 |
| GitHub stars | 2,341 | 39,064 | 21,168 | 16,570 | 54,832 |
| Last code change | Jan 22, 2026 | Nov 18, 2026 | Sep 25, 2026 | Sep 12, 2026 | Nov 17, 2026 |
| License | MIT | MIT | MIT | GPL-3.0 | MIT |
1 skills (instruction sets) by op7418 that an AI reads and follows · not an MCP server
How a Skill differs from MCP
MCP = the hands
Connects the AI to an outside service or data, such as reading Notion or creating an invoice. A program or server has to be running.
Skill = the manual
A text file that teaches the AI how to do a task. It connects to nothing.
Some overlap: a few Skills run scripts that call tools, and a few MCP servers only send knowledge. Start from the task you want done.
Works with
Claude CodeClaude (เว็บ/แอป)
From the maker’s README and the folders in the repo
Install
Is it safe?
- Who made it
GitHub account op7418 (person), 11 years old
- Use and upkeep
★ 2,341 stars · code last changed Jan 22, 2026
- Any scripts?
11 scripts that can run on a computer: install_as_skill.sh, scripts/__init__.py, scripts/analyze_subtitles.py, scripts/burn_subtitles.py and 7 more
- Uses the internet?
No internet calls found in the scripts
- Changes machine-wide settings?
Scripts that touch settings folders (~/.claude or settings.json): install_as_skill.sh
Checked automatically from the repo files at commit f31f077 (read only, nothing was run). Not a safety guarantee: read it and decide for yourself
First: which AI do you use?
Pick your app and this page shows only how to install it there
Option 1Upload to claude.ai (web and app)
Files are byte-for-byte the same as on GitHub at commit f31f077 · View on GitHub ↗
11 scripts
Once uploaded it runs on Claude’s systems, not on your computer. No need to unzip
Look inside before downloading
All 22 files · 134 KB
.env.example3 KBFIXES_AND_IMPROVEMENTS.md8 KBLICENSE1 KBREADME.md8 KBREADME.zh-CN.md8 KBSKILL.md11 KBTECHNICAL_NOTES.md11 KBinstall_as_skill.sh7 KBreferences/ffmpeg-guide.md3 KBreferences/subtitle-formatting.md8 KBreferences/yt-dlp-guide.md6 KBscripts/__init__.py1 KBscripts/analyze_subtitles.py7 KBscripts/burn_subtitles.py8 KBscripts/clip_video.py7 KBscripts/download_video.py7 KBscripts/extract_subtitle_clip.py4 KBscripts/generate_summary.py6 KBscripts/merge_bilingual_subtitles.py2 KBscripts/translate_subtitles.py7 KBscripts/utils.py8 KBtemplates/summary-template.md3 KB
Download youtube-clipper.zip
Open Skills on claude.ai and upload
+Create skillUpload a skillpick youtube-clipper.zip
No Upload button? Turn on file creation first
SettingsCapabilitiesCode execution and file creation
Turn on Code execution and file creation first (newer menus: Create and edit files) · personal plans: Settings → Capabilities · Team/Enterprise: an admin turns it on under Organization settings → Plugins & skills · every plan, including Free
Upload once; it works in claude.ai and Claude Desktop, and in recent Claude Code signed in with a Claude account (not with an API key)
Cowork and cloud sessions use the skills turned on in your claude.ai account, not ~/.claude/skills on your computer (Claude Desktop scheduled tasks run locally and still load it)
Checked against official docs Nov 12, 2026 · Source: support.claude.com, support.claude.com, code.claude.com
Option 1Let Claude Code install it
Copy this sentence and paste it into a Claude Code chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Restart Claude Code, then type /Youtube-clipper-skill or ask for a matching task and Claude picks it up
Checked against official docs Nov 12, 2026 · Source: code.claude.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
The maker’s recommended way
Install Node.js (if you don’t have it)
Already installed? Check first · Open Terminal, type this command and press Enter
node -v- A version number such as v26.13.1 = installed, skip this step
- "command not found" (on Windows: "is not recognized") = not installed yet, or installed but Terminal needs to be closed and reopened
How to open Terminal
Mac: press ⌘ + Space, type Terminal, press Enter
Windows: open Start, type Windows PowerShell, then Open
Not installed: Open the official download page, pick the LTS version and the click-through installer: .pkg on Mac · .msi on Windows. Double-click and follow it to the end. No curl command needed
Open the Node.js download page ↗
When it’s done, close Terminal, open it again and run the same command. You should see a version number: node -v
Install once; it works for everything that needs Node.js
npx skills add https://github.com/op7418/Youtube-clipper-skillCopied from the maker’s README; it downloads and runs the maker’s code
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.claude/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/op7418/youtube-clipper-skill.git /tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077 && mkdir -p ~/.claude/skills && cp -R '/tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077/.' ~/.claude/skills/youtube-clipper-skillRestart Claude Code, then type /Youtube-clipper-skill or ask for a matching task and Claude picks it up
ChatGPT desktop app
The ChatGPT desktop app has Codex built in, and Codex reads skills from ~/.agents/skills
Option 1Let ChatGPT install it
Open Codex in the ChatGPT desktop app and paste this sentence into the chat
The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Option 2Put the folder there yourself
Put the youtube-clipper folder at ~/.agents/skills/youtube-clipper
~ is your home folder ($HOME)
Without Terminal: download the ZIP, unzip it and move the youtube-clipper folder to ~/.agents/skills
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/op7418/youtube-clipper-skill.git /tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077/.' ~/.agents/skills/youtube-clipper-skill
After installing
- ChatGPT desktop app: open Skills in the sidebar to see that the skill is there
- To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
- Codex picks up newly installed skills by itself; if one does not show up, restart Codex
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
ChatGPT on the web and mobile
Skills you install yourself do not work here; only skills that come with a plugin from the directory
To use this skill with ChatGPT, use the ChatGPT desktop app as above
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
Option 1Let Codex install it
Copy this sentence and paste it into a Codex chat · Works in Codex inside the ChatGPT desktop app, Codex CLI and the IDE extension
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Codex picks up newly installed skills by itself; if one does not show up, restart Codex · To use it: in ChatGPT type @ and pick the skill · in Codex CLI or the IDE extension run /skills or type $ and the skill name
Checked against official docs Nov 15, 2026 · Source: learn.chatgpt.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.agents/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/op7418/youtube-clipper-skill.git /tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077 && mkdir -p ~/.agents/skills && cp -R '/tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077/.' ~/.agents/skills/youtube-clipper-skillRestart Codex, then ask for a matching task; Codex lists the skill
Option 1Let Cursor install it
Copy this sentence and paste it into a Cursor chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
In Cursor’s Agent chat, type / and pick Youtube-clipper-skill
Checked against official docs Nov 12, 2026 · Source: cursor.com
For Terminal users
A Skill is instructions the AI will follow. Read the files before installing, and install only from makers you trust.
Open Terminal
Mac: press Command+Space and type Terminal · Windows: the command below does not work in PowerShell; use “Let AI install it” above instead
Copy the skill folder to ~/.cursor/skills
This downloads the repo to a temporary folder and copies only the folders that contain a SKILL.md
git clone --depth 1 https://github.com/op7418/youtube-clipper-skill.git /tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077 && mkdir -p ~/.cursor/skills && cp -R '/tmp/popnx-skill-op7418-youtube-clipper-skill-f31f077/.' ~/.cursor/skills/youtube-clipper-skillIn Cursor’s Agent chat, type / and pick Youtube-clipper-skill
Option 1Let the AI install it
For other apps that read skills. The sentence gives the paths for Claude Code, Codex and Cursor so the AI picks the one for your app · Copy this sentence into the app’s chat
For one project, paste it into a chat that is open in that project’s folder · The AI always shows you the path before installing
The AI tells you what it will do first and asks your permission at every step
Checked against official docs Nov 12, 2026 · Source: code.claude.com, learn.chatgpt.com, cursor.com
For Terminal users
Other apps that support Agent Skills (such as Gemini CLI or GitHub Copilot) use different folders. Check that app’s guide, then copy the folder with the SKILL.md there.
Skill folders checked against the official Claude Code, Codex and Cursor guides on Nov 11, 2026
✓ Commands checked Nov 18, 2026
View the original SKILL.md
The text below comes from the maker’s repo, not from PopNx MCP
6,417 characters · Open the full file on 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](README.md#installation) 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`
#### 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 精细章节分析** 和 **无缝的技术处理**,让用户能快速从长视频中提取高质量的短视频片段。
Discussion
Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
From GitHub
- GitHub stars
- 2,341
- Maker
- op7418
- License
- MIT
- Last code change
- Jan 22, 2026
- SKILL.md files in the repo (including translated copies and templates)
- 1