← Back to Skills Marketplace
Mac System Stat
by
Zhang Xiaofeng
· GitHub ↗
· v1.0.1
· MIT-0
341
Downloads
0
Stars
0
Active Installs
2
Versions
Install in OpenClaw
/install mac-system-stat
Description
Generate a concise macOS host resource report focused on local-model readiness and machine pressure. Use when the user asks about Mac resource usage, current...
README (SKILL.md)
mac-system-stat
Produce a concise macOS host snapshot using small local helpers.
Use when
- The user asks for current Mac resource usage or machine health
- You need CPU, memory, GPU, swap, power, fan, or a short host summary
- You want a truthful one-shot report, not continuous monitoring
Scripts
scripts/hoststat— aggregate JSON host snapshotscripts/memstat— RAM / compression / swap / memory pressurescripts/cpustat— CPU usage, load average, process counts, top CPU processesscripts/gpustat— GPU model + live IOAccelerator statistics via local Swift/IOKit helperscripts/powerstat— Apple Silicon IOReport-based power sampler (non-privileged, short window average)scripts/fanstat— AppleSMC-based fan reader (fan count, RPM, min/max, mode)scripts/tempstat— AppleSMC temperature sensors + pmset thermal state (CPU, battery, ambient, board)scripts/build-helpers— prebuild Swift helpers explicitly (optional; normal wrappers auto-build as needed)
Layout
- The skill is intentionally self-contained under
skills/mac-system-stat/ - Python entrypoints, shared Python modules, Swift sources, and compiled helper output all live under
skills/mac-system-stat/scripts/ scripts/bin/is generated locally on first run or viascripts/build-helpers
Release contract
- Chosen contract: source-only, self-building on first run
- Ship the skill directory with Python + Swift sources; do not rely on compiled helpers being pre-vendored
gpustat,powerstat,fanstat, andtempstatwill auto-build their helper binaries intoscripts/bin/when missing or stale- If
swiftc/ Apple Command Line Tools are unavailable, those four helpers fail truthfully with structured JSON;memstatandcpustatstill run normally - For packaging / ClawHub, exclude transient local artifacts such as
scripts/bin/contents and__pycache__/
Notes
- macOS only; Apple Silicon first
- Default path avoids sudo
- Prefer helper JSON over hand-written summaries
- GPU reads IORegistry properties directly via IOKit instead of parsing
ioregtext - Power uses IOReport Energy Model deltas; values are short-window averages, not hardware-meter absolutes
- Fan RPM comes from AppleSMC F* keys; 0 RPM can mean the fans are currently stopped
- Temperature uses curated AppleSMC keys (Tp0P, Tp0T, Te0T, Ts0P, TB0T, TW0P, Ta0P) + pmset therm state
- Packaging caveat: compiled helpers are not vendored; the target machine still needs Command Line Tools /
swiftcfor first build unless prebuilt binaries are shipped separately
Usage Guidance
This skill appears to do exactly what it says: compile and run local helpers to produce a macOS system snapshot. Before installing, consider: (1) the skill compiles and executes native Swift binaries on your machine using your system's swiftc/Xcode Command Line Tools — review the included Swift sources if you don't fully trust the publisher; (2) the helpers access low-level APIs (IOKit/AppleSMC/IOReport) to read hardware sensors — they run with your user privileges and can read hardware state, but do not perform network exfiltration or request credentials; (3) the skill writes build artifacts to scripts/bin/ within its folder; you may want to run it in a controlled environment or inspect the code prior to first run if you need stronger assurance.
Capability Analysis
Type: OpenClaw Skill
Name: mac-system-stat
Version: 1.0.1
The skill `mac-system-stat` provides macOS system telemetry by aggregating data from Python scripts and Swift-based helpers. It employs high-risk capabilities, specifically the automated compilation of Swift source code (`scripts/build-swift-helpers.sh`) and the use of `shell=True` for command execution in `_common.py`. Additionally, it interfaces with low-level and private macOS APIs (`IOKit`, `AppleSMC`, `IOReport`) to access hardware-level statistics. While these behaviors are aligned with the stated purpose of system monitoring and no evidence of malicious intent or exfiltration was found, the reliance on on-the-fly compilation and shell-based execution poses an inherent security risk.
Capability Assessment
Purpose & Capability
Name/description claim a macOS resource snapshot; the code and runtime instructions only access local system commands (top, ps, vm_stat, system_profiler, sysctl, memory_pressure) and local Swift IOKit/AppleSMC/IOReport helpers — all appropriate for the stated purpose.
Instruction Scope
SKILL.md directs the agent to build and run local Python and Swift helpers that read hardware/OS state. This is within scope, but the helpers compile native binaries and use IOKit/AppleSMC/IOReport (low-level hardware APIs). There are no network calls or attempts to read unrelated credential/config files.
Install Mechanism
No external download/install spec. The skill is source-only and self-builds Swift helpers locally using the system swiftc (Apple Command Line Tools). Built binaries are placed under scripts/bin/ in the skill directory. No remote URLs or package registry pulls are used.
Credentials
The skill requests no environment variables, no credentials, and no config paths. All accessed data are local system interfaces appropriate for a system-status tool.
Persistence & Privilege
always:false (normal). The skill will create compiled helper binaries under its own scripts/bin/ on first run — this writes files to the skill directory but does not modify other skills or global agent config. Helpers run with the invoking user's privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install mac-system-stat - After installation, invoke the skill by name or use
/mac-system-stat - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.1
fix: remove unreliable Ta0P ambient temp sensor on M4 Max
v1.0.0
Initial release: CPU, memory, GPU utilization, power draw, fan RPM, temperature sensors for macOS Apple Silicon
Metadata
Frequently Asked Questions
What is Mac System Stat?
Generate a concise macOS host resource report focused on local-model readiness and machine pressure. Use when the user asks about Mac resource usage, current... It is an AI Agent Skill for Claude Code / OpenClaw, with 341 downloads so far.
How do I install Mac System Stat?
Run "/install mac-system-stat" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Mac System Stat free?
Yes, Mac System Stat is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Mac System Stat support?
Mac System Stat is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Mac System Stat?
It is built and maintained by Zhang Xiaofeng (@tomcatzh); the current version is v1.0.1.
More Skills