# Doctor

> Diagnose an Agent-OS filesystem when setup, skills, state, links, generated runtime adapters, cloud-synced files, privacy boundaries, or Gitless behavior may be unhealthy. Use for health checks and troubleshooting, not ordinary project work.

- Skill: `aylee/doctor` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aylee/doctor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aylee/doctor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: DevOps & Infra
- Author: aylee (https://skillmd.com/u/aylee)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aylee/doctor

---


# Agent-OS doctor

Run the deterministic checker when Python is available:

```bash
python3 library/scripts/agent_os_doctor.py --root .
```

Otherwise inspect the same contracts manually:

- `agent-os.yaml` identity and portable/local boundary;
- binder-to-workstream links and stable IDs;
- workstream schema, revision lineage, size, and the next-action or closed-sentinel rule;
- receipt metadata and relative paths;
- stale handoffs, duplicate IDs, partial files, and provider conflict copies;
- canonical `.agents/skills` plus generated Claude/Codex metadata;
- missing skill references, PII, absolute machine paths, and adapter drift;
- backup freshness and whether local state resolves outside the portable root.

Report evidence, severity, and the smallest safe repair. Do not repair, delete, merge conflict copies, regenerate adapters, or touch global runtime settings unless the user authorizes that action.