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 of rm -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 plain df /).
  • 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.

2. Survey

Installs
68
GitHub Stars
174
First Seen
Jul 29, 2026
free-disk-space — bholmesdev/skills