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.