Mac Health Check

Check the current temperature, load, memory, swap, and power usage of this Mac with `macmon`. Use when the user asks for their Mac's current temperature, Mac...

Security Scan

The skill content, files, and install steps are consistent with its stated purpose (running macmon to report Mac telemetry); it requests no secrets and installs macmon via Homebrew.

Purpose & Capability

Name/description match the code and instructions: the skill runs the macmon binary (or a login-shell wrapper) and summarizes its JSON output. Declared OS restriction (darwin) and the brew install of macmon are appropriate.

Instruction Scope

Runtime instructions and scripts only run the macmon binary, optionally via a zsh login shell, and parse JSON from macmon or stdin/files. They do not read unrelated system files, access network endpoints, or prompt for unrelated secrets. The wrapper and Python script use subprocess to invoke local binaries, which is expected for this purpose.

Install Mechanism

Install is a Homebrew formula (macmon). Homebrew is a standard package source on macOS. No downloads from arbitrary URLs or archive extracts are present in the skill itself.

Credentials

The skill requires no environment variables, no credentials, and no config paths. It references typical local paths (/opt/homebrew/bin) and a login-shell fallback — reasonable for Homebrew-installed binaries.

Persistence & Privilege

Skill is not marked always:true and is user-invocable. It does not modify other skills or request elevated persistent privileges.

Assessment

This skill is coherent: it simply runs the local macmon program (or a small zsh wrapper) and summarizes its JSON output. Before installing, verify you trust the macmon Homebrew formula/source you will install, and confirm you are comfortable allowing the agent to run local commands (it will execute macmon on your machine). The skill does not request secrets or contact external endpoints itself; any risk would come from the installed macmon binary — review that project if you need higher assurance.

Use macmon as the source of truth for live Mac telemetry.

OpenClaw's host exec environment can be too minimal for some Homebrew-installed binaries. This skill includes a wrapper at {baseDir}/bin/macmon-safe.sh that retries macmon through zsh -lic when needed.

Use when

• "What's my Mac temperature right now?"
• "What's the temperature of my Mac?"
• "Give me a health check for this Mac"
• "How much RAM and swap is in use?"
• "Is this Mac under load right now?"
• "Show current CPU or GPU usage on this Mac"

Installation

Via ClawHub

clawhub install mac-health-check

Manual

git clone https://github.com/RuBAN-GT/mac-health-check-skill.git ~/.openclaw/skills/mac-health-check

Quick start

For a one-shot snapshot, run:

python {baseDir}/scripts/macmon_status.py

Default one-shot mode uses -i 200 so the first sample returns faster.

If macmon works only from a login shell in your OpenClaw setup, you can also use the wrapper directly:

bash {baseDir}/bin/macmon-safe.sh pipe -s 1

Raw JSON

For raw JSON, run:

python {baseDir}/scripts/macmon_status.py --format json --pretty

Saved output or stdin

For saved macmon output or stdin, run:

bash {baseDir}/bin/macmon-safe.sh pipe -s 1 > /tmp/macmon.jsonl
python {baseDir}/scripts/macmon_status.py --input /tmp/macmon.jsonl
cat /tmp/macmon.jsonl | python {baseDir}/scripts/macmon_status.py --input -

Verify setup

Run:

bash {baseDir}/bin/macmon-safe.sh pipe -s 1

If this prints a JSON sample, the skill is ready to use.

What to report

Default summary includes:

• CPU average temperature
• GPU average temperature
• Performance CPU usage and frequency
• Efficiency CPU usage and frequency
• GPU usage and frequency
• System, CPU, and GPU power
• RAM usage
• Swap usage

Keep the explanation practical and short unless the user asks for a deeper breakdown.

Interpretation hints

• CPU temp under ~60C: usually calm or light work
• ~60C to 85C: normal active load
• 85C+: hot; mention sustained load or possible thermal pressure
• swap usage above 0: memory pressure may be starting
• high system power + high temps: likely sustained work

Do not overclaim danger from one sample. Call it a snapshot.

Failure modes

• If macmon is missing, say so plainly.
• If macmon is installed but errors out, ask the user to run bash {baseDir}/bin/macmon-safe.sh pipe -s 1 manually and paste the JSON.
• On some macOS setups, Homebrew-installed binaries work only from a login shell. Prefer bash {baseDir}/bin/macmon-safe.sh ... in OpenClaw exec contexts.
• When reading from files or stdin, treat the last non-empty line as the sample.

Reference

Use references/sample-output.md when you need a reminder of the common JSON fields emitted by macmon.