Doctor

Skill aylee/agent-os/.agents/skills/doctor

A filesystem-first, runtime-neutral operating system for agent-assisted work.

Install

npx -y skills add aylee/agent-os --skill doctor

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

One thing to look at

0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.

What its author says it does

Copied from the file, not written here

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.md

1.2 KB, 188 tokens by cl100k_base, as published. Nobody here has run it

Agent-OS doctor

Run the deterministic checker when Python is available:

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.

What ships with it: 2 files

535 B alongside SKILL.md

agents/