system-cleanup

Installation
SKILL.md

System cleanup

Output: more physical free space on the Data volume, with a report of what was cleared, kept and left for approval.

Needs: a macOS host and a cleanup or offload request. If the request is performance tuning, malware removal, or deleting personal or application data without approval, return and say what is missing.

Audit the disk, clear what is safely regenerable, and confirm before touching anything else.

Ground rules

  • Measure physical free space on the macOS Data volume with df -h /System/Volumes/Data; plain df /, du, Finder categories, and cleaner estimates are supporting evidence rather than the result.
  • Prefer a tool's current native cleanup command over deleting its directories. Confirm the installed interface with its own help/current documentation and use a dry run when available; do not preserve a package-manager command catalogue here.
  • For direct deletion, use trash when available. Accumulate items in Trash and ask once before emptying it. If trash is unavailable, obtain confirmation before permanent deletion.
  • Remove without asking only what is clearly safe: regenerable, or already preserved elsewhere (a merged and pushed branch's clean worktree, a backed-up file). List everything else with its reason and wait for the user's explicit yes. Move to Trash or a backup rather than deleting outright whenever that is possible.
  • A general cleanup request supplies standing authority for exact, inactive, regenerable build artifacts and package/language caches within the requested cleanup boundary; reuse it without asking per item.
  • Do not clear GUI application data automatically. Report application cache/support-directory sizes unless the user names the app and accepts the risk to logins, cookies, history, or local state.
  • Ask before removing personal files, media, applications, projects, backups, model weights, Docker volumes, virtual machines, emulator snapshots, SDKs, runtimes, or toolchains.
  • Never bypass SIP, weaken permissions, kill unrelated processes, or delete protected system paths to satisfy a cleanup estimate.
Installs
40
First Seen
Aug 30, 2026