Storage Analyzer - Read-Only Storage Analysis and Disk Cleanup Assistant

Skill Overview

Storage Analyzer is an AI-powered storage analysis assistant that performs a fully read-only disk scan on macOS and Windows computers to identify the biggest space consumers. It provides recommended actions in three categories—🟢 Safe to Clean Automatically / 🟡 Requires Manual Review / 🔴 Clean with Caution—and generates an interactive, collapsible HTML report with one-click command copying. It can also launch a local service that enables one-click deletion from a web page, either by moving items to the Trash or deleting them directly.

Use Cases

1. Your computer says the disk is full or running out of space: Not sure what is taking up so much room? Scan the entire disk, generate a Top 5 space-usage ranking, and tell you in one sentence what is using the most space and approximately how much can be freed.
2. Your development machine is full of caches: Regenerable development caches such as Xcode DerivedData, pip / uv / npm caches, and node_modules are identified as 🟢 Safe to Clean Automatically, with specific cleanup commands provided and one-click execution available in the web interface.
3. You want to clean up safely but are afraid of deleting the wrong files: Items containing user data, such as offline video caches, old backups, and chat histories, are marked 🟡 Requires Manual Review. The report includes a content profile and handling options, while the web interface provides “Open in Finder” and “Move to Trash (Reversible)” buttons so you can review them before taking action.

Core Features

1. Fully read-only scanning with automatic system detection: On macOS, it uses du and diskutil to scan directories such as the home folder, Caches, Containers, and development caches. On Windows, it scans locations such as AppData, Temp, and Program Files, with support for multiple drive letters. It only runs commands that read and calculate statistics, without performing any write operations; the scan does not modify any files. If you colloquially say “memory is full” in Chinese, it correctly interprets this as insufficient storage space and will proactively explain that RAM usage is outside the scope of this skill when you want to check memory usage.
2. Three-tier cleanup decision checklist: It does not merely report “what is large”; it answers “should I do anything about it?” 🟢 Pure caches come with one-click cleanup commands; 🟡 Items containing user data include a content profile, at least three handling options, and risk warnings; 🔴 Large applications you want to uninstall and duplicate installations come with specific, proper uninstall procedures. Mysterious large directories named with UUIDs are investigated to determine their ownership—for example, identifying dozens of gigabytes of offline video cache hidden inside a Container.
3. Interactive HTML report + one-click deletion from the web interface: The report is organized as “Current State → Diagnosis → Prescriptions → Actions → Prevention,” and includes a disk overview, a three-color capacity bar, a Top 5 ranking, and collapsible cards. When opened through the local service, 🟢 items can be directly “Moved to Trash” or “Deleted Immediately,” while 🟡 items can be opened in Finder for inspection or moved to the Trash. All deletion requests undergo whitelist, realpath, and token validation, and every click requires browser confirmation. The entire system has zero third-party dependencies and runs using only the Python 3 standard library.

Frequently Asked Questions

Will the scan modify my files?

No. During the scanning phase, it only runs read-only commands such as df, du, diskutil, and stat. The cleanup commands shown in the report are for display only and are not executed automatically; you must confirm before running them. Even if you say “help me delete it,” the tool will pause and ask for confirmation first.

Is one-click deletion safe? Can I recover something if I delete it by mistake?

The safety model uses multiple levels: 🟢 cache items can be moved to the Trash or deleted directly; 🟡 items containing user data can only be moved to the Trash, which is reversible and will not free up space until the Trash is emptied; 🔴 application uninstallations are not handled by background deletion—the tool only provides a button to locate the application so you can follow the proper uninstall process. Before deletion, paths are checked against an allowlist and validated with realpath, and every click requires confirmation in a browser dialog.

How is it different from CleanMyMac and DaisyDisk?

CleanMyMac is a general-purpose cleanup application, while DaisyDisk focuses on visualizing storage usage; both require installation. Storage Analyzer is an AI skill: a large language model reviews scan results item by item—for example, identifying that a UUID-named directory is actually an offline cache from a video app—and provides a decision checklist with risk levels and specific commands, without any third-party dependencies. macOS is currently fully tested in real-world use; Windows support has been implemented but has not yet undergone complete testing on a physical machine.