---
title: Start with doctor when a skill misbehaves
description: The doctor command shows every managed installation and what is unhealthy, and previews repairs before it changes anything.
url: https://openplanr.dev/docs/tips/start-with-doctor
updated: 2026-10-06
related:
  - https://openplanr.dev/docs/prompts/diagnose-setup.md
  - https://openplanr.dev/docs/prompts/diagnose-without-fixing.md
  - https://openplanr.dev/docs/prompts/investigate-first.md
---

# Start with doctor when a skill misbehaves

The doctor command shows every managed installation and what is unhealthy, and previews repairs before it changes anything.

When a skill misbehaves, run `openplanr doctor --json` before you change anything. It checks the installation, the agent adapters, and the project, and lists every managed installation with what is unhealthy.

`openplanr doctor --fix` previews repairs to the files OpenPlanr owns, then asks once before applying them. It keeps each agent's saved scope and Codex discovery choice, uses the plugin bundled with the running CLI, and does not upgrade the CLI or change credentials. A healthy second run makes no changes.

In your agent, `/planr:doctor` (Claude Code), `$doctor` (Codex) or `@planr-doctor` (Cursor) runs the same diagnosis and previews every repair. Installing packages, changing versions, and deleting files always wait for your confirmation.