A secure, developer-centric macOS storage auditing and optimization tool that scans disk usage, detects massive files, and generates actionable, non-destructive cleaning commands.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mac-disk-audit
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install mac-disk-audit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Mac Disk Audit Advisor?
The Mac Disk Audit advisor is a highly specialized tool designed to reclaim massive amounts of disk space on macOS. Built specifically to work within your custom agent configurations, this skill belongs to a premier catalog of Openclaw Skills built to empower power-users. It intelligently targets system caches, application support files, duplicate app installations, and heavy developer dependencies. Unlike typical automated cleaners, it strictly prioritizes system safety by never deleting files automatically, instead delivering structured diagnostic reports with copy-pasteable terminal commands.
By leveraging this capability, developers and power users can quickly audit local storage. It runs local CLI commands to locate high-frequency space hogs such as redundant node_modules, bloated Python virtual environments, massive git histories, and legacy iOS device backups. Integrating this into your active collection of Openclaw Skills ensures you stay in complete control of your system health without risking essential project files.
Mac Disk Audit Advisor Use Cases
- Troubleshooting urgent Disk Full or storage exhaustion warnings on macOS.
- Auditing developer projects to identify bloated node_modules, virtual environments, and Docker caches.
- Finding and cleaning massive hidden files, logs, or forgotten Xcode DerivedData compilations.
- Safely emptying the trash or clearing system caches without manual directory navigation.
- Checking for duplicate application installers (.dmg, .pkg) remaining in the Downloads folder.
How Mac Disk Audit Advisor Works
- Global Audit: Executes system disk usage commands to calculate total volume, available capacity, and high-level directory sizes.
- Targeted Scanning: Inspects known directory storage hogs like Caches, Application Support, Logs, iOS Backups, and the Trash.
- Precision Find: Recursively searches the user home directory for files exceeding 100MB and 500MB while safely bypassing mail and trash paths.
- Developer Inspection: Detects specific developer environments (node_modules, Python virtual envs, Xcode builds, Git histories, Docker images).
- Report Generation: Consolidates results into a 3-tier actionable report (Immediate Clean, Confirm and Clean, and Keep) along with safe cleanup commands.
Mac Disk Audit Advisor Setup
To deploy this capability within your environment, ensure you have the required CLI utilities installed. Most are pre-installed on macOS, but installing trash is recommended for extra safety.
Prerequisites
Install the trash command utility via Homebrew to support safe non-destructive file deletion:
brew install trash
Verification
Confirm that your system path has the mandatory binaries available:
which du find git
Once verified, import the skill configuration into your active roster of Openclaw Skills to begin auditing macOS storage.
Mac Disk Audit Advisor Data Schema & Taxonomy
The Mac Disk Audit tool produces a highly structured report using a three-tier system risk matrix. This ensures clear demarcation between safe-to-delete files and sensitive directory structures.
| Clean Tier | Target Directories / Items | Risk Level | Recovery Method |
|---|---|---|---|
| Red (Immediate Clean) | Trash, Caches, Xcode DerivedData, Old downloads | Low | Rebuilt automatically / Empty Trash |
| Yellow (Confirm Clean) | Python venvs, node_modules, iOS MobileSync Backups | Medium | Rebuilt via package managers / iCloud |
| Green (Keep) | Scanned system or user document paths | High | Not recommended for deletion |
| Developer Special | Deep git history bloating (.git) | Low | Compact storage via git gc --aggressive |
Mac Disk Audit Advisor Advanced Features
- Zero Auto-Delete Rule: Ensures maximum data safety by strictly generating reports and CLI commands without running destructive rm commands directly.
- Developer-Specific Scans: Deep integration scanning for specialized developer assets like .venv, node_modules, Docker system volume prunes, and Xcode simulator data.
- Git Compress Optimizer: Provides aggressive optimization scripts to compress bulky local git repositories while preserving full commit histories.
- Multi-App Installer Detection: Scans downloads and desktops for leftover macOS installation packages (.dmg, .pkg) to quickly recover gigabytes of dead space.
- Interactive Command Verification: All recommended actions are fully copy-pasteable, empowering users to review risks before committing disk changes inside Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Database Migration Risk Review
A local-first AI coding agent skill designed to classify database migrations, expose runtime production risks, and recommend zero-downtime deployment sequences.
Skill Optimizer
A dedicated agent skill designed to automatically modify, update, and optimize your local agent workflows based on real-world execution feedback.
Debug TypeScript Error
A local-first, standalone engineering skill designed to translate complex TypeScript errors into plain English and implement surgical, safe type fixes without relying on lazy type suppression.
Generate Storybook Story
An AI-powered local development skill that automatically generates clean, minimal, and highly realistic Storybook stories for frontend components.
Backend Test Plan
An AI-powered development skill that automatically converts backend code changes into verifiable success criteria and a minimum useful test plan.
Anime Semantic Recommender
An AI agent skill for delivering Chinese-first, source-grounded anime recommendations based on nuanced taste, relationship dynamics, and emotional resonance.
Featured*
