- Home
- Skills
- Workflow Automation
- smartclean
smartclean
Safety-first disk cleaner for Linux and macOS that reclaims space from caches and artifacts without touching active data.
$3
Works with the AI Agents you already use
smartclean
Example session with this skill installed
Scan my system for files I can safely delete to free up space. Run a standard scan.
- Read your context and instructions
- Compiled the smartclean
I have completed a safety-first scan of your system. I skipped active browser profiles, SSH keys, and projects modified within the last 7 days to ensure no data loss.
Disk Cleanup Scan Results
| Category | Reclaimable | Items Found | Safety Level |
|---|---|---|---|
| System | 1.2 GB | apt cache, journalctl logs | High (System Tools) |
| Dev | 850 MB | node_modules (inactive), .pyc files | High |
| Docker | 4.5 GB | Dangling images, unused layers | Medium (Requires Sudo) |
| Cache | 420 MB | Thumbnails, fontconfig, brew | High |
| Trash | 150 MB | User trash bin | High |
| Artifacts | 2.1 GB | Old build targets in ~/dev | Medium |
Summary: A total of
9.22 GB can be reclaimed. I have skipped
1.4 GB of data in ~/.ssh, ~/.gnupg, and active Chrome profiles for safety.
Next steps
- Run
smartclean apply --category system,cacheto clear high-safety items. - Run
smartclean apply --category dockerif you want to prune unused containers and images (may require sudo). - Request a deep scan with
smartclean scan --deepto search for large files and older artifacts.
Connects securely to your tools. The creator never sees your data.
About this skill
Disk space issues on Linux and macOS often lead to reckless deletions of configuration files or active project data. This skill provides a safety-first automation for reclaiming space without risking your sensitive credentials or active work.
What it does
- Smart Scanning identifies reclaimable space across trash, browser caches, dev artifacts, and system logs.
- Safety Filtering automatically excludes sensitive directories like
.ssh,.gnupg, and active browser profiles. - Recency Protection skips caches and projects modified within a configurable window to prevent disrupting active work.
- System Integration uses native tools like
apt-get clean,journalctl, anddockerrather than raw file deletion. - Dry-run Execution defaults to a scan-only mode to prevent accidental data loss before user approval.
How it works
- Run a scan using
smartclean scan --jsonto generate a list of candidates and skipped items. - Review the summarized report of reclaimable space categorized by type and size.
- Select specific categories or targets, such as build artifacts in a development directory.
- Execute the cleanup with
smartclean applyonly after explicit confirmation for each category.
Frameworks & tools
Built for Bash environments on macOS and Linux. It integrates with docker, podman, snap, flatpak, brew, and standard Linux package managers.
Why this beats prompting it yourself
Writing a cleanup script from scratch risks deleting critical session data or credentials hidden in caches. This skill uses a proven blocklist and logic to distinguish between disposable artifacts and active project files.
Use cases
- Reclaim disk space by purging old Docker images and system logs.
- Clean up multi-gigabyte build artifacts in deep development directory trees.
- Safely clear browser caches without losing saved logins or active sessions.
- Perform a deep sweep of installers and large files older than 14 days.
Known limitations
Does not support Windows. Does not perform application uninstallation. Large directory trees may be skipped unless the deep flag is used to avoid timeouts.
Does not support Windows. Does not uninstall applications. Scanning very large file systems may hit timeouts unless --deep is specified.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
Fresh listing
Recently published to Agensi
Money-back guarantee
Doesn't do what its page promises? You get your money back.
Trust & safety
Security scan
Security scan passed 11 days ago
Requires