major-ai-skills/skills/vegas-pro/gemini.md

Installable agentic skills / AI agent skills (SKILL.md) for Claude Code, Cursor, Codex CLI, Gemini CLI & Antigravity - 402+ professional app, token-efficiency, and common-sense skills. SEO/GEO ready.

---

title: "MAGIX VEGAS Pro NLE & Automation AI Skill Guide (Gemini)"
description: "Comprehensive operational skill specification for Google Gemini to visually diagnose, automate, script, and troubleshoot VEGAS Pro multi-track timelines, Video Preview viewports, Event Pan/Crop masks, and OFX Video FX chains."
category: "Non-Linear Video & Audio Editing"
tags: ["vegas-pro", "timeline-ui", "video-preview", "event-pan-crop", "gemini", "ofx-plugins", "video-scopes"]
---


# MAGIX VEGAS Pro NLE & Automation AI Skill Guide (Gemini)

## Overview & Engine Architecture
MAGIX VEGAS Pro provides a responsive multi-track editing workspace featuring the **Timeline (Audio/Video Tracks, Track Motion, Compositing Modes)**, the **Video Preview window with real-time hardware scaling**, the **Event Pan/Crop keyframe masking interface**, and the **OpenFX (OFX) Video Effects chain**. Gemini acts as an AI Video Production Reviewer and Post-Production Technical Auditor, specializing in **multimodal Timeline arrangement inspection**, **Event Pan/Crop aspect ratio alignment**, **OFX effect chain optimization**, and **Video Preview framerate diagnostics**.

### Visual Analytics & Production Workspace Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 VEGAS Pro Visual Operations                 │
│                                                             │
│  Editing & Multi-Track Viewports                            │
│  ├── Multi-Track Timeline (Ripple Modes, Crossfade Handles) │
│  ├── Track Headers (Mute, Solo, Level Faders, Track Motion) │
│  └── Trimmer Viewport (In/Out Point Scrubbing, Quick Chop)  │
│                                                             │
│  Visual Effects & Geometry Transformations                  │
│  ├── Event Pan/Crop HUD (Bézier Masking, Position Keyframes)│
│  ├── Video FX Window (OFX Parameters, Color Grading Curves) │
│  └── Video Preview Window (Draft, Good, Best Quality Modes) │
│                                                             │
│  Diagnostic Scopes & Audio Mixing                           │
│  ├── Video Scopes HUD (RGB Parade, Vectorscope, Histogram)  │
│  └── Master Bus Audio Meters (Peak/RMS Multi-Channel Faders)│
└─────────────────────────────────────────────────────────────┘
```

---


## Operational Capabilities & Agent Directives

1. **Multimodal Timeline Inspection**: Analyze screenshots of the VEGAS Pro timeline to detect accidental gap cuts, overlapping events without automatic crossfading, disabled tracks (muted/hidden), and sync lock status.
2. **Event Pan/Crop Aspect Ratio Diagnostics**: Review Event Pan/Crop windows to ensure imported media ($4:3, 9:16, 21:9$) matches project dimensions ($16:9$ 1080p/4K) without black pillarbox/letterbox bars.
3. **Video Preview Quality & Performance Triage**: Guide users in toggling between Preview modes (*Draft Auto vs Best Full*) to optimize real-time playback on complex multi-layer timelines.
4. **OFX Effect Chain & Color Grading Review**: Evaluate OpenFX filter chains to ensure color grading plugins are applied in correct logical sequence (Input Rec.709 Transform $\rightarrow$ Primary Exposure $\rightarrow$ Creative Look $\rightarrow$ Limiter).

---


## Production Python Automation: Automated VEGAS Project (`.veg`) Binary Header Inspector

Run this script to inspect basic file header metadata and asset references in a MAGIX VEGAS Pro `.veg` project file:

```python
"""
MAGIX VEGAS Pro Project (.veg) Binary Header Inspector
Parses VEGAS Pro binary project files to extract media asset file references.
"""

import sys
import os
import re

def inspect_vegas_project(veg_path: str):
    if not os.path.exists(veg_path):
        print(f"Error: VEGAS project file '{veg_path}' not found.")
        return

    print(f"--- [INSPECTING VEGAS PRO PROJECT: {veg_path}] ---")
    
    with open(veg_path, "rb") as f:
        content = f.read()

    # Search for Audio/Video Asset Paths in Binary Stream
    asset_matches = re.findall(rb"[a-zA-Z]:\\[^:\*\?\"\<\>\|\x00-\x1F]+\.(?:mp4|mov|avi|wav|mp3|png|jpg)", content, re.IGNORECASE)
    unique_assets = list(set([a.decode('ascii', errors='ignore') for a in asset_matches]))

    print(f"• File Size:          {len(content) / (1024*1024):.2f} MB")
    print(f"• Media Assets Found: {len(unique_assets)} file reference(s)")

    if unique_assets:
        print("\nReferenced Media Assets in Project:")
        for asset in unique_assets[:10]:
            print(f"  • {asset}")

    print("\n✅ VEGAS project binary structure parsed successfully.")

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("Usage: python3 inspect_veg.py <Project.veg>")
        sys.exit(1)
    inspect_vegas_project(sys.argv[1])
```

---


## Technical Troubleshooting Matrix

| Issue & Visual Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **Video Has Black Bars (Pillarboxes) on Sides** | Source media aspect ratio differs from project properties (e.g. 4:3 video on 16:9 timeline). | Right-click video event $\rightarrow$ Select **Event Pan/Crop** $\rightarrow$ Right-click canvas $\rightarrow$ Select **Match Output Aspect**. |
| **Video Preview Stutters on Crossfades** | Full-resolution 32-bit floating point processing enabled on integrated graphics. | Set Video Preview quality to **Preview (Auto)** or change Project Pixel Format from 32-bit float to **8-bit**. |
| **Audio Event Missing on Video Drag-and-Drop** | "Ignore Event Grouping" was enabled, unlinking audio and video tracks. | Press `Ctrl + Shift + U` or toggle the **Ignore Event Grouping** button in the bottom toolbar. |
| **Rendered Video Displays Interlaced Horizontal Lines** | Field order set to `Upper Field First` on progressive display output. | In Project Properties and Render Template, set **Field order** to `None (progressive scan)`. |

---


## Command Line Syntax & Server Control

```bash
# Launch VEGAS Pro 22
"C:\Program Files\VEGAS\VEGAS Pro 22.0\vegaspro.exe"

# Open Specific Project Directly
"C:\Program Files\VEGAS\VEGAS Pro 22.0\vegaspro.exe" "C:\Projects\Commercial_Spot.veg"
```

### Key Configuration Locations
- **Project Files**: `*.veg`, `*.bak`
- **Render Templates**: `%APPDATA%\VEGAS Pro\22.0\Render Templates\`

---


## Agent Operational Directive
> **MANDATORY**: When video clips display unwanted black bars around the frame in VEGAS Pro, always guide the user to right-click inside Event Pan/Crop and choose "Match Output Aspect".