| name | macos-performance-benchmark |
| description | Repeatable macOS/Apple-Silicon benchmark + diagnostics scored PASS/WARN/FAIL with saved reports. Use when baselining a Mac, verifying it performs to spec, or tracking CPU/memory/disk/thermal health. |
| args | [mode] |
| argument-hint | mode — diagnose | bench | full | report (default full) |
| allowed-tools | Bash(bash *), Bash(uname *), Bash(sudo bash *), Read, Grep, Glob |
| created | "2026-07-03T00:00:00.000Z" |
| modified | "2026-08-07T00:00:00.000Z" |
| reviewed | "2026-08-07T00:00:00.000Z" |
macOS Performance Benchmark (Apple Silicon)
A repeatable, threshold-scored performance suite. Runs diagnostics and
benchmarks for CPU/thermals, memory/swap, disk/storage, and startup/background
load, writes a timestamped run under ~/.cache/macos-perf/, and generates a
markdown report with PASS/WARN/FAIL verdicts against tunable baselines.
When to Use This Skill
| Use this skill when... | Use something else when... |
|---|
| You want a repeatable baseline — "is this Mac performing to spec?" scored PASS/WARN/FAIL | The Mac is hot/slow right now and you need live attribution — use macos-performance-triage |
| Tracking CPU/memory/disk/thermal health across runs, comparing before/after a change | The machine actually hung or panicked — use macos-incident-postmortem |
| Producing a saved report to keep or share | A security extension (Kandji ESF, XProtect, EDR) is the hot process — use endpoint-security-cpu |
| Benchmarking NVMe/AES/SHA/memory throughput against thresholds | You're reclaiming disk space — use macos-disk-usage |
This skill is the proactive baseline companion to the reactive
macos-performance-triage playbook: run this to know the machine's normal;
run triage when something is wrong now.
Platform Guard
macOS-only. sysctl, pmset, powermetrics, macmon, diskutil, and the
Apple-Silicon counters are Darwin-specific. run.sh refuses on non-Darwin.
test "$(uname -s)" = "Darwin" || { echo "macos-plugin: not Darwin, refusing"; exit 1; }
Parameters
Parse $ARGUMENTS for the run mode (default full):
