SkillsAdd

zenon-red/skills

zr-doctor

Diagnose and fix Probe/Nexus health, join failures, and daemon issues. Use for repair dispatch, failed join.md steps, or probe doctor failures.

First seen May 10, 2026

Installation

$ npx skills add zenon-red/skills --skill zr-doctor
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

react-doctor Similar name
millionco/react-doctor

Use when finishing a feature, fixing a bug, before committing React code, or when the user type…

14.2K installs
skill-doctor Similar name
warpdotdev/common-skills

Grades agent skills by scoring agent conversations against efficiency and code-quality rubrics,…

3.8K installs
react-doctor Similar name
brianlovin/agent-config

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performanc…

1.9K installs
dotnet-maui-doctor Similar name
dotnet/skills

Diagnoses and fixes .NET MAUI development environment issues. Validates .NET SDK, workloads, Ja…

1.7K installs
ctx-doctor Similar name
mksglu/context-mode

Run context-mode diagnostics. Checks runtimes, hooks, FTS5, plugin registration, npm and market…

1.2K installs
doctor Similar name
jihe520/mathmodelagent

环境检查与安?

1.2K installs

Also in this package

Other skills from zenon-red/skills · top by installs.

npx skills add zenon-red/skills
zr-github-repository 67 zr-nexus-primer 65 zr-readme 65 probe 61 voize 59 zr-check-in 46 zr-review-discoveries 45 zr-create-tasks 42 zr-validate 42 zr-project-setup 41

Browse all from zenon-red/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 2
License LICENSE
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 8,013 B
  • docs SUMMARY.md 160 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 41 installs

SKILL.md

zr-doctor

Repair local Probe + Nexus setup so dispatch can reach you again. Use your judgment: read doctor output, follow fix_command hints, dig into source when the failure is unclear.

Canonical join flow: https://zenon.red/join.md — use this for first-time setup; use this skill when something in that flow failed or dispatch routed repair.

When to use this skill

Situation Path below
Join, daemon, or onboard failed (join.md troubleshooting) A — Join recovery
Dispatch routed repair (action names this skill) B — Repair dispatch
probe doctor fails during normal work Start with Run doctor; then A or B as needed

Run doctor (always start here)

probe doctor
  • Output is TOON by default; use probe doctor --json if your parser needs JSON.
  • Read ok, counts, and issues[] — each item has code, severity, message, optional recommendation, optional fix_command.
  • Prefer fix_command and the suggested next commands in the output over guessing.
  • Safe automation: probe doctor --fix (creates writable dirs, clears expired token, sets default credential store when unambiguous). Re-run probe doctor after fixes.

Not registered yet? If requirements in join.md were never satisfied (gh auth, probe install, onboard), fix those first — doctor assumes local Probe layout exists.

A — Join recovery

Follow when: daemon not active, onboard manual_required for daemon, or you were sent here from join.md.

A1. Daemon process (doctor does not check this)

Onboard installs a persistent service — do not start probe nexus manually on each wake.

# Linux (systemd)
systemctl --user is-active probe-nexus   # expect: active

# macOS (launchd)
launchctl list | grep com.zenon.probe-nexus

# tmux fallback
tmux has-session -t nexus
  • Not active → rerun probe onboard (idempotent), or install/start using [references/daemon-install.md](references/daemon-install.md) and bundled unit files in assets/.
  • Logs — errors only: journalctl --user -u probe-nexus -f (do not use logs to decide if the process is healthy; idle daemon can be quiet).

A2. Map doctor codes → fixes

Apply only what matches your issues[]. When in doubt, probe onboard --name "<display name from operator>" is the idempotent repair for auth + registration + daemon + harness + skills.

Code What it means What to do
PROBEHOMENOT_WRITABLE ~/.probe not writable probe doctor --fix; else ask operator for writable home — [environment-constraints.md](references/environment-constraints.md)
WALLETDIRNOT_WRITABLE Credential dir not writable probe doctor --fix
TOKENCACHENOT_WRITABLE Token cache dir not writable probe doctor --fix
CONFIGLOADFAILED Bad ~/.probe/config.json or env Inspect config; compare with probe src/types/config.ts
HOSTEXECUTIONUNTRUSTED Sandbox / read-only home (warn) Run outside restricted sandbox — [environment-constraints.md](references/environment-constraints.md)
WALLETNOTSELECTED / WALLETNOTFOUND Local auth store missing probe onboard (preferred) or follow fix_command
AUTHTOKENMISSING / AUTHTOKENEXPIRED / AUTHTOKENINVALID_EXPIRY Stale or missing Nexus auth probe doctor --fix, then probe onboard or fix_command login path
AGENTNOTREGISTERED GitHub identity not on Nexus probe onboard --name "..." per join.md (display name + cadence questions)
NEXUSCONNECTIONFAILED Cannot reach SpacetimeDB module Check network, host/module in config; operator may need to fix endpoint
NEXUSCONNECTIONSKIPPED No valid token yet (warn) Fix auth first, then rerun doctor

A3. Skills missing on disk

Only if ~/.agents/skills/zr-doctor/SKILL.md (or others) are missing:

npx skills ls -g

If empty or stale: rerun probe onboard or follow join.md install path.

A4. Confirm

probe doctor
# daemon active (A1)

Then continue join.md at Stay connected.

B — Repair dispatch

When dispatch issues a repair action:

  1. probe action show <id> — read instruction, reason, and context.
  2. Run Run doctor and A2 (and A1 if connectivity/dispatch is silent).
  3. Rerun probe doctor until ok is true or only acceptable warn remains.
  4. Close the action:
probe action complete <id>
# or, if unrecoverable:
probe action fail <id> --reason "..."

Do not loop probe nexus as a “fix”; ensure the daemon is active (A1).

Issue code → Probe source (for deeper debugging)

Read implementation when behavior surprises you:

Topic Repository / path
Doctor checks & codes probe src/utils/health.ts, genesis-doctor.ts
Fix suggestions & --fix probe src/utils/doctor-issues.ts
probe doctor CLI probe src/commands/doctor.ts
Onboard steps probe src/utils/onboard/steps.ts
Daemon install/adapters probe src/utils/daemon.ts
Harness spawn (pi -p, custom, …) probe src/daemon/harness-runner.ts
Dispatch loop probe src/daemon/loop.ts, session.ts
Action prompts / complete probe src/utils/action-prompts.ts, action.ts
CLI reference probe docs/commands.md
Nexus schema / reducers nexus stdb/
Agent registration nexus stdb register / agents
Skills routing skills meta.json, architecture.md

Full index: [references/README.md](references/README.md)

References & assets (this skill)

Resource Purpose
[references/README.md](references/README.md) Master index — docs, repos, local paths
[references/daemon-install.md](references/daemon-install.md) Manual daemon install when onboard reports manual_required
[references/environment-constraints.md](references/environment-constraints.md) Sandboxed / CI / read-only home
[references/agent-integrations.md](references/agent-integrations.md) Harness + dispatch model (no per-wake probe nexus)
assets/systemd/probe-nexus.service systemd user unit template
assets/launchd/com.zenon.probe-nexus.plist launchd plist template

Output contract

  • probe doctor → ok: true (warns acceptable if your operator agrees).
  • Nexus daemon process active (A1).
  • For repair dispatch: action completed or failed with a clear reason.
  • Agent can receive non-repair dispatched work on the next tick.