doctor

Diagnose Nightshift workspace state, markers, leases, and policies without modifying anything.

63|3|Updated Jul 14, 2026
One-click install
npx skills add https://github.com/orwa-mahmoud/nightshift --skill doctor-orwa-mahmoud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: doctor
Source: https://github.com/orwa-mahmoud/nightshift/tree/main/plugins/nightshift/skills/doctor
Command: npx skills add https://github.com/orwa-mahmoud/nightshift --skill doctor-orwa-mahmoud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When a long-running agent shift misbehaves, it is hard to tell whether the workspace link, state files, process lease, watchman, or deadline policy is at fault. This Skill runs a read-only inspection of the Nightshift workspace and reports classified findings so you know exactly what is wrong before changing anything. ## Core Features & Use Cases - Read-only workspace inspection: Runs the ns doctor inspector and relays its full report covering workspace link validity, schema version, work mode, punch-list counts, markers, session lease, watchman liveness, and deadline policy. - Classified next actions: Every suggestion is tagged [safe], [confirm], or [blocked] so you know which repairs are mechanical leftovers, which need an owner decision, and which Nightshift cannot fix. - Resolved policy reporting: Shows every effective rules.json setting with its source and expiry, plus preflight gaps where items need elevation categories the policy does not grant. - Use Case: You return in the morning and the shift seems stuck. Invoke Doctor to get a verbatim diagnostic report showing a stale watchman pid file and a failed clock-out, with classified repair offers you can approve separately. ## Quick Start Ask the agent to run the doctor skill to diagnose the current Nightshift workspace and report any warnings or recommended actions.

Frequently Asked Questions about doctor

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I diagnose a stuck Nightshift shift without changing state?

Invoke the doctor skill, which runs the ns doctor inspector against the resolved workspace and prints its report verbatim. The invocation is read-only and leaves the tree byte-identical, so no markers, leases, or state files are modified.

What does the Nightshift doctor report include?

The report covers workspace link validity, schema version status, work mode and target, punch-list and staged-work counts, markers, session and process lease liveness, watchman state, deadline policy agreement, and a resolved policy block naming every effective setting with its source.

Can Doctor fix the problems it finds automatically?

No. Doctor classifies every suggestion as [safe], [confirm], or [blocked] and only offers them. Repairs are applied only when the owner explicitly asks, at which point the stop, start, or setup skills handle the action.

Does the doctor skill work on Windows, macOS, and Linux?

Yes. Commands run through the plugin's runtime/ns entry point on macOS and Linux, and through runtime\windows\ns.ps1 in PowerShell on native Windows, with the same verbs and report output on each platform.

Why does Doctor warn about work mode being unset or malformed?

When the work-mode record is missing, Doctor warns that Setup would propose artifact mode and offers to persist it through Setup. A malformed record means the site is treated as unusable until Setup rewrites it, since Doctor never writes work-mode itself.