skill
disk-cleanup
Agent Skill — cross-platform disk cleanup & space analysis: Windows scan+confirm-delete, macOS read-only scan (never auto-deletes).
Set up
Skills are installed by placing their folder where your agent loads skills.
The download comes from github.com/freanocank/disk-cleanup itself, not from our server, so what you get is exactly what its author published.
Install instructions come from the README
README
synced Oct 23, 2026Disk Cleanup Master
English | 中文
Agent Skill — Safety-first Windows disk cleanup and space-analysis toolkit with aggressive scanning, conservative deletion, cache diagnostics, and confirmation-first cleanup guardrails.
Safety-first disk cleanup toolkit implementing an aggressive-scan, conservative-delete workflow. Cross-platform: full scan-and-confirm-delete on Windows; read-only scan on macOS — it never auto-deletes, even when explicitly authorized (the user runs the suggested commands themselves).
Philosophy
macOS: strictly read-only. This skill reports findings and suggested commands but never runs any
rm/ trash / move operation, even if the user says "go". Deletion is entirely manual.
| Level | Action | Examples |
|---|---|---|
| 🟢 Green | Safe to delete | Temp files, browser cache, pip cache, __pycache__, WinSxS old components |
| 🟡 Yellow | Confirm with user | Game saves, WeChat/QQ logs, WPS cloud files, downloads |
| 🔴 Red | Never touch | Windows system directories, Program Files, active projects |
Scripts
| Script | Purpose |
|---|---|
tree_size_scanner.py | Layered tree scanning of large folders (cross-platform) |
scan_programdata.py | Audit C:\ProgramData by safety level (Windows) |
cleanup_temp.ps1 | Safe temp file cleanup (Windows) |
scan_large_folders.py | Identify space hogs (cross-platform) |
find_zombie_packages.py | Detect orphaned pip packages (cross-platform) |
robocopy_wipe.py | Wipe locked folders when takeown fails (Windows) |
find_folders_by_keyword.py | Locate folders by name pattern (cross-platform) |
disk_overview.py | Per-volume free space overview (macOS, read-only) |
scan_library.py | Audit ~/Library by safety level (macOS, read-only) |
Usage
Run individual scripts as needed:
# Scan ProgramData
python scripts/scan_programdata.py
# Clean temp files
powershell -ExecutionPolicy Bypass -File scripts/cleanup_temp.ps1
References
references/chinese-app-special-cases.md— Documented quirks for WeChat, QQ, WPS, NetEase, BaiduNetdisk