← ClaudeAtlas

mac-free-spacelisted

Find what is eating disk space on macOS and free it safely — including the mysterious "System Data" category. Use when the user says their Mac is full, low on storage, asks "where's my disk space", "what is System Data", "clear System Data", "free up space", "clean my Mac", or wants to find large files/folders.
Shukur93/mac-free-space · ★ 1 · Data & Documents · score 74
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