Pi Health

v1.0.0

Raspberry Pi health monitor. Check CPU temperature, throttling status, voltage levels, memory/disk usage, fan RPM, overclock detection, and power issues. Use when monitoring Pi health, diagnosing thermal throttling, checking for under-voltage, or verifying system stability on any Raspberry Pi (Pi 3/4/5, arm64/armhf).

0· 1.5k·4 current·4 all-time
byJonas Pfalzgraf@josunlp

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for josunlp/pi-health.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "Pi Health" (josunlp/pi-health) from ClawHub.
Skill page: https://clawhub.ai/josunlp/pi-health
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Canonical install target

openclaw skills install josunlp/pi-health

ClawHub CLI

Package manager switcher

npx clawhub@latest install pi-health
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
Purpose & Capability
The name/description (Pi health monitor) matches the provided files: SKILL.md instructs running scripts/health.sh and the script reads CPU temp, throttling, voltages, memory/disk, fan, overclock and dmesg for power events. Nothing requested (no env vars, no installs) is unrelated to the stated purpose.
Instruction Scope
SKILL.md simply instructs running the bundled script. The script reads standard local system paths (/sys, /proc, /boot, dmesg), invokes expected utilities (vcgencmd, free, df) if present, and prints results. Those reads are appropriate for a local health check; there are no instructions to collect or transmit data externally.
Install Mechanism
There is no install spec — this is instruction-only with an included script. Nothing is downloaded or written to disk by an installer, so install risk is low.
Credentials
The skill requests no environment variables, credentials, or config paths beyond reading local system files needed for monitoring. This is proportionate to the tool's purpose.
Persistence & Privilege
The skill does not request always:true, does not modify other skills or system configuration, and does not persist credentials. It only runs a read-only health-check script (no writes or daemon installation).
Assessment
This skill is coherent and the included script matches the description. It performs only local reads (sysfs, /proc, /boot/config.txt, dmesg) and runs standard utilities if available; it does not contact the network or require secrets. Before running, note that some outputs (dmesg, certain sysfs files) may require sufficient permissions and some tools (vcgencmd) are optional. Because the source/homepage is unknown, you can manually inspect scripts/health.sh (it is included) before executing. If you will run it on a production Pi, consider running it interactively (not as an always-on autonomous skill) and review whether you need root privileges for complete output.

Like a lobster shell, security has layers — review code before you run it.

arm64vk97fjxw00b773h4y2rjtacwe5d80v92mhealthvk97fjxw00b773h4y2rjtacwe5d80v92mhomelabvk97fjxw00b773h4y2rjtacwe5d80v92mlatestvk97fjxw00b773h4y2rjtacwe5d80v92mmonitoringvk97fjxw00b773h4y2rjtacwe5d80v92mraspberry-pivk97fjxw00b773h4y2rjtacwe5d80v92m
1.5kdownloads
0stars
1versions
Updated 2mo ago
v1.0.0
MIT-0

Pi Health

Run the health check script:

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

Comments

Loading comments...