Exit 1 when any --max-*-pct budget is exceeded or zombies exist.
Pairs with
session-finder (which agents are consuming that CPU),
net-probe (the network side of the same triage),
log-analyzer (what the box's logs say after you learn it's resource-starved).
1---2name: sys-health3description: Sys Health4---56# Sys Health78The "is this box okay" check an agent should run before blaming code.910## Commands1112```bash13python3 scripts/sys_health.py14python3 scripts/sys_health.py --json --top 1015python3 scripts/sys_health.py --max-disk-pct 90 --max-mem-pct 85 # gate16```1718## Reports1920| Metric | Source |21|---|---|22| Disk total/used/% | statvfs |23| Memory total/used % | vm_stat (macOS) or /proc/meminfo (Linux) |24| Load 1/5/15m | sysctl vm.loadavg or /proc/loadavg |25| Top N processes by CPU | ps |26| Zombie processes | ps state Z |2728Exit 1 when any `--max-*-pct` budget is exceeded or zombies exist.2930## Pairs with3132`session-finder` (which agents are consuming that CPU),33`net-probe` (the network side of the same triage),34`log-analyzer` (what the box's logs say after you learn it's resource-starved).
Run npx skillmds@latest add trac3r00/sys-health in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Sys Health It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
trac3r00 (@trac3r00) published this skill. Their other Agent Skills are listed on their SkillMD profile.
trac3r00