studio-doctor

name	studio-doctor
description	Preflight the Studio toolchain — checks ffmpeg, a Chromium for HyperFrames, and bun (required), plus python3 + librosa (optional, music-video only). Warns rather than fails when an optional dependency is missing.

studio-doctor

Toolchain preflight for com.ikenga.studio. Run it before studio-init / studio-oneshot.

What it checks

Dependency	Required?	Used by
ffmpeg	required	exporter (stitch/encode)
Chromium / Chrome	required	HyperFrames renderer (Puppeteer)
bun	required	sidecar / CLI runtime
python3	optional	studio-beat-detect
librosa (python import)	optional	studio-beat-detect (beat/onset detection)

python3 and librosa are warn-not-fail: only the music-video archetype needs beat detection. A box without them can still build the other six archetypes, so studio-doctor reports them as warnings and exits 0.

Running

The skill invokes the bundled check script:

bash skills/studio-doctor/check.sh

It prints a table of ok / MISSING per dependency and a one-line summary. Exit code is 0 unless a required dependency is missing (then 1). Missing optional deps never fail the check.

Interpreting output

• All ok → you're clear to build anything, including music videos.
• python3/librosa MISSING (optional) → everything works except studio-beat-detect; install with pip install librosa when you need music-video beat-snapping.