macos-disk-usage
Installation
SKILL.md
macOS Disk Usage & Space Recovery
When to Use This Skill
| Use this skill when... | Use something else when... |
|---|---|
df reports a volume near-full and you need the honest figure |
The root disk on Linux is full — use the Linux-focused disk-full-recovery rule |
| Hunting "what's eating my disk" on macOS | General process forensics — use ps/top directly |
| Reclaiming space from OrbStack/Docker, caches, or local snapshots | A GUI hang/freeze occurred — see macos-incident-postmortem |
du totals and free space disagree (purgeable snapshots, or CoW clones) |
launchservicesd DB bloat specifically — see launchservices-health |
Deleting a big tree freed far less than du promised |
— |
Platform Guard
This skill is macOS-only. APFS containers, diskutil apfs, tmutil local snapshots, and BSD du block-counting are Darwin-specific. Refuse to act if uname -s is not Darwin.
test "$(uname -s)" = "Darwin" || { echo "macos-plugin: not Darwin, refusing"; exit 1; }