op7418/Youtube-clipper-skill

Perfil de op7418

Última atividade de origem registrada: 22 de janeiro de 2026 às 04:56

Catálogo do SkillsMP atualizado: 26 de outubro de 2026 às 11:37

skills coletadas: 1

Estrelas no GitHub: 2.258
Forks no GitHub: 322

README do repositório

Arquivo de origem do README: README.md

Ler o README original

Expandir README completo

# YouTube Clipper Skill > AI-powered YouTube video clipper for Claude Code. Download videos, generate semantic chapters, clip segments, translate subtitles to bilingual format, and burn subtitles into videos. [![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/) English | [简体中文](README.zh-CN.md) [Features](#features) • [Installation](#installation) • [Usage](#usage) • [Requirements](#requirements) • [Configuration](#configuration) • [Troubleshooting](#troubleshooting) --- ## Features - **AI Semantic Analysis** - Generate fine-grained chapters (2-5 minutes each) by understanding video content, not just mechanical time splitting - **Precise Clipping** - Use FFmpeg to extract video segments with frame-accurate timing - **Bilingual Subtitles** - Batch translate subtitles to Chinese/English with 95% API call reduction - **Subtitle Burning** - Hardcode bilingual subtitles into videos with customizable styling - **Content Summarization** - Auto-generate social media content (Xiaohongshu, Douyin, WeChat) --- ## Installation ### Option 1: npx skills (Recommended) ```bash npx skills add https://github.com/op7418/Youtube-clipper-skill ``` This command will automatically install the skill to `~/.claude/skills/youtube-clipper/`. ### Option 2: Manual Installation ```bash git clone https://github.com/op7418/Youtube-clipper-skill.git cd Youtube-clipper-skill bash install_as_skill.sh ``` The install script will: - Copy files to `~/.claude/skills/youtube-clipper/` - Install Python dependencies (yt-dlp, pysrt, python-dotenv) - Check system dependencies (Python, yt-dlp, FFmpeg) - Create `.env` configuration file --- ## Requirements ### System Dependencies | Dependency | Version | Purpose | Installation | |------------|---------|---------|--------------| | **Python** | 3.8+ | Script execution | [python.org](https://www.python.org/downloads/) | | **yt-dlp** | Latest | YouTube download | `brew install yt-dlp` (macOS)<br>`sudo apt install yt-dlp` (Ubuntu)<br>`pip install yt-dlp` (pip) | | **FFmpeg with libass** | Latest | Video processing & subtitle burning | `brew install ffmpeg-full` (macOS)<br>`sudo apt install ffmpeg libass-dev` (Ubuntu) | ### Python Packages These are automatically installed by the install script: - `yt-dlp` - YouTube downloader - `pysrt` - SRT subtitle parser - `python-dotenv` - Environment variable management ### Important: FFmpeg libass Support **macOS users**: The standard `ffmpeg` package from Homebrew does NOT include libass support (required for subtitle burning). You must install `ffmpeg-full`: ```bash # Remove standard ffmpeg (if installed) brew uninstall ffmpeg # Install ffmpeg-full (includes libass) brew install ffmpeg-full ``` **Verify libass support**: ```bash ffmpeg -filters 2>&1 | grep subtitles # Should output: subtitles V->V (...) ``` --- ## Usage ### In Claude Code Simply tell Claude to clip a YouTube video: ``` Clip this YouTube video: https://youtube.com/watch?v=VIDEO_ID ``` or ``` 剪辑这个 YouTube 视频：https://youtube.com/watch?v=VIDEO_ID ``` ### Workflow 1. **Environment Check** - Verifies yt-dlp, FFmpeg, and Python dependencies 2. **Video Download** - Downloads video (up to 1080p) and English subtitles 3. **AI Chapter Analysis** - Claude analyzes subtitles to generate semantic chapters (2-5 min each) 4. **User Selection** - Choose which chapters to clip and processing options 5. **Processing** - Clips video, translates subtitles, burns subtitles (if requested) 6. **Output** - Organized files in `./youtube-clips/<timestamp>/` ### Output Files For each clipped chapter: ``` ./youtube-clips/20260122_143022/ └── Chapter_Title/ ├── Chapter_Title_clip.mp4 # Original clip (no subtitles) ├── Chapter_Title_with_subtitles.mp4 # With burned subtitles ├── Chapter_Title_bilingual.srt # Bilingual subtitle file └── Chapter_Title_summary.md # Social media content ``` --- ## Configuration The skill uses environment variables for customization. Edit `~/.claude/skills/youtube-clipper/.env`: ### Key Settings ```bash # FFmpeg path (auto-detected if empty) FFMPEG_PATH= # Output directory (default: current working directory) OUTPUT_DIR=./youtube-clips # Video quality limit (720, 1080, 1440, 2160) MAX_VIDEO_HEIGHT=1080 # Translation batch size (20-25 recommended) TRANSLATION_BATCH_SIZE=20 # Target language for translation TARGET_LANGUAGE=中文 # Target chapter duration in seconds (180-300 recommended) TARGET_CHAPTER_DURATION=180 ``` For full configuration options, see [.env.example](.env.example). --- ## Examples ### Example 1: Extract highlights from a tech interview **Input**: ``` Clip this video: https://youtube.com/watch?v=Ckt1cj0xjRM ``` **Output** (AI-generated chapters): ``` 1. [00:00 - 03:15] AGI as an exponential curve, not a point in time 2. [03:15 - 06:30] China's gap in AI development 3. [06:30 - 09:45] The impact of chip bans ... ``` **Result**: Select chapters → Get clipped videos with bilingual subtitles + social media content ### Example 2: Create short clips from a course **Input**: ``` Clip this lecture video and create bilingual subtitles: https://youtube.com/watch?v=LECTURE_ID ``` **Options**: - Generate bilingual subtitles: Yes - Burn subtitles into video: Yes - Generate summary: Yes **Result**: High-quality clips ready for sharing on social media platforms --- ## Key Differentiators ### AI Semantic Chapter Analysis Unlike mechanical time-based splitting, this skill uses Claude's AI to: - Understand content semantics - Identify natural topic transitions - Generate meaningful chapter titles and summaries - Ensure complete coverage with no gaps **Example**: ``` ❌ Mechanical splitting: [0:00-30:00], [30:00-60:00] ✅ AI semantic analysis: - [00:00-03:15] AGI definition - [03:15-07:30] China's AI landscape - [07:30-12:00] Chip ban impacts ``` ### Batch Translation Optimization Translates 20 subtitles at once instead of one-by-one: - 95% reduction in API calls - 10x faster translation - Better translation consistency ### Bilingual Subtitle Format Generated subtitle files contain both English and Chinese: ```srt 1 00:00:00,000 --> 00:00:03,500 This is the English subtitle 这是中文字幕 2 00:00:03,500 --> 00:00:07,000 Another English line 另一行中文 ``` --- ## Troubleshooting ### FFmpeg subtitle burning fails **Error**: `Option not found: subtitles` or `filter not found` **Solution**: Install `ffmpeg-full` (macOS) or ensure `libass-dev` is installed (Ubuntu): ```bash # macOS brew uninstall ffmpeg brew install ffmpeg-full # Ubuntu sudo apt install ffmpeg libass-dev ``` ### Video download is slow **Solution**: Set a proxy in `.env`: ```bash YT_DLP_PROXY=http://proxy-server:port # or YT_DLP_PROXY=socks5://proxy-server:port ``` ### Subtitle translation fails **Cause**: API rate limiting or network issues **Solution**: The skill automatically retries up to 3 times. If persistent, check: - Network connectivity - Claude API status - Reduce `TRANSLATION_BATCH_SIZE` in `.env` ### Special characters in filenames **Issue**: Filenames with `:`, `/`, `?`, etc. may cause errors **Solution**: The skill automatically sanitizes filenames by: - Removing special characters: `/ \ : * ? " < > |` - Replacing spaces with underscores - Limiting length to 100 characters --- ## Documentation - **[SKILL.md](SKILL.md)** - Complete workflow and technical details - **[TECHNICAL_NOTES.md](TECHNICAL_NOTES.md)** - Implementation notes and design decisions - **[FIXES_AND_IMPROVEMENTS.md](FIXES_AND_IMPROVEMENTS.md)** - Changelog and bug fixes - **[references/](references/)** - FFmpeg, yt-dlp, and subtitle formatting guides --- ## Contributing Contributions are welcome! Please: - Report bugs via [GitHub Issues](https://github.com/op7418/Youtube-clipper-skill/issues) - Submit feature requests - Open pull requests for improvements --- ## License This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. --- ## Acknowledgements - **[Claude Code](https://claude.ai/claude-code)** - The AI-powered CLI tool - **[yt-dlp](https://github.com/yt-dlp/yt-dlp)** - YouTube download engine - **[FFmpeg](https://ffmpeg.org/)** - Video processing powerhouse --- <div align="center"> **Made with ❤️ by [op7418](https://github.com/op7418)** If this skill helps you, please give it a ⭐️ </div>

Carregando o README do repositório…

Skills neste repositório

Técnicos de áudio e vídeo

1 categorias ocupacionais · 100% classificado

skill

ocupação

descrição

atualizado

youtube-clipper

Técnicos de áudio e vídeo

YouTube 视频智能剪辑工具。下载视频和字幕，AI 分析生成精细章节（几分钟级别），用户选择片段后自动剪辑、翻译字幕为中英双语、烧录字幕到视频，并生成总结文案。使用场景：当用户需要剪辑 YouTube 视频、生成短视频片段、制作双语字幕版本时。关键词：视频剪辑、YouTube、字幕翻译、双语字幕、视频下载、clip video

Idioma do texto original: chinês

2026-01-22

Mostrando 1 de 1 skills coletadas.

Instalar com um assistente de IA

Copie este prompt para o assistente de IA que você usa.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/op7418/Youtube-clipper-skill.