MixCut-Skill

🎬 MixCut-Skill

🗺️ Navigation

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.

🎯 Platform Scope

• ✅ Currently Optimized for: YouTube
• 🚀 Roadmap: Future support planned for Bilibili, Local Video Files, Twitter/X, and TikTok/Instagram layouts.

🚀 Features

• 🤖 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.

🛠️ Requirements

⚙️ Configuration

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.exe

📦 Installation

Add MixCut-Skill to your project using the standard skills command:

npx skills add mixcut-skill

📖 Usage

Run the mixcut task to start the interactive workflow:

# Example command to trigger the skill
/mixcut

The AI assistant will guide you through: Providing YouTube URLs -> AI analysis -> Selecting highlights -> Customizing style -> Final rendering.

🔧 Troubleshooting

• FFmpeg Not Found: Ensure FFmpeg is installed and added to your system PATH. On Windows, you can explicitly set FFMPEG_PATH in your .env file.
• 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 xvfb or equivalent is configured.

🤝 Credits

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.

📈 Star History