| name | instrument-quality-matrix |
| description | Apply every quality aspect (audit-tune/voice/dynamics/envelope/headroom/stability) to every instrument, in the right order, and track the scorecard. The comprehensive pass. Usage - instrument-quality-matrix [instrument] |
instrument-quality-matrix — every aspect × every instrument
Owner (2026-07-17): make skills for the different aspects, "and then we eventually,
comprehensively apply them to each instrument for all of them."
The six aspect skills each focus one direction of quality. This one runs them as a matrix so
no instrument is graded on a spectrogram in one dimension and lifeless in another, and so the
whole library is held to the same bar.
The aspects (each is its own skill)
| # | skill | the direction |
|---|
| 1 | audit-stability | never NaN / denormal; self-oscillators ignite and hold |
| 2 | audit-headroom | nothing clips; level-matched |
| 3 | audit-tune | plays the note it was asked, everywhere |
| 4 | audit-envelope | attack + decay/release shape |
| 5 | audit-dynamics | velocity changes loudness AND timbre |
| 6 | audit-voice | fundamental-led, ONE committed voice (pick one, don't average) |
The ORDER is not arbitrary — earlier aspects gate later ones
Run 1→6. The first two are PREREQUISITES: a clipping or NaN-ing instrument corrupts every
timbre and dynamics measurement (clipping fabricates harmonics; the master limiter crushes
dynamics flat). Never tune voice/dynamics before headroom and stability are green. Tune (3)
before voice (6): a mis-slotted note inflates the centroid, so a "brightness" reading on an
off-pitch note is meaningless.