OrchestKit Health Diagnostics Argument Resolution FLAGS = "$ARGUMENTS"

Full argument string, e.g., "--verbose" or "--json"

FLAG

"$ARGUMENTS[0]"

First token: -v, --verbose, --json, --category=X

$ARGUMENTS[0], $ARGUMENTS[1] for indexed access (CC 2.1.59)

Overview The /ork:doctor command performs comprehensive health checks on your OrchestKit installation. It auto-detects installed plugins and validates 12 categories: Installed Plugins - Detects ork plugin Skills Validation - Frontmatter, references, token budget (dynamic count) Agents Validation - Frontmatter, tool refs, skill refs (dynamic count) Hook Health - Registration, bundles, async patterns Permission Rules - Detects unreachable rules (CC 2.1.3 feature) Schema Compliance - Validates JSON files against schemas Coordination System - Checks lock health and registry integrity Context Budget - Monitors token usage against budget Memory System - Graph memory health Claude Code Version & Channel - Validates CC >= 2.1.47, detects release channel (stable/beta/alpha) External Dependencies - Checks optional tool availability (agent-browser) MCP Status - Active vs disabled vs misconfigured, API key presence for paid MCPs When to Use After installing or updating OrchestKit When hooks aren't firing as expected Before deploying to a team environment When debugging coordination issues After running npm run build Tip (CC 2.1.69+): After fixing issues found by doctor, run /reload-plugins to activate plugin changes without restarting your session. Quick Start /ork:doctor

Standard health check

/ork:doctor -v

Verbose output

/ork:doctor --json

Machine-readable for CI

CLI Options

Flag

Description

-v

,

--verbose

Detailed output per check

--json

JSON output for CI integration

--category=X

Run only specific category

Health Check Categories

Detailed check procedures

Load

Read("${CLAUDE_SKILL_DIR}/rules/diagnostic-checks.md")

for bash commands and validation logic per category.

MCP-specific checks

Load

Read("${CLAUDE_SKILL_DIR}/rules/mcp-status-checks.md")

for credential validation and misconfiguration detection.

Output examples

Load Read("${CLAUDE_SKILL_DIR}/references/health-check-outputs.md") for sample output per category. Categories 0-3: Core Validation Category What It Checks Reference 0. Installed Plugins Auto-detects ork plugin, counts skills/agents load ${CLAUDE_SKILL_DIR}/rules/diagnostic-checks.md 1. Skills Frontmatter, context field, token budget, links load ${CLAUDE_SKILL_DIR}/references/skills-validation.md 2. Agents Frontmatter, model, skill refs, tool refs load ${CLAUDE_SKILL_DIR}/references/agents-validation.md 3. Hooks hooks.json schema, bundles, async patterns load ${CLAUDE_SKILL_DIR}/references/hook-validation.md Categories 4-5: System Health Category What It Checks Reference 4. Memory .claude/memory/ exists, decisions.jsonl integrity, queue depth load ${CLAUDE_SKILL_DIR}/references/memory-health.md 5. Build plugins/ sync with src/, manifest counts, orphans load ${CLAUDE_SKILL_DIR}/rules/diagnostic-checks.md Categories 6-9: Infrastructure Category What It Checks 6. Permission Rules Unreachable rules detection (CC 2.1.3) 7. Schema Compliance JSON files against schemas 8. Coordination Multi-worktree lock health, stale locks 9. Context Budget Token usage against budget Categories 10-12: Environment Category What It Checks Reference 10. CC Version & Channel Runtime version against minimum required, release channel (stable/beta/alpha) load ${CLAUDE_SKILL_DIR}/references/version-compatibility.md 11. External Deps Optional tools (agent-browser) load ${CLAUDE_SKILL_DIR}/rules/diagnostic-checks.md 12. MCP Status Enabled/disabled state, credential checks load ${CLAUDE_SKILL_DIR}/rules/mcp-status-checks.md Report Format Load Read("${CLAUDE_SKILL_DIR}/references/report-format.md") for ASCII report templates, JSON CI output schema, and exit codes. Interpreting Results & Troubleshooting Load Read("${CLAUDE_SKILL_DIR}/references/remediation-guide.md") for the full results interpretation table and troubleshooting steps for common failures (skills validation, build sync, memory).