Recovering from errors

Failures use stable error codes and include an actionable fix. Preserve that evidence; do not replace it with a generic explanation.

Diagnose first

watch-skill doctor --json

Read the failing checks and apply only their stated fixes. doctor can repair managed ffmpeg and yt-dlp binaries, stale locks, corrupt caches, missing frame directories, and known local-model health failures. Re-run it once after remediation.

Retry the original operation once