Installation

clawhub install josunlp/pi-health

Summary

Run the health check script:

SKILL.md

Pi Health

Run the health check script:

bash
bash scripts/health.sh

What It Checks

CheckSourceWarningCritical
CPU Temperaturethermal_zone0>70°C>80°C
Throttlingvcgencmd get_throttledany flag setunder-voltage
Voltagesvcgencmd measure_volts
Memoryfree -m>75%>90%
Diskdf />75%>90%
CPU Frequencycpufreq sysfs
Load Average/proc/loadavg>nCPU>2×nCPU
Fanhwmon sysfs
Overclockconfig.txtdetected
Powerdmesgunder-voltage

Exit Codes

  • 0 — Healthy (all checks passed)
  • 1 — Warnings (non-critical issues)
  • 2 — Critical (needs immediate attention)

Requirements

  • Raspberry Pi OS (Bookworm or later)
  • vcgencmd (optional but recommended — comes with libraspberrypi-bin)
  • bc (standard on Pi OS)
  • No external dependencies or API keys

Recommended skills

Browse all →

Related guides

Hand-picked reading to help you choose, install, and use agent skills.