macos-cleaner
Installation
SKILL.md
macOS Cleaner
Diagnose the actual source of disk pressure, reclaim only approved space, and prove that the cleanup did not damage user data or co-resident services.
Entry router
Choose the narrowest path that can answer the request:
| User signal | Route |
|---|---|
| Identical inactive local files must retain every path and offline availability | Read references/apfs-shared-blocks.md; use only authorized explicit pairs, native APFS checks and the bundled guarded executor |
Apple Content Caching, AssetCacheManagerUtil, CacheUsed, ActualCacheUsed, iCloud cache, or “Caching needs more space” |
Read references/apple_content_caching.md completely before probing or proposing commands |
| Docker, OrbStack, images, containers, or volumes | Read references/docker_analysis.md; inspect every object and never use prune-family commands |
| Docker build cache | Measure with docker builder du; this skill reports it but does not delete it because Docker exposes category-wide prune controls rather than per-record intent |
Cargo target trees or manual CI outputs |
Read references/cleanup_targets.md → Cargo and manual CI outputs before selecting files; requested test executables and unknown results can live inside dependency-named directories |
Chrome, ChromeDriver, Playwright, Codex Computer Use, Edge, or Chromium has large *.code_sign_clone directories |
Read references/chromium_code_sign_clones.md completely; use the bundled analyzer to separate active, inactive, and unknown exact children and never equate du with physical release |
| A named cache, directory, application, or service is already the suspect | Inspect that target first and read the matching semantics in references/cleanup_targets.md; do not start a home-directory or whole-disk scan |
The user asks what has been growing or filling the disk lately, free space fell between two readings, or an older scan export exists (GrandPerspective text export, saved du output) |
Read references/growth_attribution.md; answer with a delta table whose rows name their writer, not a size ranking |
| The source is genuinely unknown | Use the general analysis workflow below; Mole is optional, not the universal first step |