roblox-clip-transformer（roblox 夹式变压器）

Roblox Clip Transformer

Transform raw Roblox gameplay into polished, platform-ready promotional clips in minutes.

What This Skill Does

Takes raw Roblox screen recordings and produces edited vertical/horizontal videos optimized for TikTok, YouTube Shorts, and Instagram Reels.

Core Capabilities:

• Aspect ratio conversion (16:9 → 9:16)
• Smart action detection and trimming
• Beat-synced transitions
• Auto-generated captions
• Brand overlay support

Quick Start

# Basic usage - horizontal to vertical
roblox-transform input.mp4 --output output.mp4 --platform tiktok

# With captions
roblox-transform input.mp4 --output output.mp4 --platform shorts --captions

# Full trailer mode
roblox-transform input.mp4 --output output.mp4 --platform tiktok --trailer --title "My Game" --cta "Play Now!"

Workflow

1. Analyze Footage

The skill automatically detects:

• Action moments (movement, transitions, key events)
• Dead time (menus, loading screens)
• Audio peaks (for caption timing)

python scripts/analyze-footage.py input.mp4 --output analysis.json

2. Configure Platform

Each platform has specific requirements:

See references/platform-specs.md for full details.

3. Generate Output

python scripts/platform-render.py input.mp4 \
  --analysis analysis.json \
  --platform tiktok \
  --output final.mp4

Features

Smart Trimming

Automatically removes:

• Menu screens
• Loading screens
• AFK/idle moments
• Repetitive sequences

Aspect Ratio Conversion

Converts horizontal gameplay to vertical while:

• Centering key action
• Adding blurred background fill
• Preserving important elements

Music Sync

Beat-synchronized transitions using:

• Royalty-free tracks in assets/music/
• Custom audio with --music path/to/track.mp3

Auto Captions

Generates timed subtitles:

• Extracts audio with Whisper
• Syncs to video timeline
• Styles for readability

python scripts/caption-sync.py input.mp4 --output captions.srt

Brand Overlays

Add:

• Game logo (PNG with transparency)
• Watermark
• Call-to-action text
• Title cards

Scripts Reference

Requirements

System Dependencies:

• FFmpeg (for video processing)
• Python 3.10+
• Whisper (for captions, optional)

Python Packages:

• ffmpeg-python
• librosa (for beat detection)
• openai-whisper (for captions)

Install with:

pip install ffmpeg-python librosa openai-whisper

Examples

Example 1: Basic Vertical Clip

roblox-transform gameplay.mp4 --output tiktok.mp4 --platform tiktok

Example 2: Vertical with Captions

roblox-transform gameplay.mp4 --output shorts.mp4 --platform shorts --captions --language en

Example 3: Game Trailer Mode

roblox-transform gameplay.mp4 \
  --output trailer.mp4 \
  --platform tiktok \
  --trailer \
  --title "Escape the Castle" \
  --logo assets/logo.png \
  --cta "Play Now!"

Example 4: Multi-Platform Export

# Generate for all platforms
roblox-transform gameplay.mp4 --output-dir ./exports --platform all

Output Structure

exports/
├── tiktok_916_30fps.mp4
├── shorts_916_30fps.mp4
├── reels_916_30fps.mp4
└── youtube_169_30fps.mp4

Limitations

• Best results with gameplay 30+ seconds
• Caption accuracy depends on audio clarity
• Beat sync works best with music-heavy sections

Troubleshooting

"FFmpeg not found"

• Install FFmpeg: apt install ffmpeg or brew install ffmpeg

"Whisper failed"

• Captions optional - skip with --no-captions
• Or install: pip install openai-whisper

"Output too long"

• Use --max-duration 60 to limit length
• Smart trim will prioritize best moments

Next Steps

1. Place raw gameplay in your working directory
2. Run basic transformation: roblox-transform input.mp4 -o output.mp4 -p tiktok
3. Review output and adjust settings
4. Add brand elements for polished trailer

For advanced usage, see references/brand-templates.md.