mac-maintenance-cleanup

Orchestrate safe macOS cleanup operations with Mole commands and dry-run previews.

1|Updated Dec 11, 2025
One-click install
npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill mac-maintenance-cleanup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mac-maintenance-cleanup
Source: https://github.com/evanfang0054/cc-system-creator-scripts/tree/main/skills/mac-maintenance-cleanup
Command: npx skills add https://github.com/evanfang0054/cc-system-creator-scripts --skill mac-maintenance-cleanup

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

macOS maintenance often suffers from cached files, residual app data, and bloated disk usage that degrade performance. This Skill provides a safe, automated workflow to perform comprehensive maintenance, including system cache cleanup, application uninstall with residual cleanup, disk space analysis, cleaning development artifacts, and general system optimization.

Core Features & Use Cases

  • Interactive maintenance assistant: guided menus for Daily cleanup, Deep cleanup, Developer cleanup, and smart diagnostic flows.
  • Safe operations: default dry-run previews, user confirmation prompts, and detailed logs to prevent accidental data loss.
  • Mole-based automation: leverages Mole commands mo status, mo analyze, mo clean, mo uninstall, mo purge, and mo optimize to orchestrate tasks on macOS.
  • Use Case: When disk space is running low and you need both quick cache cleanup and selective app uninstall, this skill can guide you through a safe, auditable cleanup.

Quick Start

  • Install Mole and configure the Mac Maintenance Cleanup skill in Claude Code.
  • Run the Mac Maintenance Cleanup skill and select a mode from the main menu.
  • Start with a dry-run: mo clean --dry-run, then execute with mo clean after your confirmation.

Frequently Asked Questions about mac-maintenance-cleanup

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

FAQPage Schema
How do I safely clean up macOS system caches and residual app data?

You can safely clean up macOS system caches by running a dry-run preview to identify removable files, reviewing the generated list, and executing the deletion only after explicit confirmation. This process generates detailed logs to prevent accidental data loss.

What is the best way to free up disk space on a Mac for development artifacts?

Freeing up Mac disk space for development artifacts involves running smart diagnostics to analyze disk usage, selecting a developer cleanup mode, and purging build caches and residual project files through guided interactive menus with dry-run safeguards.

Can I uninstall macOS applications and remove leftover files at the same time?

Yes, you can uninstall macOS applications and remove leftover files simultaneously by using a guided uninstall command that targets both the application bundle and its associated residual data, ensuring a complete cleanup with a dry-run preview first.

Does macOS maintenance cleanup require a specific tool to run?

Yes, macOS maintenance cleanup requires the Mole tool installed and configured in your Claude Code environment to orchestrate disk analysis, caching, uninstallation, and optimization commands safely.

How do I perform a deep disk cleanup on macOS without deleting important files?

Perform a deep disk cleanup safely by starting with a dry-run preview to audit all targeted cache and artifact files, then confirming the deletion explicitly. The workflow logs all operations to ensure important files are not deleted.

When should I not use an automated macOS cleanup script?

You should avoid using automated macOS cleanup scripts when you need to manually inspect specific system directories or lack a recent backup, as mass deletion of caches and artifacts might affect running applications or unsaved development environments.