← Back to Skills Marketplace
Auto Cleaning Disk
by
ahqazi-dev
· GitHub ↗
· v1.0.0
· MIT-0
282
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install auto-cleaning-disk
Description
Automatically clean disk space by removing temp files, browser cache, recycle bin/trash, and log files — safely, without deleting any important files. Use th...
README (SKILL.md)
Auto Cleaning Disk
Safely clean disk space on any operating system (Windows, Linux, macOS). Never deletes important files — only junk, cache, temp, and log files.
What This Skill Cleans
| Category | Examples |
|---|---|
| Temp Files | %TEMP%, /tmp, system temp folders |
| Browser Cache | Chrome, Firefox, Edge, Safari cache |
| Recycle Bin / Trash | Windows Recycle Bin, macOS Trash, Linux Trash |
| Log Files | Old .log files in system/app folders |
⚠️ NEVER delete: Documents, Downloads, Desktop files, user data, system files, installed apps, or anything outside designated junk folders.
Mode Selection
Always ask the user FIRST (if not already specified):
- Auto Mode — Clean everything silently, show summary at end
- Confirm Mode — Ask user before each category is cleaned
Step-by-Step Instructions
Step 1: Detect Operating System
Detect the OS using Python:
import platform
os_type = platform.system() # "Windows", "Linux", "Darwin" (Mac)
Step 2: Run the Appropriate Script
Based on OS, refer to the matching reference file:
- Windows → See
windows-cleaner.md - Linux → See
linux-cleaner.md - macOS → See
mac-cleaner.md
Step 3: Show Results
After cleaning, always show:
- ✅ How much space was freed (MB/GB)
- 📁 Which categories were cleaned
- ⚠️ Anything skipped and why
Safety Rules (MUST FOLLOW)
- ❌ Never touch System32 or Windows folder
- ❌ Never touch Documents, Pictures, Videos, Downloads
- ❌ Never touch installed software folders
- ✅ Only clean folders explicitly listed in scripts
- ✅ Only delete files older than 1 day
- ✅ If unsure about a file — SKIP it
Usage Examples
User says: "My disk is full" → Ask mode preference → Run full clean → Show space freed
User says: "Clear browser cache only" → Only clean browser cache → Show result
User says: "Auto clean everything" → Run all categories silently → Show summary
Usage Guidance
This skill generally does what it says, but there are meaningful safety gaps in the implementation you should consider before running it:
- Do not run it as administrator/root until you review/modify the code. Deleting /var/log, C:\Windows\Logs or similar may require elevation and can remove important logs.
- The SKILL.md states it will only delete files older than 1 day, but the scripts do not check file modification times — they delete everything inside the listed folders. That mismatch could remove recently created cache or temporary files the user still needs.
- Symlink risk: the code can follow directory symlinks (Path.is_dir() follows symlinks) and then shutil.rmtree will remove the linked target. A symlink inside a 'safe' folder could cause deletion outside the intended area. Consider patching the code to skip symlinks entirely or to never follow directory symlinks.
- Confirm Mode is safer — use it and review the per-folder prompts before consenting.
- Recommended improvements before use: implement and enforce age checks (os.path.getmtime), explicitly skip symlinks for directories (item.is_symlink()), add a dry-run mode that lists what would be deleted, and add explicit whitelist/blacklist checks (do not call shutil.rmtree on paths outside a vetted list).
If you are not comfortable reviewing/modifying the Python, prefer not to install or run this skill, or run it in a disposable/test environment and back up any important data first.
Capability Analysis
Type: OpenClaw Skill
Name: auto-cleaning-disk
Version: 1.0.0
The skill performs mass file deletion across Windows, Linux, and macOS to free disk space. A significant safety concern exists because the SKILL.md instructions claim the tool only deletes files older than one day, yet the actual Python implementation (clean_linux.py, clean_mac.py, clean_windows.py) lacks any age-verification logic and deletes all files in the target directories. While no evidence of data exfiltration or malicious intent was found, the aggressive deletion of broad directories like ~/.cache and system logs without the promised safety checks makes the skill high-risk for unintended data loss.
Capability Assessment
Purpose & Capability
Name/description match the code: OS detection and per-OS cleaning scripts are present and limited to temp, caches, trash, and logs. No unrelated credentials, binaries, or external endpoints are requested. This is coherent with the stated purpose.
Instruction Scope
SKILL.md promises 'Only delete files older than 1 day' and 'Never delete Documents/Downloads/System folders', but the scripts do not enforce an age check — they delete all items inside target folders. The scripts also iteratively remove directories with shutil.rmtree and evaluate is_dir() which follows symlinks; that can cause deletion of targets outside intended folders if symlinks exist. Scripts operate on system log locations (/var/log, C:\Windows\Logs) which can require elevated privileges and could remove files important for diagnostics. There are no network calls, and scripts only read standard env vars for paths.
Install Mechanism
No install spec (instruction-only plus bundled scripts) — nothing is downloaded or installed automatically. Risk from install mechanism is low.
Credentials
Skill does not request secrets or unusual environment access. Scripts use common environment variables (TEMP, TMP, USERPROFILE) and Path.home(), which is expected for path discovery.
Persistence & Privilege
always is false and the skill does not request permanent presence or modify other skills or system-wide agent settings. It runs locally and interactively (prompts for confirmation when requested).
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install auto-cleaning-disk - After installation, invoke the skill by name or use
/auto-cleaning-disk - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Version 1.0.0 — Initial Release
- Added temp files cleaning (Windows, Linux, Mac)
- Added browser cache cleaning (Chrome, Firefox, Edge, Safari)
- Added Recycle Bin and Trash emptying
- Added log files cleaning
- Added Auto Mode — cleans everything automatically
- Added Confirm Mode — asks before each step
- Added automatic OS detection (Windows, Linux, macOS)
- Safe cleaning — never deletes important user files
Metadata
Frequently Asked Questions
What is Auto Cleaning Disk?
Automatically clean disk space by removing temp files, browser cache, recycle bin/trash, and log files — safely, without deleting any important files. Use th... It is an AI Agent Skill for Claude Code / OpenClaw, with 282 downloads so far.
How do I install Auto Cleaning Disk?
Run "/install auto-cleaning-disk" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Auto Cleaning Disk free?
Yes, Auto Cleaning Disk is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Auto Cleaning Disk support?
Auto Cleaning Disk is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Auto Cleaning Disk?
It is built and maintained by ahqazi-dev (@ahqazi-dev); the current version is v1.0.0.
More Skills