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; plaindf /,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
trashwhen available. Accumulate items in Trash and ask once before emptying it. Iftrashis 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.