{"skill":{"slug":"sys-doctor","displayName":"System Doctor","summary":"Comprehensive system diagnostics and health check for Linux servers. Check disk usage, memory, CPU load, network interfaces, running services, and system inf...","description":"---\nname: sys-doctor\ndescription: \"Comprehensive system diagnostics and health check for Linux servers. Check disk usage, memory, CPU load, network interfaces, running services, and system info. Generate HTML health reports or JSON output. Use when the user wants to: (1) Check server health and resource usage, (2) Diagnose performance issues, (3) Generate system health reports for monitoring, (4) Check disk space on all mounted volumes, (5) Inspect memory and swap usage, (6) Troubleshoot network connectivity, (7) Audit running services.\"\n---\n\n# System Doctor (sys-doctor)\n\nRun comprehensive system diagnostics with a single command.\n\n## Quick start\n\n```bash\npython3 skills/sys-doctor/scripts/sys_doctor.py\n```\n\nOutput example:\n```\n◆ System Health Report: myserver\n2026-05-10 13:30:00\n============================================================\n========================== DISK ==========================\n  🟢 /              60%  (30G/50G, avail: 20G)\n  🟡 /var/log       85%  (4.3G/5G, avail: 0.7G)\n  🟢 /home          45%  (90G/200G, avail: 110G)\n========================== MEMORY ========================\n  RAM:    4.2G / 16G  (26%)\n  Swap:   0.1G / 2G  (5%)\n========================== CPU ============================\n  Load:     0.45 / 0.32 / 0.28\n  Cores:    4 (8 logical)\n========================== NETWORK ========================\n  🟢 eth0       UP    192.168.1.100/24\n  🟢 docker0    UP    172.17.0.1/16\n========================== SERVICES ======================\n  • systemd-journald  • cron  • sshd  • docker\n  • nginx  • postgresql  • redis-server\n```\n\n## Commands\n\n| Command | Action |\n|---------|--------|\n| `--check disk` | Check only disk usage |\n| `--check memory` | Check only memory/swap |\n| `--check cpu` | Check only CPU load |\n| `--check network` | Check only network interfaces |\n| `--check services` | List running services |\n| `--report` | Generate HTML health report |\n| `--json` | Output as JSON |\n| `--output file.html` | Save to specific file |\n\n## HTML Reports\n\nGenerate a styled HTML report for sharing or monitoring:\n\n```bash\npython3 skills/sys-doctor/scripts/sys_doctor.py --report\n# Creates: sys-doctor-report-20260510-133000.html\n```\n\n## JSON Output\n\nFor programmatic consumption (API, monitoring, dashboards):\n\n```bash\npython3 skills/sys-doctor/scripts/sys_doctor.py --json\n```\n\n## Health Status Logic\n\n- **Disk ≥ 90%** → `critical` (exit code 2)\n- **Disk ≥ 80%** → `warning`\n- **Disk < 80%** → `ok`\n\nThe report's color-coded badges reflect overall health status.\n\n## Requirements\n\n- **Linux** (primary) — uses `/proc/`, `df`, `free`, `ip`, `systemctl`\n- **macOS** — partial support via `psutil` fallback (install: `pip install psutil`)\n- No external API calls — fully offline\n","topics":["Health","Json"],"tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":322,"installsAllTime":12,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1778392853408,"updatedAt":1778492892498},"latestVersion":{"version":"1.0.0","createdAt":1778392853408,"changelog":"Initial release: system diagnostics, HTML reports, JSON output","license":"MIT-0"},"metadata":null,"owner":{"handle":"ericlooi504","userId":"s1728b3jrtnnagbdxjy2rmpndh84mk8e","displayName":"ericlooi504","image":"https://avatars.githubusercontent.com/u/275256771?v=4"},"moderation":null}