Disk Explorer

Disk Explorer

Explore what's taking up space on the Mac and give the user actionable recommendations.

Use this skill when the user asks things like: "what's taking up space?", "where is my disk space going?", "show me large files", "what can I delete?", "why is my Mac full?", "explore my disk", "מה תופס מקום?", "מה אפשר למחוק?", "qu'est-ce qui prend de la place?", "¿qué ocupa espacio?", or any question about understanding disk usage without necessarily cleaning yet.

---

How to run this skill

Run the commands below, analyze the output, and respond in the user's language with clear, prioritized recommendations.

Environment note: This skill works in both Claude Code (native Bash tool) and Cowork (Desktop Commander). Use whichever shell execution method is available in your environment to run the bash commands below.

---

Step 1 — Overall disk usage

df -h / | tail -1

Report total disk size, how much is used, and how much is free.

---

Step 2 — Top-level home folder sizes

du -sh ~/* 2>/dev/null | sort -rh | head -15

Identify which top-level folders in the home directory are largest.

---

Step 3 — Known large locations

Check these locations — they are commonly large and often overlooked:

du -sh \
  ~/Desktop \
  ~/Downloads \
  ~/Documents \
  ~/Movies \
  ~/Music \
  ~/Library/Developer \
  ~/Library/Application\ Support \
  ~/Library/Caches \
  2>/dev/null | sort -rh

---

Step 4 — Developer-specific large locations (only if ~/Library/Developer exists)

du -sh \
  ~/Library/Developer/Xcode/DerivedData \
  ~/Library/Developer/CoreSimulator/Devices \
  ~/Library/Developer/Xcode/iOS\ DeviceSupport \
  2>/dev/null | sort -rh

---

Step 5 — Find large files (>500 MB) anywhere in home

find ~ -maxdepth 6 -size +500M -not -path "*/.*" 2>/dev/null | while read f; do du -sh "$f" 2>/dev/null; done | sort -rh | head -20

---

Step 6 — Look for common storage wasters

# ZIP files next to folders with the same name (often redundant)
find ~/Desktop ~/Downloads ~/Documents -maxdepth 2 -name "*.zip" 2>/dev/null

# Old iOS backups
du -sh ~/Library/Application\ Support/MobileSync/Backup/ 2>/dev/null

# Trash
du -sh ~/.Trash/ 2>/dev/null

---

Report

Present findings clearly in the user's language, organized by priority:

1. Quick wins (safe to clean now)

Items that are clearly redundant or cache-only — e.g. ZIP files next to extracted folders, cache folders, old iOS backups.

2. Review recommended (user decides)

Large folders that require user judgment — Downloads, old projects, Movies, iOS device support files.

3. Developer bloat (if applicable)

Xcode DerivedData, simulators, device support — large but safe to delete if not actively needed.

4. Already optimized

If the disk looks clean, say so clearly. Don't invent problems.

---

Offer next steps

After the report, offer:

• "I can run a full cleanup now" → triggers the mac-cleanup skill
• "I can help you move large files to cloud storage" → guide the user to iCloud Drive or another service
• "I can set up a weekly automated cleanup" → suggest scheduling

Do not delete anything in this skill. Only analyze and recommend.