English | 简体中文
Features • Installation • Usage • Requirements • Configuration • Troubleshooting • Credits
MixCut-Skill is a high-performance tool designed to transform long YouTube videos into professional, mixed-cut short clips. By leveraging advanced AI for content analysis and Remotion for programmatic video rendering, it streamlines the workflow from raw footage to social-media-ready content.
- ✅ Currently Optimized for: YouTube
- 🚀 Roadmap: Future support planned for Bilibili, Local Video Files, Twitter/X, and TikTok/Instagram layouts.
- 🤖 AI-Driven Highlight Selection
Automatically identifies high-engagement segments and key talking points using large language models. - 🧹 Automated Subtitle Cleaning
Intelligent preprocessing that removes speaker cues (e.g.,>>), time-sync artifacts, and verbal fillers for a cleaner viewing experience. - 🌍 Professional Translation Engine
Integrated multi-stage translation pipeline ensuring context-aware and accurate bilingual subtitles. - 🎨 Remotion Rendering
High-quality, frame-perfect video rendering powered by Remotion, enabling complex layouts and smooth transitions. - ⚡ High Performance
Optimized processing pipeline to minimize time from download to final render.
| Dependency | Version | Purpose |
|---|---|---|
| Python | 3.10+ | Backend logic, YouTube processing, and AI orchestration |
| Node.js | 18+ | Remotion rendering and frontend components |
| FFmpeg | Latest | Media normalization, clipping, and encoding |
| yt-dlp | Latest | High-speed YouTube video and subtitle extraction |
The tool requires an .env file in the project root to manage API keys for AI analysis.
Create a .env file and add the following:
# AI Provider Keys
OPENAI_API_KEY=your_openai_key_here
ANTHROPIC_API_KEY=your_anthropic_key_here
DEEPSEEK_API_KEY=your_deepseek_key_here
# Optional: FFmpeg Path (if not in System PATH)
# FFMPEG_PATH=C:\ffmpeg\bin\ffmpeg.exeAdd MixCut-Skill to your project using the standard skills command:
npx skills add mixcut-skillRun the mixcut task to start the interactive workflow:
# Example command to trigger the skill
/mixcutThe AI assistant will guide you through: Providing YouTube URLs -> AI analysis -> Selecting highlights -> Customizing style -> Final rendering.
- FFmpeg Not Found: Ensure FFmpeg is installed and added to your system
PATH. On Windows, you can explicitly setFFMPEG_PATHin your.envfile. - Remotion Rendering Errors:
- Ensure all Node dependencies are installed:
cd remotion && npm install. - Check if your GPU drivers are up to date, as Remotion uses Chromium for rendering.
- If rendering fails on headless servers, ensure
xvfbor equivalent is configured.
- Ensure all Node dependencies are installed:
Special thanks to the following projects:
- Youtube-clipper-skill - Inspiration and foundational logic for YouTube processing.
- Remotion - The incredible framework for creating videos with React.
Built with ❤️ by Garros Gong