# 🎬 MixCut-Skill

English | 简体中文

--- ### 🗺️ Navigation [Features](#-features) • [Installation](#-installation) • [Usage](#-usage) • [Requirements](#-requirements) • [Configuration](#-configuration) • [Troubleshooting](#-troubleshooting) • [Credits](#-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](https://www.youtube.com) - 🚀 **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 | 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 | ## ⚙️ 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: ```env # 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: ```bash npx skills add mixcut-skill ``` ## 📖 Usage Run the `mixcut` task to start the interactive workflow: ```bash # 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](https://github.com/op7418/Youtube-clipper-skill) - Inspiration and foundational logic for YouTube processing. - [Remotion](https://www.remotion.dev/) - The incredible framework for creating videos with React. ## 📈 Star History [![Star History Chart](https://api.star-history.com/svg?repos=garroshub/MixCut-Skill&type=Date)](https://star-history.com/#garroshub/MixCut-Skill&Date) ---

Built with ❤️ by Garros Gong

mixcut

Installation

SKILL.md