mac-free-spacelisted
Install: claude install-skill Shukur93/mac-free-space
# Mac Free Space
Goal: find where space went, explain it, and reclaim it **safely**. Always measure first, report, then delete only with the user's OK.
## Ground rules
- **Scan first, delete later.** Run `scripts/scan.sh` (read-only) and show a ranked table of findings with sizes before touching anything.
- **Ask before every deletion**, naming the exact path and size. Prefer moving to Trash (`mv … ~/.Trash/`) over `rm -rf` for user files. Caches/derived build data can be `rm -rf`'d after OK.
- **Never delete**: anything under `/System`, `/usr` (except `/usr/local` brew junk via brew), `/private/var/db`, `/private/var/vm` (swap/sleepimage — managed by macOS), `~/Library/Containers` or `~/Library/Group Containers` wholesale, `~/Library/Application Support` wholesale, `~/Library/Mobile Documents` (iCloud Drive), Photos/Music libraries, Keychains, Mail `V*` folders by hand.
- Don't disable SIP, Spotlight, or Time Machine to save space.
- `sudo` needs the user's password — give them the command to run themselves rather than typing passwords.
- Terminal/Claude may need **Full Disk Access** (System Settings → Privacy & Security → Full Disk Access) for accurate sizes of `~/Library` subfolders; "Operation not permitted" errors mean it's missing.
- **No "Mac cleaner" apps** (CleanMyMac-style "ScammyMcDiskCleaner" tools). If the user has one installed, recommend trashing it. Finding space needs nothing beyond Finder/Terminal.
- Scans only see the **current user's** home folder. Oth