doctor

Doctor — Health Check

Runs sequential checks and reports PASS, FAIL, WARN, SKIP, or FIXED for each. Auto-fixes what it can. Never destructive — never deletes files, resets configuration, or modifies candidate data.

Run checks in order — some depend on earlier results.

---

Check 1: Node.js Version

node --version

• PASS if >= 18.0.0
• FAIL if lower or not found. Fix: nvm install 18 or nodejs.org

---

Check 2: Scout MCP Server

Call list_companies with {}.

• Tool responds (even empty list): PASS
• Tool not available: FAIL — "Scout MCP server not responding. The npm package may not be installed. Fix: npm install -g talent-scout"
• Tool errors: FAIL — include error message.

---

Check 4: API Connectivity

Call configure_api_key with { verify: true }. The tool reads the existing .env and runs a real LinkdAPI verification (1 credit). Never prompts, never writes.

• { configured: false }: SKIP — "No API key. Run /talent-scout:init to set up."
• { configured: true, verified: true, warning: undefined }: PASS — "API key verified."
• { configured: true, verified: true, warning: "OUT_OF_CREDITS" }: WARN — "Key valid but out of credits. Load credits at linkdapi.com."
• { configured: true, verified: false, error: "INVALID_KEY" }: FAIL — "Key is invalid. Run /talent-scout:init to re-enter."
• { configured: true, verified: false, error: "VERIFY_NETWORK_ERROR" }: WARN — "Couldn't reach LinkdAPI right now. Check your connection."

---

Check 5: Data Directory

Call read_meta with name "config.json".

• Returns data: call read_meta with name "candidates_index.json", count candidates. PASS — "Data directory initialized (N candidates)"
• Returns error (file not found): INFO — "Not initialized yet. Run a session to start the setup wizard."

---

Check 6: Dashboard Build

Check whether the dashboard is available via npm.

Run: which talent-scout-dashboard || npx -y -p talent-scout talent-scout-dashboard --version

• Command available: PASS — "Dashboard available via npm"
• Command not found: WARN — "Dashboard not available. Run: npm install -g talent-scout"

---

Check 7: Plugin File Integrity

Verify core plugin files exist.

Files to check:

• ${CLAUDE_PLUGIN_ROOT}/skills/init/SKILL.md

• ${CLAUDE_PLUGIN_ROOT}/skills/doctor/SKILL.md

• ${CLAUDE_PLUGIN_ROOT}/skills/scout/SKILL.md

• ${CLAUDE_PLUGIN_ROOT}/skills/orchestrator/SKILL.md

• ${CLAUDE_PLUGIN_ROOT}/.mcp.json

• All present: PASS — "Plugin files complete."

• Any missing: WARN — "Plugin files incomplete. Missing: [list]. Fix: re-install the plugin."

---

Output Format

Display results as a block after all checks complete:

Talent Scout Health Check
─────────────────────────
[PASS]  Node.js v22.x (>= 18 required)
[PASS]  Scout MCP server responds
[SKIP]  API connectivity — no API key configured
[PASS]  Data directory initialized (47 candidates)
[PASS]  Dashboard available via npm
[PASS]  Plugin files complete

Result: 5 passed, 1 skipped

Use [FIXED] when a check auto-repaired. Summary line includes counts for passed, fixed, warned, failed, skipped — omit zero categories.

For every FAIL or WARN, include fix on the next line indented:

[FAIL]  Scout MCP server did not respond
        Fix: npm install -g talent-scout