disk-janitorlisted

Detect reclaimable disk space on macOS and optionally clean it up via a tiered Python script. Use this skill whenever the user says "my Mac is full", "free up disk space", "what's eating my disk", "clear caches", "clean up stale data", "how much space can I recover", "disk cleanup", or any variation of wanting to understand or reclaim storage. Always run the dry-run report first so the user sees what will be touched before anything is deleted. Triggers even when the user just wants to understand disk usage without committing to cleanup.
cmin764/configs · ★ 1 · Data & Documents · score 64

Install: claude install-skill cmin764/configs

# Disk Janitor Detect and reclaim wasted space on macOS via `scripts/cleanup.py`. The script is stdlib-only (no deps), dry-run by default, and delegates to each tool's own CLI for package-manager caches rather than deleting files directly. --- ## Workflow 1. Run the dry-run report first (always): ```bash python3 .claude/skills/disk-janitor/scripts/cleanup.py --level 2 ``` 2. Show the output to the user. Let them choose a level and confirm targets. 3. Run with `--apply` at the agreed level: ```bash python3 .claude/skills/disk-janitor/scripts/cleanup.py --level 2 --apply ``` 4. Report the before/after free-space delta from the script output. If the user only wants to understand space usage (no cleanup), `--level 3` dry-run gives the fullest picture without touching anything. --- ## Levels | Level | What it covers | Risk | |-------|---------------|------| | 1 (default) | Package-manager caches via official CLIs: brew, uv, pip, npm, bun; claude-tmp | Low | | 2 | + Trash, Chrome/JetBrains/IDE caches (incl. Chrome's Application Support cache subdirs), ~/Library/Logs, Claude shell/paste cache, Claude chats older than N days, docker image and builder prune (dangling images and build cache only, stopped containers and tagged images untouched), Teams/Claude-desktop/Discord cache subdirs (login preserved, skipped entirely while the app is running), Claude memory audit (report-only) | Low-med | | 3 | + Stale node_modules and venvs (projects untouched > N days),