Agent skill · ma08
mac-disk-cleanup
Safely audit and clean macOS disk space with read-only baselines, approval-gated cleanup batches, Docker/Xcode/cache/log cleanup, verification, and task artifacts. Use when the user asks to free Mac disk space, clean Mac storage, reclaim disk space on macOS, investigate a near-full Mac, audit caches or developer artifacts, or create a repeatable Mac cleanup workflow.
What it needs
About 3k tokens when loaded.
What this skill does
Mac Disk Cleanup Use this skill to reclaim macOS disk space without accidental data loss. The default workflow is: read-only audit, trusted-tool research, action table, explicit batch approval, cleanup, verification, and durable notes. Safety Rules Do not run destructive commands until the user approves the exact batch. Treat user media, Documents, Downloads, browser profiles, app support data, secrets, project data, active worktrees, virtualenvs, Docker volumes, Photos libraries, and external-drive moves as protected by default. Do not use /Volumes/ as an archive destination unless the user explicitly includes archive/offload scope. Ask narrowly for macOS privacy permissions only when a blocked path matters to an approved cleanup branch. Save one-off audit and cleanup scripts under the active task's task-progress-artifacts/scratchpad/ before running them. Capture before/after evidence for every cleanup batch. Read-Only Audit Start with bounded checks: Then inspect likely candidates, keeping output bounded: ~/.cache children. ~/Library/Caches children. ~/Library/Logs children. ~/Library/Developer/Xcode/DerivedData, Archives, iOS DeviceSupport. ~/Library/Developer/CoreSimulator. package-manager cache paths from owner commands. Docker state from docker system df. selected project build artifacts such as build, dist, .next, target, nodemodules, .venv, and cache directories, without deleting them. user-facing folders such as Downloads/Documents only for size review. Avoid broad recursive scans when the disk is critically low or macOS privacy blocks many subtrees. Trusted Cleanup Mechanisms Prefer owner commands over manual deletion: Homebrew: brew cleanup --dry-run --prune=all before brew cleanup --prune=all. npm: npm config get cache; npm cache clean --force only with approval. pnpm: pnpm store path; pnpm store prune. uv: uv cache dir; prefer uv cache prune over uv cache clean. pip: pip3 cache info; pip3 cache purge. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills ma08/mac-disk-cleanup