How do I install the Openclaw Workspace Doctor skill?

Run npx skillmds@latest add dvcrn/openclaw-workspace-doctor-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Openclaw Workspace Doctor safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Openclaw Workspace Doctor?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Openclaw Workspace Doctor free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Openclaw Workspace Doctor?

dvcrn (@dvcrn) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Openclaw Workspace Doctor by dvcrn — Agent Skill

Name: Openclaw Workspace Doctor
Rating: 4.666666666666667 (3 reviews)
Author: dvcrn

Openclaw Workspace Doctor

Use when the user wants to inspect, repair, package, or troubleshoot an OpenClaw workspace doctor setup, especially for stale bootstrap state, missing daily memory notes, or codex-cli launch hazards in OpenClaw config.

dvcrn Updated Sep 9, 2026 32 repo stars

File contents

OpenClaw Workspace Doctor

Overview

This skill runs the OpenClaw workspace doctor, applies safe workspace-local fixes, and handles the companion fixer for the external codex-cli backend config. Use it when the user asks to diagnose workspace startup drift, package the doctor tool, or repair the known --full-auto non-interactive stall risk.

When To Use It

The user asks to run or extend the workspace doctor tool.
The workspace has stale bootstrap/onboarding behavior.
Daily memory/YYYY-MM-DD.md notes are missing or inconsistent.
OpenClaw is hanging because codex-cli launches with --full-auto.
The user wants the doctor packaged as a repo or a Codex skill.

Workflow

Run the doctor first: python3 scripts/workspace_doctor.py
If the problem is workspace-local, apply safe fixes: python3 scripts/workspace_doctor.py --fix
If the remaining problem is the external OpenClaw config, inspect or patch it with the companion fixer: python3 scripts/fix_openclaw_codex_config.py --check python3 scripts/fix_openclaw_codex_config.py
If the environment blocks writing ~/.openclaw/openclaw.json, do not pretend the live fix happened. Report the sandbox restriction clearly and, if useful, use: python3 scripts/fix_openclaw_codex_config.py --stdout
For repo packaging tasks, update:
- README.md
- pyproject.toml
- setup.py
- tests/
- .github/workflows/ci.yml
Validate before closing:
- python3 -m unittest discover -s tests
- python3 scripts/workspace_doctor.py
- python3 scripts/workspace_doctor.py --json
- python3 /Users/xutao/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/openclaw-workspace-doctor

Repo Commands

Run doctor: python3 scripts/workspace_doctor.py
Run doctor with fixes: python3 scripts/workspace_doctor.py --fix
Emit JSON: python3 scripts/workspace_doctor.py --json
Check external config: python3 scripts/fix_openclaw_codex_config.py --check
Patch external config: python3 scripts/fix_openclaw_codex_config.py
Print patched config without writing: python3 scripts/fix_openclaw_codex_config.py --stdout

References

Read references/commands.md for the command map and fix boundaries.
Read references/repo-layout.md when you need the repo structure and what each area is for.

Scripts

scripts/run_doctor.py runs the packaged CLI.
scripts/fix_openclaw_config.py runs the external config fixer.
Prefer these wrappers or the repo-root scripts instead of retyping logic.

---name: openclaw-workspace-doctor-2description: Use when the user wants to inspect, repair, package, or troubleshoot an OpenClaw workspace doctor setup, especially for stale bootstrap state, missing daily memory notes, or codex-cli launch hazards in OpenClaw config.--- # OpenClaw Workspace Doctor ## Overview This skill runs the OpenClaw workspace doctor, applies safe workspace-local fixes, and handles the companion fixer for the external `codex-cli` backend config. Use it when the user asks to diagnose workspace startup drift, package the doctor tool, or repair the known `--full-auto` non-interactive stall risk. ## When To Use It - The user asks to run or extend the workspace doctor tool. - The workspace has stale bootstrap/onboarding behavior. - Daily `memory/YYYY-MM-DD.md` notes are missing or inconsistent. - OpenClaw is hanging because `codex-cli` launches with `--full-auto`. - The user wants the doctor packaged as a repo or a Codex skill. ## Workflow 1. Run the doctor first: `python3 scripts/workspace_doctor.py` 2. If the problem is workspace-local, apply safe fixes: `python3 scripts/workspace_doctor.py --fix` 3. If the remaining problem is the external OpenClaw config, inspect or patch it with the companion fixer: `python3 scripts/fix_openclaw_codex_config.py --check` `python3 scripts/fix_openclaw_codex_config.py` 4. If the environment blocks writing `~/.openclaw/openclaw.json`, do not pretend the live fix happened. Report the sandbox restriction clearly and, if useful, use: `python3 scripts/fix_openclaw_codex_config.py --stdout` 5. For repo packaging tasks, update: - `README.md` - `pyproject.toml` - `setup.py` - `tests/` - `.github/workflows/ci.yml` 6. Validate before closing: - `python3 -m unittest discover -s tests` - `python3 scripts/workspace_doctor.py` - `python3 scripts/workspace_doctor.py --json` - `python3 /Users/xutao/.codex/skills/.system/skill-creator/scripts/quick_validate.py skills/openclaw-workspace-doctor` ## Repo Commands - Run doctor: `python3 scripts/workspace_doctor.py` - Run doctor with fixes: `python3 scripts/workspace_doctor.py --fix` - Emit JSON: `python3 scripts/workspace_doctor.py --json` - Check external config: `python3 scripts/fix_openclaw_codex_config.py --check` - Patch external config: `python3 scripts/fix_openclaw_codex_config.py` - Print patched config without writing: `python3 scripts/fix_openclaw_codex_config.py --stdout` ## References - Read [references/commands.md](references/commands.md) for the command map and fix boundaries. - Read [references/repo-layout.md](references/repo-layout.md) when you need the repo structure and what each area is for. ## Scripts - `scripts/run_doctor.py` runs the packaged CLI. - `scripts/fix_openclaw_config.py` runs the external config fixer. - Prefer these wrappers or the repo-root scripts instead of retyping logic.

Frequently asked questions