SkillHub

mac-system-stat

v1.0.1

生成简洁的 macOS 资源报告，聚焦本地模型就绪状态与系统压力。当用户询问 Mac 资源使用情况时使用。

Sourced from ClawHub, Authored by Zhang Xiaofeng

Installation

Please help me install the skill `mac-system-stat` from SkillHub official store. npx skills add tomcatzh/mac-system-stat

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 snapshot
  • scripts/memstat — RAM / compression / swap / memory pressure
  • scripts/cpustat — CPU usage, load average, process counts, top CPU processes
  • scripts/gpustat — GPU model + live IOAccelerator statistics via local Swift/IOKit helper
  • scripts/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 via scripts/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, and tempstat will auto-build their helper binaries into scripts/bin/ when missing or stale
  • If swiftc / Apple Command Line Tools are unavailable, those four helpers fail truthfully with structured JSON; memstat and cpustat still 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 ioreg text
  • 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 / swiftc for first build unless prebuilt binaries are shipped separately