macos-disk-cleanup

Installation
SKILL.md

macOS Disk Cleanup

Measure before deleting, spend the safe wins first, and treat anything holding local-only state as confirm-first — it needs the user's explicit go-ahead, because nothing re-downloads it.

Process

  1. Measure top-level and home usage.
  2. Drill into the largest user-owned directories.
  3. Classify every candidate as a quick win or confirm-first, and present the two groups separately.
  4. Run the quick wins; ask before each confirm-first deletion.
  5. Re-measure and report the delta.

Done when every consumer above ~1G is classified, each confirm-first deletion was individually approved, and a before/after df -h / frames what the run actually freed.

Measure

# 1. Top-level
du -sh /System /Users /private /Applications /Library 2>/dev/null | sort -rh
Installs
38
First Seen
Aug 16, 2026