diagnose

# /diagnose > **`{SKILL_DIR}`** = this skill's own folder (locally: the directory this SKILL.md lives in; a served brain substitutes the real absolute path before you read this). Shared starter files live at the repo root two levels up: `{SKILL_DIR}/../..`. If a path does not resolve, name the missing file and stop — never guess another location. Tells you whether your second brain is healthy. ## Why Most "Claude is broken" reports trace to one of: - CLAUDE.md missing or has no Vault Map - Hooks not registered, so no auto context-loading - `journal-index.json` stale or malformed, so insights find nothing - `.ps1` files lost their UTF-8 BOM, so Windows PowerShell crashes - ai-brain-starter is many commits behind, so the user is on stale logic `/diagnose` checks all of these in ~5 seconds. It writes nothing, sends no network requests beyond a single `git fetch`, and exits with a status code so it can be wired into CI or cron. ## What to do 1. Find the script: `{SKILL_DIR}/../../scripts/diagnose.sh` (the starter repo root sits two levels above this skill's folder on every install shape). 2. Run it. Pick the right one for the platform: **Mac / Linux:** ```bash bash "{SKILL_DIR}/../../scripts/diagnose.sh" # or pass an explicit vault: bash "{SKILL_DIR}/../../scripts/diagnose.sh" "/path/to/vault" ``` **Windows:** ```powershell pwsh "{SKILL_DIR}/../../scripts/diagnose.ps1" # or: pwsh "{SKILL_DIR}/../../scripts/diagnose.ps1" -Vault "C:\path\...