What problem does it solve?
Manually cleaning macOS disk space often leads to accidental deletion of important personal files, active project data, or critical system caches, especially for developers and power users who accumulate large volumes of build artifacts, package caches, and developer tool data over time. This skill eliminates that risk by enforcing strict safety guardrails and a read-only first workflow.
Core Features & Use Cases
- Read-Only Audit: First scans disk usage and identifies space hogs without modifying any files, including caches, Xcode artifacts, Docker state, and package manager data.
- Approval-Gated Cleanup: Proposes explicit, categorized cleanup batches for user approval, only executing destructive actions after explicit consent.
- Use Case: A developer whose Mac is nearly full can use this skill to safely identify and remove tens of gigabytes of unused Xcode DerivedData, Docker build cache, and old package caches without risking loss of active work or personal files.
Quick Start
Use the mac-disk-cleanup skill to audit my Mac's current disk usage and propose safe, approval-gated cleanup steps to free up storage space.