disk-cleaner
🥈SilverA powerful Claude Code skill that provides safe disk space analysis, junk file cleaning, and real-time monitoring across Windows, Linux, and macOS.
1600Updated 2mo ago
Intermediate30min to implementautomation
Saves ~60 min per use
Quick InstallView Source
git clone https://github.com/gccszs/disk-cleaner.gitWorks with:
Claude
Overview
About This Skill
Disk Cleaner is a comprehensive Python toolkit for managing disk space across Windows, Linux, and macOS. It analyzes disk usage with 3D file classification (by type, risk level, and age), detects duplicate files, and safely removes temporary files and caches specific to each platform. The tool features progressive scanning for large disks, incremental caching for faster repeat scans, and file lock detection to prevent deletion of in-use files. Users benefit from smart cleanup recommendations, real-time disk monitoring with configurable alerts, and automated scheduling for recurring cleanup tasks—all without external dependencies.
How to Use
Install via CLI with `npx add-skill gccszs/disk-cleaner` or clone the repository. Run `analyze_disk.py` for space analysis, `clean_disk.py --dry-run` to preview cleanup, or `monitor_disk.py --watch` for continuous monitoring. Python 3.7+ is required; no external dependencies needed.
Use Cases
Reclaim disk space by identifying and removing duplicate files and large unnecessary directories
Safely clean platform-specific caches (Windows Update, APT, Homebrew, Xcode derived data)
Monitor disk usage in real-time with configurable thresholds and automated alerts
Schedule recurring cleanup tasks across development, server, or personal machines
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/gccszs/disk-cleanerRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Analyze my disk space usage and identify junk files that can be safely deleted. Provide a breakdown of file types and sizes. Then, create a script to clean these files on [OPERATING_SYSTEM]. Also, set up a real-time monitoring system to track disk usage and alert me when it exceeds [THRESHOLD]%.
Example Output
## Disk Space Analysis Report ### Current Disk Usage - Total Disk Space: 1.0 TB - Used Space: 750 GB (75%) - Free Space: 250 GB (25%) ### Junk Files Found - **Temporary Files**: 12.5 GB - **Cache Files**: 8.7 GB - **Log Files**: 5.3 GB - **Old Downloads**: 11.2 GB - **Duplicate Files**: 7.1 GB ### Recommended Cleanup - **Total Safe to Delete**: 44.8 GB - **Potential Space Saved**: 4.5% ## Cleanup Script ```bash # Windows Cleanup Script # Delete temporary files Del /Q /F %TEMP%\* # Clear cache Del /Q /F C:\Users\[USERNAME]\AppData\Local\* # Remove old downloads Del /Q /F C:\Users\[USERNAME]\Downloads\*.tmp ``` ## Real-Time Monitoring Setup - **Threshold**: 85% - **Alert Method**: Desktop Notification - **Monitoring Frequency**: Every 6 hours ### Next Steps 1. Review the junk files list and confirm deletion. 2. Run the cleanup script as administrator. 3. Set up the real-time monitoring system.
Apply to these tools
Browse all toolsClaude
AI assistant built for thoughtful, nuanced conversation
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Drata
Automate security compliance and monitor real-time security posture seamlessly.
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan