← Back to Skills Marketplace
Pi Health
by
Jonas Pfalzgraf
· GitHub ↗
· v1.0.0
1481
Downloads
0
Stars
4
Active Installs
1
Versions
Install in OpenClaw
/install pi-health
Description
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).
README (SKILL.md)
Pi Health
Run the health check script:
bash scripts/health.sh
What It Checks
| Check | Source | Warning | Critical |
|---|---|---|---|
| CPU Temperature | thermal_zone0 | >70°C | >80°C |
| Throttling | vcgencmd get_throttled | any flag set | under-voltage |
| Voltages | vcgencmd measure_volts | — | — |
| Memory | free -m | >75% | >90% |
| Disk | df / | >75% | >90% |
| CPU Frequency | cpufreq sysfs | — | — |
| Load Average | /proc/loadavg | >nCPU | >2×nCPU |
| Fan | hwmon sysfs | — | — |
| Overclock | config.txt | detected | — |
| Power | dmesg | — | under-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 withlibraspberrypi-bin)bc(standard on Pi OS)- No external dependencies or API keys
Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill
Name: pi-health
Version: 1.0.0
The skill bundle is a Raspberry Pi health monitor. The `SKILL.md` file contains clear, benign instructions to execute the `scripts/health.sh` script, with no evidence of prompt injection. The `health.sh` script uses standard Linux and Raspberry Pi-specific commands (`vcgencmd`, `free`, `df`, `dmesg`, `cat /sys`, `grep /boot/config.txt`) to gather system metrics. It does not perform any network communication, access sensitive user data, attempt persistence, or use obfuscation, aligning perfectly with its stated purpose.
Capability Assessment
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).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install pi-health - After installation, invoke the skill by name or use
/pi-health - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release: CPU temp, throttling, voltage, memory, disk, fan, overclock, power checks
Metadata
Frequently Asked Questions
What is Pi Health?
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). It is an AI Agent Skill for Claude Code / OpenClaw, with 1481 downloads so far.
How do I install Pi Health?
Run "/install pi-health" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Pi Health free?
Yes, Pi Health is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Pi Health support?
Pi Health is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Pi Health?
It is built and maintained by Jonas Pfalzgraf (@josunlp); the current version is v1.0.0.
More Skills