---
name: beatlab-pipeline
description: Deterministic BeatLab pipeline utilities (validate, render grid, export MIDI/WAV). Use for running scripts instead of reasoning about validation/rendering.
user-invocable: false
allowed-tools: Read, Write, Bash(uv:*), Bash(mkdir:*), Bash(which:*), Bash(ffmpeg:*)
---

# BeatLab Pipeline

Prefer running these scripts (do NOT read them into context):

## Validate (and normalize) a beat JSON
uv run python .claude/skills/beatlab-pipeline/scripts/validate.py <beat.json> --inplace

## Render 16-step ASCII grid
uv run python .claude/skills/beatlab-pipeline/scripts/render_grid.py <beat.json>

## Export MIDI
uv run python .claude/skills/beatlab-pipeline/scripts/export_midi.py <beat.json> <out.mid>

## Render WAV
uv run python .claude/skills/beatlab-pipeline/scripts/render_wav.py <beat.json> <out.wav>

## Optional MP3 (if ffmpeg exists)
ffmpeg -y -i <out.wav> <out.mp3>