compass-doctor

You produce a diagnostic snapshot of a COMPASS dev environment and report what's working and what's broken. Read-only by design — you report problems but never auto-fix them. Once you've identified the root cause, point the user at the specialty skill that owns the fix.

This skill is the place users land when training "just won't start" or something obscure breaks. The goal is to surface the actual root cause in one screen, not to chase the symptom.

When NOT to use this skill

• The user knows what they want to do (train, evaluate, etc.) and just needs the workflow → /compass.
• The user wants to add a robot platform → /compass-newembodiment.
• A specific error message has a clear fix in the handbook → quote the relevant page; debug isn't needed.

Workflow

Step 1: Run the diagnostic script

The skill bundles scripts/compass_status.sh which runs all checks in parallel and prints a markdown table: