major-ai-skills/skills/pro-tools/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: "Avid Pro Tools Ultimate Audio Engineering AI Skill Guide (Gemini)"
description: "Comprehensive operational skill specification for Google Gemini to visually diagnose, automate, script, and troubleshoot Pro Tools Edit Windows, Mix Window inserts/sends, Beat Detective slicing, and Clip Gain lines."
category: "Professional Audio Recording & Mixing"
tags: ["pro-tools", "edit-window", "mix-window", "gemini", "beat-detective", "clip-gain", "smart-tool"]
---


# Avid Pro Tools Ultimate Audio Engineering AI Skill Guide (Gemini)

## Overview & Engine Architecture
Avid Pro Tools Ultimate provides an industry-standard visual editing environment featuring the **Edit Window with Smart Tool cursor states (Trim, Select, Grabber, Fade)**, the **Mix Window with 10 Inserts and 10 Sends per channel**, inline **Clip Gain waveform lines**, and the **Beat Detective transient analysis HUD**. Gemini acts as an AI Audio Post-Production Reviewer and Scoring Mixer, specializing in **multimodal Edit Window waveform alignment**, **Beat Detective rhythmic quantize slicing**, **Clip Gain automation curve inspection**, and **Mix Window routing verification**.

### Visual Analytics & Post-Production Console Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 Pro Tools Visual Operations                 │
│                                                             │
│  Editing & Arranger Viewports                               │
│  ├── Edit Window (Shuffle, Slip, Spot, Grid Editing Modes)  │
│  ├── Smart Tool Cursor States (Trim, Selector, Grabber, Fade│
│  ├── Clip Gain Waveform Envelopes (Pre-FX Dynamic Leveling) │
│  └── Beat Detective HUD (Transient Sensitivity Sliders)     │
│                                                             │
│  Mixing, Routing & Metering                                 │
│  ├── Mix Window (10 Inserts A-J, 10 Sends A-J, VCA Masters) │
│  ├── Channel Strip Meters (Pro Tools Classic, K-12, K-14, VU│
│  └── Dolby Atmos 3D Object Panning Grid HUD                 │
└─────────────────────────────────────────────────────────────┘
```

---


## Operational Capabilities & Agent Directives

1. **Multimodal Edit Window Inspection**: Analyze screenshots of the Edit Window to detect non-crossfaded clip edits, waveform phase cancellation, un-aligned multi-mic drum transients, and clip gain overshoots.
2. **Beat Detective Transient Analysis**: Guide users in calibrating transient sensitivity sliders to slice drum stems accurately at transient peaks without false triggers.
3. **Clip Gain Pre-FX Leveling Review**: Inspect clip gain lines to ensure dialogue and vocal stems are leveled before entering outboard hardware compressors or AAX insert chains.
4. **Mix Window Routing & Bus Auditing**: Validate internal bus routing (Drums Bus, Guitars Bus, Vocals Bus, All Music Bus, Print Track) to ensure proper mix stem print setups.

---


## Production Python Automation: Automated Pro Tools Session File (`.ptx`) Inspector

Run this script to inspect basic file header metadata and asset references from an Avid Pro Tools session file (`.ptx`):

```python
"""
Pro Tools Session (.ptx) File Header Inspector
Extracts session metadata markers and audio file references from Pro Tools session files.
"""

import sys
import os
import re

def inspect_protools_session(ptx_path: str):
    if not os.path.exists(ptx_path):
        print(f"Error: Pro Tools session '{ptx_path}' not found.")
        return

    print(f"--- [INSPECTING PRO TOOLS SESSION: {ptx_path}] ---")
    
    with open(ptx_path, "rb") as f:
        content = f.read()

    # Search for Track Names in PTX Binary Chunks
    track_matches = re.findall(rb"(?:Audio|Aux|Master|MIDI|Inst|VCA)\s*Track[^\x00]*?\x00([a-zA-Z0-9_\-\s]{2,30})\x00", content)
    unique_tracks = list(set([t.decode('ascii', errors='ignore') for t in track_matches if len(t) > 2]))

    print(f"• File Size:          {len(content) / (1024*1024):.2f} MB")
    print(f"• Detected Tracks:    {len(unique_tracks)}")

    if unique_tracks:
        print("\nIdentified Session Tracks:")
        for trk in unique_tracks[:12]:
            print(f"  • {trk}")

    # Search for Audio File References (.wav)
    wav_matches = re.findall(rb"[a-zA-Z0-9_\-\s\(\)]+\.(?:wav|WAV)", content)
    unique_wavs = list(set([w.decode('ascii', errors='ignore') for w in wav_matches]))
    print(f"\n• Audio File Assets in Session: {len(unique_wavs)}")

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("Usage: python3 inspect_ptx.py <Session.ptx>")
        sys.exit(1)
    inspect_protools_session(sys.argv[1])
```

---


## Technical Troubleshooting Matrix

| Issue & Visual Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **Beat Detective Slices Create Phase Clicks** | Slicing occurred after transient zero-crossing or crossfades were omitted. | In Beat Detective $\rightarrow$ Step 3 (Edit Smoothing) $\rightarrow$ Select **Fill and Crossfade** $\rightarrow$ Set crossfade length to `5ms`. |
| **Edit Mode Inadvertently Moves Entire Timeline** | Edit mode set to `Shuffle` instead of `Slip` or `Grid`. | Press `F2` to switch to **Slip Mode** or `F4` for **Grid Mode**. |
| **Track Automation Fader Jumps Automatically** | Automation mode set to `Read` while attempting live manual adjustments. | Switch channel automation mode to `Touch` or `Latch` to record new fader movements. |
| **Mix Window Inserts Missing from Channel Strip** | Inserts A-E or F-J view toggled OFF in Mix Window View selector. | In bottom-left Mix Window View menu $\rightarrow$ Check **Inserts A-E** and **Inserts F-J**. |

---


## Command Line Syntax & Server Control

```bash
# Launch Pro Tools with Session File
"C:\Program Files\Avid\Pro Tools\ProTools.exe" "C:\Sessions\FilmCue_Reel1.ptx"

# Query Active Audio Engine Drivers
system_profiler SPAudioDataType
```

### Key Configuration Locations
- **Pro Tools Sessions**: `*.ptx`
- **Track Presets**: `~/Documents/Pro Tools/Track Presets/`

---


## Agent Operational Directive
> **MANDATORY**: When using Beat Detective for drum multitrack editing, always execute Step 3 "Edit Smoothing" with a 5ms crossfade to eliminate micro-gaps and zero-crossing clicks between sliced audio clips.