/doctor — Project Health Check
Meta-skill that runs multiple health checks and produces a consolidated report. Single command to answer "is this project healthy?"
Inspired by: GSD v2 "doctor" — stale commit safety, project health diagnostics.
What It Checks
| Area |
Skill Used |
What It Checks |
| Git |
/git-hygiene |
Stale branches, large files, commit conventions, uncommitted work |
| Deploy |
/deploy-check |
Docker, CI, env vars, SSL, DNS, monitoring |
| Freshness |
/freshness-check |
Dependencies, frameworks, security standards |
| Structure |
(built-in) |
Missing README, LICENSE, .gitignore, CLAUDE.md |
| Dependencies |
(built-in) |
npm audit, outdated packages, lock file |
Modes
/doctor quick
Fast check (~30 seconds). Runs:
- Git status: Uncommitted changes? Stale branches? Last commit age?
- Dependencies:
npm audit --audit-level=high — any critical vulnerabilities?
- Structure: Missing essential files (README, .gitignore, LICENSE)?
- Lock file: Present and committed?
/doctor full
Comprehensive check (~2-5 minutes). Runs everything in quick plus:
- Git hygiene: Full
/git-hygiene scan (large files, conventions, branch age)
- Deploy readiness: Full
/deploy-check (Docker, CI, env vars, SSL)
- Freshness:
/freshness-check check (dependency versions, standards)
- Outdated packages:
npm outdated or framework-specific check
Output Format
PROJECT HEALTH — {project name}
Git: ✓ Clean (3 stale branches, 0 large files)
Dependencies: ⚠ 2 high-severity vulnerabilities (npm audit)
Structure: ✓ All essential files present
Deploy: ✓ Docker + CI configured
Freshness: ⚠ 3 outdated dependencies
Overall: GOOD (2 warnings, 0 critical)
Recommended actions:
1. npm audit fix (2 high vulnerabilities)
2. Update astro 6.1.2 → 6.1.3
3. Delete 3 stale branches (feature/old-*, hotfix/done)
Health Ratings
| Rating |
Criteria |
| HEALTHY |
No warnings, no critical issues |
| GOOD |
Warnings only, no critical issues |
| NEEDS ATTENTION |
1-2 critical issues |
| UNHEALTHY |
3+ critical issues or security vulnerabilities |
Rules
- Read-only in quick mode — never modify anything
- Full mode may suggest commands — but does not auto-execute destructive operations
- No false alarms — only report issues that actually need attention
- Fast feedback — quick mode completes in under 30 seconds
1---2name: doctor3description: Project health check meta-skill. Runs git-hygiene, deploy-check, and freshness-check in sequence. Use when: "doctor", "health check", "project health", "is everything ok", "check project".4---56<!-- AI-QUICK-REF7## /doctor — Quick Reference8- **Modes:** quick | full9- **Runs:** /git-hygiene scan → /deploy-check → /freshness-check check10- **Output:** Consolidated health report with severity ratings11- **Inspired by:** GSD v2 "doctor" command12-->1314# /doctor — Project Health Check1516Meta-skill that runs multiple health checks and produces a consolidated report. Single command to answer "is this project healthy?"1718**Inspired by:** GSD v2 "doctor" — stale commit safety, project health diagnostics.1920## What It Checks2122| Area | Skill Used | What It Checks |23|------|-----------|---------------|24| Git | `/git-hygiene` | Stale branches, large files, commit conventions, uncommitted work |25| Deploy | `/deploy-check` | Docker, CI, env vars, SSL, DNS, monitoring |26| Freshness | `/freshness-check` | Dependencies, frameworks, security standards |27| Structure | (built-in) | Missing README, LICENSE, .gitignore, CLAUDE.md |28| Dependencies | (built-in) | `npm audit`, outdated packages, lock file |2930## Modes3132### `/doctor quick`3334Fast check (~30 seconds). Runs:35361. **Git status:** Uncommitted changes? Stale branches? Last commit age?372. **Dependencies:** `npm audit --audit-level=high` — any critical vulnerabilities?383. **Structure:** Missing essential files (README, .gitignore, LICENSE)?394. **Lock file:** Present and committed?4041### `/doctor full`4243Comprehensive check (~2-5 minutes). Runs everything in `quick` plus:44455. **Git hygiene:** Full `/git-hygiene` scan (large files, conventions, branch age)466. **Deploy readiness:** Full `/deploy-check` (Docker, CI, env vars, SSL)477. **Freshness:** `/freshness-check check` (dependency versions, standards)488. **Outdated packages:** `npm outdated` or framework-specific check4950## Output Format5152```53PROJECT HEALTH — {project name}5455 Git: ✓ Clean (3 stale branches, 0 large files)56 Dependencies: ⚠ 2 high-severity vulnerabilities (npm audit)57 Structure: ✓ All essential files present58 Deploy: ✓ Docker + CI configured59 Freshness: ⚠ 3 outdated dependencies6061 Overall: GOOD (2 warnings, 0 critical)6263 Recommended actions:64 1. npm audit fix (2 high vulnerabilities)65 2. Update astro 6.1.2 → 6.1.366 3. Delete 3 stale branches (feature/old-*, hotfix/done)67```6869## Health Ratings7071| Rating | Criteria |72|--------|----------|73| HEALTHY | No warnings, no critical issues |74| GOOD | Warnings only, no critical issues |75| NEEDS ATTENTION | 1-2 critical issues |76| UNHEALTHY | 3+ critical issues or security vulnerabilities |7778## Rules7980- **Read-only in quick mode** — never modify anything81- **Full mode may suggest commands** — but does not auto-execute destructive operations82- **No false alarms** — only report issues that actually need attention83- **Fast feedback** — quick mode completes in under 30 seconds
claude-hangar