doctor

Installation
SKILL.md

autoloop: Doctor

Self-Evolving Skill: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed β€” fix this file immediately, don't defer. Only update for real, reproducible issues.

Self-diagnostic for the autoloop fleet. Cross-references registry.json, heartbeat.json files, launchctl list output, plist files, and (lightly) ~/.claude/projects JSONL transcripts to surface zombies, orphans, label collisions, multi-cwd contamination, stale bindings, and missing heartbeats.

Arguments

  • --json β€” emit structured JSON output instead of human-readable terminal report
  • --fix β€” apply SAFE auto-remediations only (see "What gets fixed" below)

Severity model

  • πŸ”΄ RED β€” known-broken state requiring action (zombie launchctl entry, multi-cwd contamination, label collision, contract file missing, cwd_drift_detected)
  • 🟑 YELLOW β€” probably-OK but worth attention (pending-bind >1h, dead pid + recent heartbeat)
  • 🟒 GREEN β€” healthy
Installs
2
GitHub Stars
59
First Seen
May 3, 2026
doctor β€” terrylica/cc-skills