snqb/mac-cleanup
mac-cleanup/SKILL.md
Free disk space on macOS using mac-cleanup-go (safe, preview-first, sends to Trash) and docker-cleanup. Run when user asks to clean up, free space, or reclaim disk.
$ install --global
skillsauthnpx skillsauth add snqb/my-skills mac-cleanupInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 14, 2026, 3:05 AM41.6s2 files scanned
SKILL.md
- name:
- mac-cleanup
- description:
- Free disk space on macOS using mac-cleanup-go (safe, preview-first, sends to Trash) and docker-cleanup. Run when user asks to clean up, free space, or reclaim disk.
Mac Cleanup
Tools
mac-cleanup— TUI/CLI macOS cleaner (brew install mac-cleanup-go). Preview-first, impact-labeled, sends to Trash.docker-cleanup— Custom Docker space reclaimer at~/.local/bin/docker-cleanup
Quick Commands
# Preview what would be cleaned
mac-cleanup -clean -dry-run
# Run cleanup with configured targets
mac-cleanup -clean
# Change targets interactively (TUI, needs terminal)
mac-cleanup --select
Config
File: ~/.config/mac-cleanup-go/config.yaml
selected_targets:
# list of category IDs to clean
Edit directly or use mac-cleanup --select TUI.
Current Selection Philosophy
Included (safe, auto-regenerated):
- System: trash, system-logs, quicklook, user-diagnostic, incomplete-downloads
- Dev caches: xcode-derived, go-build, go-tools, pip, python-extended (uv/ruff/mypy/pytest), npm, homebrew, docker, deno, frontend-tools, cocoapods, rustup, cloud-cli
- App caches: claude-desktop, discord, notion, obsidian, jetbrains, vscode, cursor, electron-updaters, spotify
Excluded deliberately:
- ❌ All browsers (Vivaldi, Chrome, Safari, etc.) — user preference
- ❌ pnpm store — 11GB but shared across all projects, slow to rebuild
- ❌ bun/yarn cache — not worth the re-download time
- ❌ go module cache, cargo, gradle, maven — moderate impact, slow rebuilds
- ❌ Risky storage: iOS backups, old downloads, mail attachments
- ❌ Telegram, Slack, Teams — contain user data
Available Target IDs (107 total)
Run mac-cleanup --select to see all with sizes. Key groups:
- system: trash, system-cache, system-logs, quicklook, saved-state, incomplete-downloads, user-diagnostic
- browser: browser-chrome, browser-safari, browser-firefox, browser-arc, browser-vivaldi, browser-brave, browser-edge, browser-opera, browser-chromium, browser-zen
- dev: xcode-derived, npm, pnpm, yarn, bun, pip, python-extended, poetry, go, go-build, go-tools, cargo, gem, gradle, maven, homebrew, docker, flutter, deno, rustup, frontend-tools, cloud-cli, etc.
- app: discord, slack, spotify, vscode, cursor, jetbrains, notion, obsidian, claude-desktop, telegram (manual), etc.
- storage: ios-backups, old-downloads, mail-attachments (all risky)
Agent Workflow
- Always dry-run first:
mac-cleanup -clean -dry-run - Show user the report with sizes
- Run:
mac-cleanup -clean - Verify:
df -h /before/after
Docker Cleanup (separate)
docker-cleanup # prunes containers >24h, dangling images, build cache
Note: mac-cleanup already includes Docker as a builtin target, so docker-cleanup is redundant if Docker is in selected_targets. Use docker-cleanup only for the MCP container health check.
Related Skills
snqb/wiki-enrich
documentation
VerifiedTrustedCommunity
Enrich Markdown articles with inline Wikipedia links. First mention of each notable entity gets a hyperlink. Use when asked to add wiki links, enrich, or add references to .md files.
1SKILL.mdUpdated Apr 14, 2026
snqb/visual-qa-loop
development
VerifiedTrustedCommunity
Structured visual QA: screenshot → batch issues → fix all → verify. Replaces the 300-cycle screenshot→edit death spiral. Optional bishkek review as exit gate. Use when building/polishing UI with browser testing, or when user asks for N iterations/reviews.
1SKILL.mdUpdated Apr 14, 2026
snqb/uncomplex-analyzer
development
VerifiedTrustedCommunity
Find complex code, analyze intent, recommend battle-tested library replacements. Uses radon/eslint for detection, GitHub quality search for alternatives.
1SKILL.mdUpdated Apr 14, 2026
snqb/ui-patterns
research
VerifiedTrustedCommunity
Research real-world UI patterns from curated galleries (Collect UI, Component Gallery, Mobbin). Use when exploring what exists: dropdowns, accordions, inputs, navigation, cards, modals, etc.
1SKILL.mdUpdated Apr 14, 2026