Individual skill
macos-cleaner
Diagnoses and safely reclaims macOS disk space: caches, logs, app remnants, large/duplicate files, Docker/OrbStack, Chromium code-sign clones, developer caches. Use when a Mac is low on storage, shows “Caching needs more space”, or before deleting anything to avoid data loss. Not for Windows/Linux or permission issues (use macos-permissions).
daymade-macos/macos-cleaner/SKILL.md
Source commit 7c4d326ddd94d504e00e241ba49498e95160afbe
What was checked
- Matches the observed repository HEAD
- Yes
- Scanner rules are current
- Yes
- Repository scan complete
- No
- Skill scan complete
- No
- Observed behavior
- Network or broad shell
- Last checked
- Nov 4, 2026
These are observations at the recorded commit, not a guarantee of safety. Review the source before running it.
Install this skill
Choose an agent in your Stack or copy a command below. Commands fetch the pinned commit and copy only this skill directory. Existing destinations are refused. Copying a command does not install anything.
An install command is unavailable: current rules, complete repository and skill scans, an eligible behavior level and a permitted license are required.
Repository context
- Repository stars (not skill ratings)
- 1,520
- Repository last updated
- Nov 6, 2026
- License
- MIT
Observed agent integration: No specific integration evidence. Standard SKILL.md installation does not imply verified compatibility.
- engineering Derived category
- data Derived category
- devops Derived category
- devops-containers Derived category
Files and excerpt
File metadata and permitted, redacted excerpts come from the recorded scan. Source links are pinned to that commit.
Browse files
SKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesSKILL.mdcore · 42,303 bytesreferences/apfs-shared-blocks.mddoc · 7,451 bytesreferences/apple_content_caching.mddoc · 11,962 bytesreferences/batch-selection.mddoc · 2,494 bytesreferences/chromium_code_sign_clones.mddoc · 15,713 bytesreferences/cleanup_targets.mddoc · 38,462 bytesreferences/docker_analysis.mddoc · 18,355 bytesreferences/growth_attribution.mddoc · 14,602 bytesreferences/mole_integration.mddoc · 18,626 bytesreferences/proving-redundancy-before-deletion.mddoc · 16,186 bytesreferences/report_templates.mddoc · 12,104 bytesreferences/safety_rules.mddoc · 19,448 bytesscripts/_apfs_core.pyruns · 20,124 bytesscripts/_apfs_native.pyruns · 3,574 bytesscripts/analyze_caches.pyruns · 21,287 bytesscripts/analyze_code_sign_clones.pyruns · 16,879 bytesscripts/analyze_dev_env.pyruns · 9,934 bytesscripts/analyze_large_files.pyruns · 8,599 bytesscripts/apfs_cow.pyruns · 14,350 bytesscripts/batch_budget.pyruns · 2,467 bytesscripts/check_gate_plan.pyruns · 86,829 bytesscripts/cleanup_report.pyruns · 8,655 bytesscripts/find_app_remnants.pyruns · 9,662 bytesscripts/safe_delete.pyruns · 10,846 bytesscripts/stream_accounting.pyruns · 2,897 bytestests/fixtures/corpus/known-bad-original.mddoc · 3,756 bytestests/fixtures/corpus/known-good-arm1.mddoc · 22,128 bytestests/fixtures/corpus/known-good-round2-plan.mddoc · 7,414 bytestests/fixtures/corpus/known-good-round2-table.mddoc · 5,151 bytestests/fixtures/corpus/known-good-zai.mddoc · 5,151 bytestests/fixtures/review-probes-r3/r3-01_gate.mddoc · 372 bytestests/fixtures/review-probes-r3/r3-01_plan.mddoc · 244 bytestests/fixtures/review-probes-r3/r3-02_gate.mddoc · 490 bytestests/fixtures/review-probes-r3/r3-02_plan.mddoc · 318 bytestests/fixtures/review-probes-r3/r3-03_gate.mddoc · 358 bytestests/fixtures/review-probes-r3/r3-03_plan.mddoc · 373 bytestests/fixtures/review-probes-r3/r3-04_gate.mddoc · 346 bytestests/fixtures/review-probes-r3/r3-04_plan.mddoc · 203 bytestests/fixtures/review-probes-r3/r3-04b_gate.mddoc · 346 bytestests/fixtures/review-probes-r3/r3-04b_plan.mddoc · 238 bytestests/fixtures/review-probes-r3/r3-04c_plan.mddoc · 258 bytestests/fixtures/review-probes-r3/r3-04d_gate.mddoc · 373 bytestests/fixtures/review-probes-r3/r3-04d_plan.mddoc · 258 bytestests/fixtures/review-probes-r3/r3-05_gate.mddoc · 348 bytestests/fixtures/review-probes-r3/r3-05_plan.mddoc · 212 bytestests/fixtures/review-probes-r3/r3-05b_plan.mddoc · 347 bytestests/fixtures/review-probes-r3/r3-06_gate.mddoc · 372 bytestests/fixtures/review-probes-r3/r3-06_plan.mddoc · 339 bytestests/fixtures/review-probes-r3/r3-06b_gate.mddoc · 393 bytestests/fixtures/review-probes-r3/r3-06b_plan.mddoc · 376 bytestests/fixtures/review-probes-r3/r3-07_gate.mddoc · 686 bytestests/fixtures/review-probes-r3/r3-07_plan.mddoc · 206 bytestests/fixtures/review-probes-r3/r3-07b_plan.mddoc · 375 bytestests/fixtures/review-probes-r3/r3-07c_gate.mddoc · 635 bytestests/fixtures/review-probes-r3/r3-08_gate.mddoc · 519 bytestests/fixtures/review-probes-r3/r3-08_plan.mddoc · 188 bytestests/fixtures/review-probes-r3/r3-09_gate.mddoc · 539 bytestests/fixtures/review-probes-r3/r3-09_plan.mddoc · 65 bytestests/fixtures/review-probes-r3/r3-09b_gate.mddoc · 574 bytestests/fixtures/review-probes-r3/r3-09c_gate.mddoc · 644 bytestests/fixtures/review-probes-r3/r3-10_gate.mddoc · 401 bytestests/fixtures/review-probes-r3/r3-10_plan.mddoc · 209 bytestests/fixtures/review-probes-r3/r3-11_gate.mddoc · 531 bytestests/fixtures/review-probes-r3/r3-11_plan.mddoc · 263 bytestests/fixtures/review-probes-r3/r3-11b_gate.mddoc · 532 bytestests/fixtures/review-probes-r3/r3-11b_plan.mddoc · 267 bytestests/fixtures/review-probes-r3/r3-11c_gate.mddoc · 524 bytestests/fixtures/review-probes-r3/r3-12_plan.mddoc · 432 bytestests/fixtures/review-probes-r3/r3-13_gate.mddoc · 757 bytestests/fixtures/review-probes-r3/r3-13b_gate.mddoc · 762 bytestests/fixtures/review-probes-r3/r3-14_gate.mddoc · 556 bytestests/fixtures/review-probes-r3/r3-14_plan.mddoc · 338 bytestests/fixtures/review-probes-r3/r3-14b_gate.mddoc · 533 bytestests/fixtures/review-probes-r3/r3-15_plan.mddoc · 218 bytestests/fixtures/review-probes-r4/r4-01_plan.mddoc · 937 bytestests/fixtures/review-probes-r4/r4-01_table.mddoc · 1,387 bytestests/fixtures/review-probes-r4/r4-01ctl_table.mddoc · 1,278 bytestests/fixtures/review-probes-r4/r4-02_plan.mddoc · 985 bytestests/fixtures/review-probes-r4/r4-02_table.mddoc · 1,396 bytestests/fixtures/review-probes-r4/r4-02b_plan.mddoc · 985 bytestests/fixtures/review-probes-r4/r4-02b_table.mddoc · 1,396 bytestests/fixtures/review-probes-r4/r4-03_plan.mddoc · 788 bytestests/fixtures/review-probes-r4/r4-03_table.mddoc · 1,209 bytestests/fixtures/review-probes-r4/r4-04_plan.mddoc · 820 bytestests/fixtures/review-probes-r4/r4-04_table.mddoc · 1,625 bytestests/fixtures/review-probes-r4/r4-04ctl_table.mddoc · 1,653 bytestests/fixtures/review-probes-r4/r4-05_plan.mddoc · 513 bytestests/fixtures/review-probes-r4/r4-05_table.mddoc · 1,621 bytestests/fixtures/review-probes-r4/r4-05ctl_table.mddoc · 1,621 bytestests/fixtures/review-probes-r4/r4-07_plan.mddoc · 796 bytestests/fixtures/review-probes-r4/r4-07_table.mddoc · 1,551 bytestests/fixtures/review-probes-r4/r4-09_plan.mddoc · 769 bytestests/fixtures/review-probes-r4/r4-09_table.mddoc · 1,472 bytestests/fixtures/review-probes-r4/r4-10_plan.mddoc · 772 bytestests/fixtures/review-probes-r4/r4-10_table.mddoc · 1,378 bytestests/fixtures/review-probes-r4/r4-11_plan.mddoc · 326 bytestests/fixtures/review-probes-r4/r4-11_table.mddoc · 1,198 bytestests/fixtures/review-probes-r4/r4-11b_plan.mddoc · 451 bytestests/fixtures/review-probes-r4/r4-11b_table.mddoc · 453 bytestests/fixtures/review-probes-r4/r4-12_plan.mddoc · 677 bytestests/fixtures/review-probes-r4/r4-12_table.mddoc · 1,219 bytestests/fixtures/review-probes-r4/r4-13_plan.mddoc · 511 bytestests/fixtures/review-probes-r4/r4-13_table.mddoc · 1,222 bytestests/fixtures/review-probes-r4/r4-13ctl_table.mddoc · 511 bytestests/fixtures/review-probes-r4/r4-14_plan.mddoc · 522 bytestests/fixtures/review-probes-r4/r4-14_table.mddoc · 1,086 bytestests/fixtures/review-probes-r4/r4-15_plan.mddoc · 634 bytestests/fixtures/review-probes-r4/r4-15_table.mddoc · 1,131 bytestests/fixtures/review-probes-r4/r4-16_plan.mddoc · 937 bytestests/fixtures/review-probes-r4/r4-16_table.mddoc · 1,244 bytestests/fixtures/review-probes-r4/r4-17_plan.mddoc · 652 bytestests/fixtures/review-probes-r4/r4-18_plan.mddoc · 916 bytestests/fixtures/review-probes-r4/r4-18_table.mddoc · 1,392 bytestests/fixtures/review-probes/p10_gate.mddoc · 680 bytestests/fixtures/review-probes/p10_plan.mddoc · 225 bytestests/fixtures/review-probes/p11_gate.mddoc · 649 bytestests/fixtures/review-probes/p11_plan.mddoc · 219 bytestests/fixtures/review-probes/p12_gate.mddoc · 663 bytestests/fixtures/review-probes/p1_gate.mddoc · 352 bytestests/fixtures/review-probes/p1_plan.mddoc · 136 bytestests/fixtures/review-probes/p2_gate.mddoc · 550 bytestests/fixtures/review-probes/p2_plan.mddoc · 325 bytestests/fixtures/review-probes/p3_gate.mddoc · 379 bytestests/fixtures/review-probes/p3_plan.mddoc · 37 bytestests/fixtures/review-probes/p3b_gate.mddoc · 351 bytestests/fixtures/review-probes/p4_gate.mddoc · 334 bytestests/fixtures/review-probes/p4_plan.mddoc · 267 bytestests/fixtures/review-probes/p4b_gate.mddoc · 334 bytestests/fixtures/review-probes/p4b_plan.mddoc · 385 bytestests/fixtures/review-probes/p5_gate.mddoc · 349 bytestests/fixtures/review-probes/p5_plan.mddoc · 154 bytestests/fixtures/review-probes/p6_plan.mddoc · 89 bytestests/fixtures/review-probes/p7_gate.mddoc · 444 bytestests/fixtures/review-probes/p7_plan.mddoc · 301 bytestests/fixtures/review-probes/p8_gate.mddoc · 302 bytestests/fixtures/review-probes/p8_plan.mddoc · 132 bytestests/fixtures/review-probes/p9_gate.mddoc · 447 bytestests/fixtures/review-probes/p9_plan.mddoc · 278 bytestests/test_analyze_caches.pyruns · 13,119 bytestests/test_analyze_code_sign_clones.pyruns · 10,938 bytestests/test_analyze_large_files.pyruns · 8,481 bytestests/test_cleanup_report.pyruns · 5,233 bytestests/test_cow_workflows.pyruns · 14,891 bytestests/test_gate_checker.pyruns · 81,946 bytestests/test_safe_delete.pyruns · 4,269 bytes
Read excerpt
# 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 |