Skills Explorer Add Skills

macos-cleaner

An agent skill by daymade, from daymade/claude-code-skills. Tags: cleanup, debugging, macos, performance, storage.

What it does

Diagnoses and safely reclaims macOS disk space. Use when a Mac is low on storage, reports “Caching needs more space,” shows large Apple Content Caching or AssetCacheManagerUtil usage, or needs analysis of caches, logs, application remnants, large or duplicate files, Docker or OrbStack, Chromium code-sign clones, Homebrew, npm, pip, Xcode, and other developer storage. Routes known suspects to targeted read-only diagnosis before broad scans, distinguishes nominal path accounting from physical release, requires an impact-and-recovery plan plus explicit confirmation before state changes, and verifies disk space and co-resident services afterward.

Install

With the skills CLI, which installs into Claude Code, Codex, Cursor and other agents:

npx skills add daymade/claude-code-skills --skill macos-cleaner

Or copy the skill folder into Claude Code's skills directory by hand (~/.claude/skills for every project, or .claude/skills inside one):

git clone --depth 1 https://github.com/daymade/claude-code-skills
cp -r claude-code-skills/daymade-macos/macos-cleaner ~/.claude/skills/macos-cleaner

Safety box score

Grade D, elevated risk: 56 of 100 risk points, rated 2026-09-23. The grade rates what the skill and its scripts can reach on the machine of whoever installs it, across eight categories from shell execution to secrets access. How the score works.

This skill is a macOS disk-cleanup assistant that inspects caches, logs, developer tooling, Docker/OrbStack, and Apple Content Caching, then can execute approved cleanup actions. Its main risks are irreversible deletion, admin-level system changes, and incomplete auditability because several key references/scripts were not readable here.

Category levels, from 0 (none) to 3 (high)
CategoryLevelWhy
Code & shell execution2 (moderate)The shipped helpers call `subprocess.run` on local commands like `du`, `find`, `df`, and `docker`, and the skill drives them with `uv run ...`, so it can execute real shell commands on the user's machine.
Network access0 (none)I found no explicit upload/download or remote-posting commands in the reviewed files; any redownloads are indirect consequences of cleanup, not direct network actions.
Filesystem reach3 (high)The skill can delete exact paths, move items to Trash, write `~/.macos-cleaner`, and a bundled helper does recursive deletion via `shutil.rmtree(path)`.
Secrets & credentials1 (low)`scripts/safe_delete.py` explicitly names secret-bearing locations like `~/.ssh`, `~/.aws`, and `~/.gnupg` in its safety logic, though I did not find code that reads or exfiltrates secrets.
Privilege & persistence3 (high)Apple Content Caching repair uses `sudo AssetCacheManagerUtil ...` and `defaults write /Library/Preferences/com.apple.AssetCache.plist CacheLimit ...`, so admin/root access is part of the skill.
Instruction hijack surface0 (none)I did not find prompt-hijacking text that tells the agent to ignore its rules or hide behavior; the skill mostly adds confirmation gates and scope checks.
Irreversible actions3 (high)It can deactivate and flush Content Caching and permanently delete files or directories after approval, so its purpose includes irreversible state changes.
Transparency2 (moderate)Several governing references and scripts were not readable here (`references/cleanup_targets.md`, `references/docker_analysis.md`, `references/safety_rules.md`, `scripts/check_gate_plan.py`, `scripts/analyze_caches.py`, `scripts/analyze_code_sign_clones.py`), so some safety rules and checker behavior remain unverified.

Before installing

Rated 2026-09-23 by an automated review of 124 files from the skill's repository.

Source

Repository
daymade/claude-code-skills (all skills from this repository)
Path
daymade-macos/macos-cleaner/SKILL.md
Branch
main
Updated
2026-09-20