disk-hygiene

# Disk Hygiene > Audit disk usage, clean developer caches, find forgotten large files, and triage Downloads on macOS. > **Self-Evolving Skill**: This skill improves through use. If instructions are wrong, parameters drifted, or a workaround was needed — fix this file immediately, don't defer. Only update for real, reproducible issues. ## When to Use This Skill Use this skill when: - User asks about disk space, storage, or cleanup - System is running low on free space - User wants to find old/forgotten large files - User wants to clean developer caches (brew, uv, pip, npm, cargo) - User wants to triage their Downloads folder - User asks about disk analysis tools (dust, dua, gdu, ncdu) ## TodoWrite Task Templates ### Template A - Full Disk Audit ``` 1. Run disk overview (df -h /System/Volumes/Data && major directories) 2. Audit developer caches (uv, brew, pip, npm, cargo, rustup, Docker) 3. Scan in-repo build artifacts (Rust target/, .venv, node_modules — often the biggest, see Phase 2.5) 4. Scan for forgotten large files (>50MB, not accessed in 180+ days) 5. Present findings with AskUserQuestion for cleanup choices 6. Execute selected cleanups 7. Report space reclaimed ``` ### Template B - Cache Cleanup Only ``` 1. Measure current cache sizes 2. Run safe cache cleanups (brew, uv, pip, npm) 3. Report space reclaimed ``` ### Template C - Downloads Triage ``` 1. List Downloads contents with dates and sizes 2. Categorize into groups (media, dev artifacts, personal docs...