skill-doctor

1> **Host: Codex CLI** — This skill was designed for Claude Code and adapted for Codex.
2> Cross-reference commands use installed skill names in Codex rather than `/octo:*` slash commands.
3> Use the active Codex shell and subagent tools. Do not claim a provider, model, or host subagent is available until the current session exposes it.
4> For host tool equivalents, see `skills/blocks/codex-host-adapter.md`.
5 
6 
7# Environment Doctor
8 
9## Overview
10 
11Run environment diagnostics across 15 check categories. Doctor 2.0 identifies
12misconfigured providers, stale loaded or cached plugin versions, invalid plugin
13assembly, unwritable state, non-terminal run records, orphan process evidence,
14broken hooks, and other issues that prevent Claude Octopus from working
15correctly.
16 
17**Core principle:** Detect problems before they surface in workflows.
18 
19 
20## When to Use
21 
22**Use this skill when:**
23- Something isn't working and you're not sure why
24- After installing or updating the plugin
25- Before a demo or important workflow run
26- Checking if providers are properly authenticated
27- Verifying scheduler, hooks, or skills are correctly configured
28 
29**Do NOT use for:**
30- First-time setup (use `/octo:setup` — it guides configuration)
31- Project workflow status (use `/octo:status`)
32- Debugging application code (use `/octo:debug`)
33 
34 
35## The Process
36 
37### Step 1: Resolve Plugin Root and Run Full Diagnostics
38 
39Use this resolver before running Octopus scripts. Prefer the active host root,
40…