Back to Docs

Diagnostics

System Health Checks for Diverga

The Doctor skill performs comprehensive diagnostics on your Diverga installation. It follows an OpenClaw-style Check-Report-Fix pattern to identify and resolve issues. Introduced in v8.0.2.

5-Layer Diagnostic Checks

Doctor examines your installation from top to bottom:

Plugin Health

Plugin files present and valid
Version compatibility with oh-my-claudecode
Skill files properly linked
AGENTS.md file accessible

Skill Sync

All 24 agent skills registered
Skill trigger patterns valid
No duplicate skill names
Skill-to-agent mapping correct

Config Validity

CLAUDE.md syntax valid
Agent definitions parseable
Checkpoint configurations consistent
Memory system paths correct

API Keys

ANTHROPIC_API_KEY set
GROQ_API_KEY set (for screening)
Optional: SCOPUS_API_KEY, WOS_API_KEY
Key format validation (no whitespace)

Project State

.diverga/ directory structure
Memory files readable
Decision log integrity
Active project state valid

Check-Report-Fix Pattern

Doctor follows a predictable three-step process:

1

Check

Run all diagnostic checks across 5 layers. Read-only, no modifications.

2

Report

Display results with severity levels: PASS, WARN, or FAIL for each check.

3

Fix

Suggest actionable fix commands for any WARN or FAIL results. User confirms before execution.

Usage

Run diagnostics with the skill command:

/diverga:doctor

Doctor is read-only by default. Fix commands are suggested but require user confirmation.

Example Output

diverga:doctor
[CHECK] Plugin Health
  ✅ Plugin files present
  ✅ Version v8.0.2 compatible
  ✅ 24 skills registered
  ⚠️ AGENTS.md last updated 14 days ago

[CHECK] API Keys
  ✅ ANTHROPIC_API_KEY set
  ✅ GROQ_API_KEY set
  ❌ SCOPUS_API_KEY not set
  ⚠️ WOS_API_KEY not set

[REPORT] 2 warnings, 1 failure
[FIX] Run: export SCOPUS_API_KEY=your_key

Run Diagnostics Now

Check your Diverga installation health.

Quick Start GuideConfiguration