major-ai-skills/skills/ableton-live/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: "Ableton Live 12 Music Production & Performance AI Skill Guide (Gemini)"
description: "Comprehensive operational skill specification for Google Gemini to visually diagnose, automate, script, and troubleshoot Ableton Live Session View grids, Arrangement automation curves, Device Chain Macro racks, and Drum Racks."
category: "Live Performance & Electronic Music Production"
tags: ["ableton-live", "session-view", "device-racks", "gemini", "drum-rack", "arrangement-automation"]
---

# Ableton Live 12 Music Production & Performance AI Skill Guide (Gemini)

## Overview & Engine Architecture
Ableton Live provides a high-density, dual-view interface optimized for stage performance and studio mixing. It integrates the matrix-based **Session View clip launcher**, linear **Arrangement View with breakpoint automation curves**, **Instrument/Audio Effect Macro Racks**, and **128-pad Drum Racks**. Gemini acts as an AI Music Production Reviewer and Electronic Audio Engineer, specializing in **multimodal Session View clip matrix inspection**, **Arrangement automation curve optimization**, **Device Chain gain staging audits**, and **Drum Rack parallel processing**.

### Visual Analytics & Production Interface Stack

```
┌─────────────────────────────────────────────────────────────┐
│                 Ableton Live Visual Operations              │
│                                                             │
│  Session & Arrangement Interface Matrix                     │
│  ├── Session View Grid (Clip Slots, Stop Buttons, Status LED)│
│  ├── Arrangement Timeline (Track Lanes, Breakpoint Envelopes│
│  └── Master Channel & Cue Out (Headphone Bus, Peak Meters)  │
│                                                             │
│  Device Chain & Instrument Racks                            │
│  ├── Instrument / Drum Rack (16/128 Pads, Choke Groups)     │
│  ├── Macro Controls (Macro 1-16 Knobs & Modulation Mappings)│
│  └── Spectrum Analyzer & Utility Plugins (Stereo Width / Phase)│
└─────────────────────────────────────────────────────────────┘
```

---

## Operational Capabilities & Agent Directives

1. **Multimodal Session Grid Inspection**: Analyze screenshots of Session View clip grids to detect un-warped audio clips, mismatched loop lengths, missing stop buttons, and clip launch quantization indicators.
2. **Gain Staging & Peak Meter Review**: Audit channel peak meters to ensure tracks maintain healthy headroom ($-6\text{dB}$ to $-12\text{dB}$ RMS) without red-clipping on the Master summing bus.
3. **Macro Rack Mapping Validation**: Review Instrument and Audio Effect Racks to ensure macro knob ranges are bounded (*e.g. Filter Frequency $20\text{Hz}-20\text{kHz}$ with exponential curve scaling*).
4. **Drum Rack & Choke Group Auditing**: Verify that open and closed hi-hat pads are assigned to matching Choke Groups to prevent unnatural simultaneous sample playback.

---

## Production Python Automation: Automated Ableton Set (`.als`) XML Parser & BPM Extractor

Ableton Live `.als` project files are Gzip-compressed XML documents. Run this script to extract project tempo, time signature, and track lists from any `.als` file:

```python
"""
Ableton Live Set (.als) XML Project Inspector
Decompresses Gzip .als project archives and extracts tempo, tracks, and warp modes.
"""

import sys
import os
import gzip
import xml.etree.ElementTree as ET

def inspect_ableton_set(als_path: str):
    if not os.path.exists(als_path):
        print(f"Error: Ableton set '{als_path}' not found.")
        return

    print(f"--- [INSPECTING ABLETON LIVE SET: {als_path}] ---")
    try:
        with gzip.open(als_path, "rb") as f:
            xml_data = f.read()
            root = ET.fromstring(xml_data)

        # 1. Extract Master Tempo
        tempo_elem = root.find(".//Tempo/Manual")
        tempo = tempo_elem.attrib.get("Value") if tempo_elem is not None else "120.0"

        # 2. Extract Tracks
        tracks = root.findall(".//Tracks/*")
        print(f"• Master Tempo: {float(tempo):.2f} BPM")
        print(f"• Total Tracks: {len(tracks)}\n")

        print("--- [TRACK HIERARCHY] ---")
        for idx, track in enumerate(tracks, 1):
            name_elem = track.find(".//EffectiveName")
            track_name = name_elem.attrib.get("Value") if name_elem is not None else f"Track {idx}"
            track_type = track.tag
            print(f"• #{idx:>2} [{track_type:<14}]: {track_name}")

    except Exception as e:
        print(f"Failed to parse .als file: {e}")

if __name__ == "__main__":
    if len(sys.argv) < 2:
        print("Usage: python3 inspect_als.py <MyProject.als>")
        sys.exit(1)
    inspect_ableton_set(sys.argv[1])
```

---

## Technical Troubleshooting Matrix

| Issue & Visual Signature | Root Cause Analysis | Diagnostic & Resolution Pathway |
| :--- | :--- | :--- |
| **Clip Header Shows Orange `BPM 98.42` / Drifts Off-Beat** | Auto-Warp algorithm miscalculated tempo of imported audio sample. | In Clip View $\rightarrow$ Click **Warp** $\rightarrow$ Set Warp Mode to **Complex Pro** $\rightarrow$ Type exact known BPM in Seg. BPM box. |
| **Master Bus Meter Clips Red (+3dB)** | Summed audio from multiple tracks exceeding 0dBFS without proper bus gain staging. | 1. Insert **Utility** device on individual tracks $\rightarrow$ Lower gain by $-6\text{dB}$.<br>2. Avoid pulling down the Master fader; maintain master at $0.0\text{dB}$. |
| **Arrangement Automation Curves Greyed Out** | User manually tweaked a parameter during playback, triggering the "Back to Arrangement" override. | Click the orange **Back to Arrangement** button (single right-arrow icon) in the top transport bar. |
| **Drum Rack Pad Cut-off Click / Pop Sound** | Sample playback envelope has instantaneous 0ms Attack/Release time. | In Simpler/Sampler on the pad $\rightarrow$ Increase Attack to $2.0\text{ms}$ and Release to $10.0\text{ms}$. |

---

## Command Line Syntax & Server Control

```bash
# Decompress Ableton Set (.als) to Readable XML
gzip -dc "MyProject.als" > "MyProject.xml"

# Re-compress XML back to valid Ableton Set
gzip -c "MyProject.xml" > "MyProject_Repack.als"
```

### Key Configuration Locations
- **Ableton Project Files**: `*.als`
- **Default Live Template**: `%APPDATA%\Ableton\Live 12\Preferences\Templates\`

---

## Agent Operational Directive
> **MANDATORY**: When inspecting Ableton Live projects, verify that tracks do not clip red on the master meter. If automation is inactive, check the orange "Back to Arrangement" button in the transport bar.