Home / Claude Code skill packs

mac-maintenance-skills

Claude Code skills for cleaning up and speeding up a Mac: read-only survey first, safe tier removes only what programs recreate, leftovers and duplicate finders.

Python · MIT · latest v0.2.0

What it is

Mac maintenance skills for Claude Code: a survey that only measures, a safe tier that removes only what programs recreate, and a written list for every decision that is yours.

mac-maintenance-skills is a Claude Code plugin with three skills for people whose Mac has filled up with caches, duplicate exports, leftovers of uninstalled apps and a few gigabytes pinned in memory, and who do not want a cleaner that guesses. It exists because the usual cleanup either deletes too little to matter or deletes something that mattered: each skill pairs the model's judgement with a standard-library Python script that measures before it proposes, removes only regenerable caches on its own, and moves anything of yours to a dated folder in the Trash instead of deleting it.

Common searches it answers: "System Data is huge", a Docker.raw file that keeps growing, and duplicate photos or leftovers of uninstalled apps. Time Machine local snapshots are out of scope.

/plugin marketplace add basitalisandhu/mac-maintenance-skills
/plugin install mac-maintenance@mac-maintenance-skills

This pack is also part of claude-skills, which holds every skill I maintain as one marketplace: /plugin marketplace add basitalisandhu/claude-skills.

Quickstart: open Claude Code and ask "look at my Mac and clean up the garbage", or run a script directly from a clone of this repository:

python3 plugins/mac-maintenance/skills/mac-cleanup/scripts/safe_clean.py

That prints the safe-tier plan with sizes and changes nothing; add --apply to run it.

Questions, bugs and ideas: open an issue on this repository. Security reports: see SECURITY.md.

Install

$ python3 scripts/demo_home.py demo-home
Demo home written to demo-home: 10 files. See the commands in this script's --help.

$ python3 plugins/mac-maintenance/skills/mac-duplicate-finder/scripts/find_dupes.py --home demo-home --quiet
Scanned 5 files in 4 roots; 2 duplicate groups; 5.5 MB wasted

Largest groups (of 2):
      3.0 MB wasted  2 x 3.0 MB
      demo-home/Desktop/IMG_0412 (1).MOV
      demo-home/Desktop/IMG_0412.MOV
      2.5 MB wasted  2 x 2.5 MB
      demo-home/Documents/Invoices/invoice-2026-09.pdf
      demo-home/Downloads/invoice-2026-09.pdf

Folders that duplicate each other:
      3.0 MB      1 groups  Desktop (copies inside it)
# ... see the README for the rest

From the README; see the full README for every option.

Releases

Posts about it

More in Claude Code skill packs

All tools

Topics: agent-skills, claude-code, claude-code-plugin, claude-skills, cleanup, developer-tools, disk-cleanup, disk-space, docker, duplicate-files, hacktoberfest, homebrew, mac, macos, maintenance, python, uninstall, xcode