| Agent cannot see SelfTune | Was the skill installed after the session started? | Restart the agent session and ask it to inspect the installation |
| Command is missing | Is npx or Bun available? | Run through npx selftune@latest and record the version |
| Skills are missing | Are their directories visible to the current user and harness? | Check discovery paths without moving or copying skills yet |
| Health says no data | Has the skill been used in a supported recorded session? | Use it naturally, end the session, then run sync and status |
| Dashboard will not open | Is another runtime using the port or an older service registered? | Run doctor and inspect service status before restarting |
| Permission error | Which file, hook, history, or supervisor is blocked? | Grant only the narrow permission required or choose a manual path |
| Cloud or library fails | Is the local workflow healthy first? | Keep local operation working, then check URL, identity, and token separately |
