mac-disk-cleanup

Audit macOS disk usage and reclaim space through approval-gated cleanup batches.

28|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/ma08/botfiles --skill mac-disk-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-disk-cleanup
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/mac-disk-cleanup
Command: npx skills add https://github.com/ma08/botfiles --skill mac-disk-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

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.

Frequently Asked Questions about mac-disk-cleanup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I safely free up disk space on macOS without deleting important project files?

macOS disk cleanup can be performed safely by first running a read-only audit to identify space hogs like Xcode artifacts and Docker state, then executing destructive actions only after explicit batch approval to ensure no user data or project files are lost.

What developer artifacts take up the most storage on macOS?

Xcode DerivedData, Docker build cache, package manager caches, and build outputs are the primary developer artifacts that accumulate and consume significant macOS storage over time, which can be identified through a disk usage audit.

How can I audit my Mac's disk usage before modifying any files?

Auditing Mac disk usage involves a read-only scan that identifies space hogs such as caches and Docker state without modifying any files, providing a safe assessment of storage consumption before proposing any cleanup actions.

Does cleaning Xcode and Docker caches risk deleting my active development work?

Cleaning Xcode and Docker caches does not risk active development work when using an approval-gated process that enforces a read-only audit phase and requires explicit consent before executing any destructive cleanup actions.

What is the best way to reclaim storage from package manager caches on macOS?

The best way to reclaim storage from package manager caches is to use a workflow that proposes explicit categorized cleanup batches for approval, ensuring safe removal and post-cleanup verification for low-risk storage reclamation.

Can I recover disk space if my Mac is nearly full due to large build outputs?

You can recover disk space from large build outputs by running an audit to identify unused developer artifacts and approving explicit cleanup batches, safely resolving near-full disk scenarios without accidental data loss.