Adonis0123/adonis-skills / skills/disk-tidy
disk-tidy
VerifiedFree disk space on a developer's Mac (Linux partly) when the disk is nearly full: measure where the space went across build output, package-manager caches, app data, AI agent data, old tool versions and worktrees, fan the read-only survey out to subagents, merge it into a tiered cleanup list, clean only what the user approves, and report the real gain from free space before and after. Use whenever the user says the disk or SSD is (almost) full, asks what is eating space, what can be cleaned or deleted to free space, or why free space keeps shrinking, in any language, Chinese included. Hands organizing personal files to file-tidy and removing git worktrees to worktree-tidy. Not for organizing files without a space problem, a single known cache command, system files that need sudo, iCloud or other cloud storage plans, or disks of remote servers, containers and Kubernetes nodes.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 9.9 KB |
| assets/locations.json | config | 6.3 KB |
| evals/evals.json | config | 4.2 KB |
| references/hotspots.md | markdown | 5.8 KB |
| scripts/disk_tidy.py | script | 14.2 KB |
| scripts/test_disk_tidy.py | script | 9.8 KB |
assets/locations.json
View on GitHub[
{
"what": "uv package cache",
"tier": "A",
"clean": "uv cache prune (or uv cache clean)",
"paths": ["~/.cache/uv", "~/Library/Caches/uv"]
},
{
"what": "npm cache and npx packages",
"tier": "A",
"clean": "npm cache clean --force; remove ~/.npm/_npx",
"paths": ["~/.npm"]
},
{
"what": "pnpm content store",
"tier": "A",
"clean": "pnpm store prune (old store versions such as v3 can go whole)",
"paths": [
"~/Library/pnpm/store/*",
"~/.local/share/pnpm/store/*",
"~/.pnpm-store"
]
},
{
"what": "pnpm metadata and dlx cache",
"tier": "A",
"clean": "remove the folder",
"paths": ["~/Library/Caches/pnpm", "~/.cache/pnpm"]
},
{
"what": "Yarn cache",
"tier": "A",
"clean": "yarn cache clean",
"paths": ["~/Library/Caches/Yarn", "~/.cache/yarn", "~/.yarn/berry/cache"]
},
{
"what": "Bun install cache",
"tier": "A",
"clean": "bun pm cache rm",
"paths": ["~/.bun/install/cache"]
},
{
"what": "pip cache",
"tier": "A",
"clean": "pip cache purge",
"paths": ["~/Library/Caches/pip", "~/.cache/pip"]
},
{
"what": "Go module and build cache",
"tier": "A",
"clean": "go clean -modcache -cache",
"paths": ["~/go/pkg/mod", "~/Library/Caches/go-build", "~/.cache/go-build"]
},
{
"what": "Cargo registry cache",
"tier": "A",
"clean": "cargo cache --autoclean, or remove registry/cache",
"paths": ["~/.cargo/registry"]
},
{
"what": "Gradle and Maven caches",
"tier": "A",
"clean": "remove caches/ (Gradle) or the stale artifacts (Maven)",
"paths": ["~/.gradle/caches", "~/.m2/repository"]
},
{
"what": "Homebrew download cache",
"tier": "A",
"clean": "brew cleanup --prune=all",
"paths": ["~/Library/Caches/Homebrew"]
},
{
"what": "Playwright and Puppeteer browsers (old revisions)",
"tier": "A",
"clean": "keep the revision the projects pin; remove older ones",
"paths": [
"~/Library/Caches/ms-playwright",
"~/.cache/ms-playwright",
"~/.cache/puppeteer"
]
},
{
"what": "Xcode DerivedData, archives, device support, simulators",
"tier": "A",
"clean": "remove DerivedData; xcrun simctl delete unavailable; remove old iOS DeviceSupport",
"paths": [
"~/Library/Developer/Xcode/DerivedData",
"~/Library/Developer/Xcode/iOS DeviceSupport",
"~/Library/Developer/Xcode/Archives",
"~/Library/Developer/CoreSimulator"
]
},
{
"what": "Docker Desktop virtual disk",
"tier": "B",
"clean": "start Docker, docker system df, then docker system prune; or reset in Docker Desktop",
"paths": ["~/Library/Containers/com.docker.docker/Data/vms/*/data"]
},
{
"what": "OrbStack data",
"tier": "B",
"clean": "orb prune / OrbStack settings",
"paths": ["~/.orbstack", "~/Library/Group Containers/*.dev.orbstack"]
},
{
"what": "Codex plugin upgrade leftovers",
"tier": "A",
"clean": "keep the newest marketplace-upgrade-* per account, remove the rest while no upgrade runs",
"paths": ["~/.codex*/.tmp/marketplaces/.staging"]
},
{
"what": "Codex standalone releases",
"tier": "A",
"clean": "keep the release `current` points to and the previous one",
"paths": ["~/.codex/packages/standalone/releases"]
},
{
"what": "Claude Code CLI versions",
"tier": "A",
"clean": "keep the newest and any version a running session uses",
"paths": ["~/.local/share/claude/versions"]
},
{
"what": "Cursor agent CLI versions",
"tier": "A",
"clean": "keep the linked one and any a running process uses",
"paths": ["~/.local/share/cursor-agent/versions"]
},
{
"what": "Grok CLI downloads",
"tier": "A",
"clean": "keep the version ~/.grok/bin links to and any running one",
"paths": ["~/.grok*/downloads"]
},
{
"what": "AI agent session transcripts",
"tier": "B",
"clean": "remove sessions older than the owner wants to resume",
"paths": [
"~/.codex*/sessions",
"~/.claude*/projects",
"~/.grok*/sessions",
"~/.cursor/chats",
"~/Library/Application Support/orca/codex-runtime-home/home/sessions"
]
},
{
"what": "Claude desktop local VM image",
"tier": "B",
"clean": "turn off the local agent / Cowork feature if unused; it downloads again when needed",
"paths": ["~/Library/Application Support/Claude/vm_bundles"]
},
{
"what": "Chrome site storage and on-device model",
"tier": "B",
"clean": "chrome://settings/content/all sorted by size; on-device model via chrome://flags",
"paths": [
"~/Library/Application Support/Google/Chrome/*/Service Worker/CacheStorage",
"~/Library/Application Support/Google/Chrome/OptGuideOnDeviceModel"
]
},
{
"what": "Chrome code-sign clones left by updates",
"tier": "A",
"clean": "quit Chrome and restart the Mac; macOS removes them",
"paths": ["/private/var/folders/*/*/X/com.google.Chrome.code_sign_clone"]
},
{
"what": "WeChat chat media and files",
"tier": "B",
"clean": "WeChat > Settings > Storage > Manage",
"paths": ["~/Library/Containers/com.tencent.xinWeChat"]
},
{
"what": "WeCom (企业微信) data",
"tier": "B",
"clean": "WeCom > Settings > General > Storage, or uninstall",
"paths": ["~/Library/Containers/com.tencent.WeWorkMac"]
},
{
"what": "Feishu / Lark data and caches",
"tier": "B",
"clean": "Feishu > Settings > General > Storage > Clear cache",
"paths": [
"~/Library/Application Support/LarkShell",
"~/Library/Caches/LarkShell"
]
},
{
"what": "Alfred clipboard history",
"tier": "B",
"clean": "Alfred > Features > Clipboard History: shorten or clear",
"paths": ["~/Library/Application Support/Alfred/Databases"]
},
{
"what": "iOS device backups",
"tier": "B",
"clean": "Finder > device > Manage Backups",
"paths": ["~/Library/Application Support/MobileSync/Backup"]
},
{
"what": "App auto-updater downloads",
"tier": "A",
"clean": "remove the folder",
"paths": [
"~/Library/Caches/*updater*",
"~/Library/Caches/*.ShipIt",
"~/Library/Application Support/Caches/*updater*"
]
},
{
"what": "Trash",
"tier": "B",
"clean": "only the owner empties it",
"paths": ["~/.Trash"]
}
]
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deployment | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |