RECOVERY
When it fails, make the next action obvious.
Run doctor first. It checks channel-specific skills, agents, catalogs, and project activation instead of treating one discovered file as a healthy install.
Start with one diagnostic
Use JSON output in CI or paste the human report into your coding agent. A degraded bundle exits non-zero.
npx oh-my-design-cli@latest doctornpx oh-my-design-cli@latest doctor --jsonThe skill does not appear after install
Restart the coding agent. Skill discovery happens at session start in most tools, then rerun doctor.
Doctor says the catalog is missing
Rerun the latest installer for the exact channel. Do not copy a random reference into another channel’s data directory.
The agent says there is no design context
Ask it to set up the project design system. Confirm the proposal before DESIGN.md is written.
The result replaced behavior or content I wanted to keep
Revert that focused change, state the protected behavior explicitly, and record the correction with omd:remember.
A reference claims a font or component without evidence
Remove only the unresolved field or empty group. Never substitute a system font or generic component as brand fact.