free-disk-space
Installation
SKILL.md
Free Disk Space (macOS)
Audit the disk, clear what's safely regenerable, and confirm before touching anything that isn't.
Ground rules
- Use
trash(if the CLI is available) instead ofrm -rf. Accumulate in Trash; ask the user to empty it once at the end. - Prefer a tool's own cleanup command over deleting its directories (
go clean -cache,brew cleanup --prune=all,pnpm store prune,npm cache clean --force,cargo clean). - Measure with
df -h /System/Volumes/Data(not plaindf /). - Do not clear GUI app data.
~/Library/Caches/<App>and~/Library/Application Support/<App>often hold logins, cookies, and history. Leave them alone unless the user names a specific app and accepts the risk. Prefer build cleanup, package-manager prune, stale worktrees, and external-drive offload instead.
Workflow
1. Assess
df -h /System/Volumes/Data; ls /Volumes. Note free space and whether an external drive is mounted.