doctorlisted

Run a read-only hygiene + documentation audit on the current repo. TRIGGER when the user says "is this repo healthy", "check hygiene", "audit this repo" (when they mean inspect, not remediate), "what's drifted", "run doctor", "run a health check", "audit docs", "check for doc drift", "what's broken in this project", "are the hooks still installed", "/nyann:doctor". Do NOT trigger on "fix this repo" / "remediate" / "bring it into compliance" — those are retrofit (audit + fix). doctor reports, never writes. Do NOT trigger on "what does this repo do" (that's a docs pointer, not a hygiene audit).
thettwe/nyann · ★ 6 · Data & Documents · score 71

Install: claude install-skill thettwe/nyann

# doctor Read-only audit. Never mutates the filesystem. Wraps `bin/doctor.sh`, which internally runs `bin/retrofit.sh --report-only`. ## 1. Resolve the profile `doctor.sh` requires `--profile <name>`. The skill's job is to pick the right one without pestering the user: 1. Look for a `.nyann/profile` or equivalent profile hint in the repo. 2. If the repo's CLAUDE.md declares an active profile, use that. 3. If neither exists, ask the user which profile to audit against (`default`, `nextjs-prototype`, `python-cli`, or any user/team profile they've installed). Don't silently pick `default` — the audit is only meaningful against an intended baseline. ## 2. Invoke ``` bin/doctor.sh --target <cwd> --profile <name> [--json] [--scope <csv>] ``` `--profile` takes a **bare profile name** (e.g. `python-cli`, `nextjs-prototype`), not a filesystem path. The script resolves the name to the profile JSON internally. Pass `--json` when the user says "machine-readable", "as JSON", "pipe this", or similar — otherwise emit the human-readable report. Pass `--scope <csv>` when the user wants to inspect only a subset of the audit — e.g. "just check my docs", "are my hooks healthy". Accepts any of `docs`, `hooks`, `branching`, `gitignore`, `editorconfig`, `github`, `history`, `all`, comma-separated. When narrower than `all`, the rendered output gains a `Scope: <csv>` line and `--persist` is auto-disabled (a partial-scope health score would corrupt the trend series in `memory/health.