mac-mini-cleanup

Audit macOS disk usage and safely remove rebuildable caches and build artifacts.

1|Updated Feb 19, 2026
One-click install
npx skills add https://github.com/Brandondaymdr/Claude-Skills --skill mac-mini-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-mini-cleanup
Source: https://github.com/Brandondaymdr/Claude-Skills/tree/main/mac-mini-cleanup
Command: npx skills add https://github.com/Brandondaymdr/Claude-Skills --skill mac-mini-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill resolves storage pressure on Mac mini systems by identifying and safely removing non-essential build artifacts, caches, and temporary files that macOS storage settings often miscategorize.

Core Features & Use Cases

  • Intelligent Audit: Performs a deep scan of the filesystem to identify large directories, package manager caches, and dormant project build artifacts.
  • Fleet-Safe Cleanup: Includes specific guardrails to protect critical Fleet autonomous-build pipelines and active development environments from accidental deletion.
  • Use Case: When the system reports low disk space or high System Data usage, use this skill to safely prune pnpm/npm caches and dormant node_modules without breaking active projects.

Quick Start

Run the mac-mini-cleanup skill to audit the current disk usage and identify safe candidates for deletion.

Frequently Asked Questions about mac-mini-cleanup

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

FAQPage Schema
How do I safely clear system data and reclaim disk space on macOS?

To safely reclaim disk space on macOS, this skill audits the filesystem to identify and remove non-essential build artifacts, caches, and temporary files that standard storage settings often miscategorize.

What is the best way to clean up dormant node_modules and package manager caches?

The best way to clean up dormant node_modules and package manager caches is a deep scan that prunes pnpm and npm stores while applying guardrails to protect active development environments from deletion.

Can I safely delete build artifacts without breaking active local development environments?

Yes, you can safely delete rebuildable build artifacts because the cleanup procedure includes specific directory exclusions designed to protect active local development environments and Fleet autonomous-build pipelines.

Do I need shell access to perform a comprehensive disk space audit on a Mac?

Yes, you need shell access to perform a comprehensive disk space audit because the skill executes disk usage analysis and verified deletion commands directly within the local macOS environment.

Why does macOS storage settings miscategorize large directories and system caches?

macOS storage settings often miscategorize large directories and system caches because they lack deep filesystem visibility, making a dedicated audit necessary to identify true disk usage and safe deletion candidates.