diagnoselisted

Run a self-check against an installed AI Brain Starter vault. Verifies CLAUDE.md, Meta folder, skills, hooks, journal index, MCPs, .ps1 BOM/em-dash hazards, and ai-brain-starter freshness. Prints a green/yellow/red report. Run any time something feels off, or after a git pull, or when onboarding someone else's vault.
adelaidasofia/ai-brain-starter · ★ 18 · AI & Automation · score 84

Install: claude install-skill adelaidasofia/ai-brain-starter

# /diagnose 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. On the maintainer machine: `~/Desktop/ai-brain-starter/scripts/diagnose.sh`. On an end-user install: `~/.claude/skills/ai-brain-starter/scripts/diagnose.sh`. 2. Run it. Pick the right one for the platform: **Mac / Linux:** ```bash bash ~/.claude/skills/ai-brain-starter/scripts/diagnose.sh # or pass an explicit vault: bash ~/.claude/skills/ai-brain-starter/scripts/diagnose.sh "/path/to/vault" ``` **Windows:** ```powershell pwsh ~/.claude/skills/ai-brain-starter/scripts/diagnose.ps1 # or: pwsh ~/.claude/skills/ai-brain-starter/scripts/diagnose.ps1 -Vault "C:\path\to\vault" ``` By default it uses `$VAULT_PATH` if set, else the current directory. 3. Read the output to the user in plain language. Don't dump the raw report unless they ask. Translate: - **All green:** "Your vault is healthy. Nothing to do.