Disk Hygiene

A solid macOS housekeeping tool that audits disk usage, cleans developer caches, and hunts down forgotten large files. It knows where uv, Homebrew, npm, cargo, Docker, and other dev tools stash their caches, runs safe cleanup commands that won't break anything, and finds files you haven't touched in six months. The Downloads triage feature is handy when that folder becomes a dumping ground. It's self-evolving, meaning it updates its own instructions when it hits edge cases. Use it when you're low on space or just want to see where the gigabytes went without installing another disk analyzer.

skills.sh installs: 272
GitHub stars: 2
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add terrylica/cc-skills --skill disk-hygiene --agent claude-code

Installs into .claude/skills of the current project.

Files

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

SKILL.md on GitHub