codex-doctor
Installation
SKILL.md
Codex Doctor
Run a two-layer health check:
- Reuse Codex's stable built-in
codex doctor --jsonfor installation, config, auth, runtime, Git environment, terminal, app-server, update, and thread-inventory checks. Derive one narrow provider-scope warning when the default provider represents only a small minority of indexed history. - Run the bundled read-only scanner for workspace context governance that the built-in command does not cover.
The scanner gathers deterministic evidence. You make the semantic judgment. This separation matters because a script can prove that text repeats, but it cannot safely decide that a business fact, safety boundary, brand voice, or directory rule is disposable.
Run the check
Resolve the Skill directory from the loaded Skill path, then run:
python3 <skill-dir>/scripts/scan_workspace.py --cwd "$PWD" --compact-json
For a faster workspace-only pass when the built-in report was already run in the same task: