MixCut Skill

MixCut Skill

CRITICAL INSTRUCTION: MANDATORY CONFIGURATION

You MUST NOT proceed to downloading or processing until the Project Configuration is fully defined.

Step 1: The Configuration Gate Check if the user has provided ALL of the following:

• Video Title: Main title for intro and segment cards.
• Caption Language: Target language for subtitles (e.g., English, etc.). Crucial: No bilingual output.
• Aspect Ratio: 16:9 (Desktop), 9:16 (Shorts/​TikTok), or 1:1.
• Target Duration: 30s, 60s, 120s, or 180s.
• Pace: Fast, Medium, or Slow.
• Style: Highlight Montage or Beat-cut.
• Transitions: none, fade, slide, flash, or glitch.

If ANY of these are missing, you MUST use the AskUserQuestion tool to obtain them. DO NOT assume defaults. DO NOT start downloading until configuration is complete.

Workflow

Phase 1: Sources & Workspace Setup

1. Gather Sources: Ask for YouTube URLs from the user.
2. Setup Workspace:
   • Ensure the directory ./​work exists in the project root.
   • Prepare ./​work/​assets and ./​work/​outputs subdirectories.

Phase 2: Content Analysis

For each YouTube URL provided:

1. Download:
   • Run python skills/​Youtube-clipper-skill/​scripts/​download_video.py <url> "./​work/​assets/​youtube"
2. Analyze:
   • Run python skills/​Youtube-clipper-skill/​scripts/​analyze_subtitles.py <subtitle_path>
3. Selection:
   • Present analyzed chapters/​highlights to the user.
   • Confirm which segments to include in the final cut.

Phase 3: Assembly & Processing

1. Configuration: Create ./​work/​mixcut_config.json with global settings and source clip metadata (start, end, title).
2. Processing:
   • Run python skills/​mixcut/​scripts/​process_mixcut.py "./​work/​mixcut_config.json"
   • This script automates clipping, media normalization (ffmpeg), and generates the initial timeline.json and final.srt.

Phase 4: Professional Subtitle Cleaning (Agent-Driven)

This phase ensures high-quality, professional subtitles.

1. Read Timeline: Access ./​work/​timeline.json.
2. Subtitle Optimization: Iterate through all subtitle entries and apply the following cleaning logic:
   • Remove Noise: Strip speaker markers (e.g., >>, >>>) and sound cues (e.g., [Music], [Applause]).
   • Deduplication: Remove repeated words, stutters, and verbal fillers ("uh", "um", "you know").
   • Flow Improvement: Merge fragmented phrases into natural, readable sentences.
   • Professional Polish: Refine text into the target language using appropriate technical terminology.
3. Update: Save the optimized content back to ./​work/​timeline.json.
4. Synchronize: Run python skills/​mixcut/​scripts/​process_mixcut.py "./​work/​mixcut_config.json" --action generate_srt to sync changes to final.srt.

Phase 5: Rendering

1. Delegate to Remotion:
   • Use the remotion skill to render the project located in skills/​mixcut/​remotion.
   • Provide the absolute path to ./​work/​timeline.json as input props.
   • Set output to ./​work/​outputs/​final_mixcut.mp4.

Phase 6: Delivery Guard & Verification

Mandatory verification before completion.

1. Integrity Check:
   • Verify ./​work/​outputs/​final_mixcut.mp4 exists and has a file size > 0.
   • Verify ./​work/​outputs/​final.srt exists and has a file size > 0.
2. Troubleshooting: If files are missing or empty, identify the failure point in previous phases and re-run the necessary steps.

Phase 7: Completion & Cleanup

1. Report: Provide the paths to the final video and subtitle files.
2. Retention Policy: Do NOT delete the ./​work directory until the user explicitly confirms the results or you have verified the outputs physically.

Technical Guidelines

• Path Management: Always use absolute paths when delegating tasks to external skills.
• Cross-Platform: Avoid hardcoding drive letters; use system-agnostic path resolution.
• Performance: Use parallel tool calls for independent download/​analysis tasks where supported.