video-processing

name: video-processing description: "Process video files with ffmpeg automation. Use when: compressing videos for upload; extracting audio from video; resizing for social formats; clipping segments; merging multiple videos; generating thumbnails" license: MIT metadata: author: ClawFu version: 1.0.0 mcp-server: "@clawfu/mcp-skills"

Video Processing

Automate repetitive video editing tasks using FFmpeg - the industry-standard tool powering YouTube, Netflix, and most video platforms.

When to Use This Skill

• Social media optimization - Resize videos for Instagram (9:16), TikTok, LinkedIn
• Upload preparation - Compress large videos to meet platform limits
• Audio extraction - Pull audio from webinars, interviews for podcasts
• Content clipping - Extract highlights, quotes, or segments
• Batch processing - Apply same operations to multiple videos

What Claude Does vs What You Decide

Dependencies

pip install ffmpeg-python moviepy click
# Also requires ffmpeg installed on system
# macOS: brew install ffmpeg
# Ubuntu: sudo apt install ffmpeg

Commands

Compress Video

python scripts/main.py compress video.mp4 --target-mb 10
python scripts/main.py compress video.mp4 --crf 28 --output compressed.mp4

Extract Audio

python scripts/main.py extract-audio video.mp4 --format mp3
python scripts/main.py extract-audio video.mp4 --format wav --output audio.wav

Resize for Social

python scripts/main.py resize video.mp4 --format instagram  # 1080x1920 (9:16)
python scripts/main.py resize video.mp4 --format youtube    # 1920x1080 (16:9)
python scripts/main.py resize video.mp4 --format square     # 1080x1080 (1:1)
python scripts/main.py resize video.mp4 --width 1280 --height 720

Clip Segment

python scripts/main.py clip video.mp4 --start 00:30 --end 01:45
python scripts/main.py clip video.mp4 --start 00:30 --duration 60

Merge Videos

python scripts/main.py concat video1.mp4 video2.mp4 --output merged.mp4
python scripts/main.py concat ./clips/ --output compilation.mp4

Generate Thumbnail

python scripts/main.py thumbnail video.mp4 --time 00:30
python scripts/main.py thumbnail video.mp4 --best  # Auto-select best frame

Examples

Example 1: Prepare Video for Instagram Reels

# Original: 4K horizontal video, 500MB
python scripts/main.py resize long-video.mp4 --format instagram
python scripts/main.py compress long-video_instagram.mp4 --target-mb 50

# Output: long-video_instagram_compressed.mp4 (1080x1920, <50MB)

Example 2: Extract Podcast from Webinar

# Extract audio track
python scripts/main.py extract-audio webinar-recording.mp4 --format mp3 --bitrate 192k

# Output: webinar-recording.mp3 (ready for podcast hosting)

Example 3: Create Highlight Reel

# Extract multiple clips
python scripts/main.py clip interview.mp4 --start 05:30 --end 06:15 --output clip1.mp4
python scripts/main.py clip interview.mp4 --start 12:00 --end 12:45 --output clip2.mp4
python scripts/main.py clip interview.mp4 --start 28:30 --end 29:00 --output clip3.mp4

# Merge into highlight reel
python scripts/main.py concat clip1.mp4 clip2.mp4 clip3.mp4 --output highlights.mp4

Social Media Format Reference

Performance Tips

1. GPU acceleration - FFmpeg uses hardware encoding when available (NVENC, VideoToolbox)
2. CRF values - Lower = better quality, larger file. 18-28 typical range
3. Preset selection - ultrafast for drafts, slow for final exports
4. Two-pass encoding - Better quality for target bitrate

Skill Boundaries

What This Skill Does Well

• Structuring audio production workflows
• Providing technical guidance
• Creating quality checklists
• Suggesting creative approaches

What This Skill Cannot Do

• Replace audio engineering expertise
• Make subjective creative decisions
• Access or edit audio files directly
• Guarantee commercial success

Related Skills

• whisper-transcription - Transcribe video audio
• youtube-downloader - Download videos to process
• image-batch - Process video thumbnails

Skill Metadata

• Mode: cyborg

category: automation
subcategory: video-processing
dependencies: [ffmpeg-python, moviepy]
difficulty: beginner
time_saved: 5+ hours/week