dancolta

Claude Cleanup Skill โ€” Development skill for Claude Code

Development community

๐Ÿงน /cleanup โ€” macOS deep clean skill for Claude Code.

How to install Claude Cleanup Skill

This entry records only its repository, not the path inside it, so there is no exact command to give. Open dancolta/claude-cleanup-skill and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Cleanup Skill does

๐Ÿงน /cleanup โ€” macOS deep clean skill for Claude Code. One command, gigabytes back, zero risk to your files.

Alternatives in Development

  • Root Cause Tracing โ€” Use when errors occur deep in execution and you need to trace back to find the original trigger 102.5k โ˜…
  • Clean Worktree (Interactive) โ€” Interactive cleanup of worktrees: lists merged/stale branches and asks confirmation before deleting 25.5k โ˜…
  • System Cache Cleanup โ€” Clean temporary files and caches to free disk space: $ARGUMENTS 23.4k โ˜…

README

`/cleanup` โ€” macOS Deep Clean for Claude Code

One command. Gigabytes back. Zero risk to your actual files.

Your Mac accumulates **gigabytes** of cache junk from browsers, editors, package managers, and apps you forgot you had. This Claude Code skill wipes it all in seconds โ€” safely.

What it cleans

Category What gets nuked
System ~/Library/Caches/*, ~/Library/Logs/*, system caches, .DS_Store files, DNS cache
Package managers npm, npx, pip, Homebrew (old versions + cache)
Editors VS Code, Cursor โ€” cached data, extensions cache, code cache
AI tools Claude Desktop โ€” VM bundles, GPU cache, service workers
Browsers Chrome โ€” service workers, GPU/shader cache (never touches bookmarks, history, or extensions)
Chat apps Slack, Discord, Zoom โ€” cache and auto-updater bloat
Media Spotify persistent cache
Containers Docker dangling images and build cache (only if daemon is idle)

After cleaning, it deep-scans for remaining space hogs over 500 MB and asks before touching them.

What it NEVER touches

  • Your files โ€” Documents, Desktop, Downloads, Work, Projects, Code
  • App configs โ€” settings, preferences, profiles, bookmarks
  • App state โ€” Local Storage, IndexedDB, databases
  • Credentials โ€” Keychain, SSH keys, GPG keys, tokens, .env files
  • Dev environments โ€” git repos, node_modules, nvm versions
  • Anything not on the explicit allow-list โ€” it doesn't improvise

Example output

๐Ÿ“Š Disk before: 42 GB available of 460 GB

๐Ÿงน Cleaning...

| Category           | Freed    |
|--------------------|----------|
| User Caches        | 3.2 GB   |
| User Logs          | 180 MB   |
| npm / npx          | 420 MB   |
| Homebrew           | 890 MB   |
| pip                | 65 MB    |
| VS Code            | 310 MB   |
| Cursor             | 275 MB   |
| Claude Desktop     | 140 MB   |
| Chrome             | 520 MB   |
| Spotify            | 1.1 GB   |