← ClaudeAtlas

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 | Low | | 2 | + Chrome/JetBrains/IDE caches, ~/Library/Logs, Claude shell/paste cache, Claude chats older than N days, docker prune -f (dangling images + build cache only, tagged images untouched) | Low-med | | 3 | + Stale node_modules (projects untouched > N days), Xcode artifacts, brew --prune=all, docker prune -a (ALL unused images, confirm required), Claude plugin caches: cached node_modules, marketplace `.git` dirs, large tracked binaries (PDFs/zips/media) in marketplace working trees | Med (rebuild cost) | | dangero