storage-analyzer

Scans macOS and Windows disk usage and generates an interactive HTML cleanup report.

2|Updated Jan 26, 2026
One-click install
npx skills add https://github.com/Nzettodess/Awesome-Agent-Skills --skill storage-analyzer-nzettodess
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: storage-analyzer
Source: https://github.com/Nzettodess/Awesome-Agent-Skills/tree/main/Skills/Misc/storage-analyzer
Command: npx skills add https://github.com/Nzettodess/Awesome-Agent-Skills --skill storage-analyzer-nzettodess

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve? When your disk is full, it is hard to know what is eating space and what is safe to delete. This Skill performs a read-only scan of your entire drive, identifies the largest space consumers, classifies each item into three cleanup tiers (auto-cleanable caches, items needing manual judgment, and items to avoid deleting), and produces an interactive HTML report with one-click cleanup actions. ## Core Features & Use Cases - Read-only disk scanning: A Python script auto-detects macOS or Windows and measures disk usage across home directories, caches, app containers, developer caches, and downloads, outputting structured JSON. - Three-tier cleanup classification: Items are sorted into green (safe caches like pip/npm/Xcode DerivedData), yellow (user data like offline videos or chat history requiring judgment), and red (apps best removed via proper uninstallers), each with size estimates and disposal guidance. - Interactive HTML report with guarded deletion: A local server renders a collapsible report with copyable commands and one-click "move to Trash" or "delete" buttons protected by path allowlists, a session token, and localhost-only binding. - Use Case: Your Mac reports "disk almost full". Run the scan, and the report reveals a 97 GB UUID container is actually Bilibili offline video cache, plus 27 GB of regenerable developer caches you can clear in one click. ## Quick Start Ask the assistant to run a storage analysis on this computer and generate a cleanup report showing what is taking up disk space.

Frequently Asked Questions about storage-analyzer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find what is taking up disk space on my Mac?▼

Run the scan.py script, which uses du to measure sizes across your home folder, Library caches, containers, and developer caches, then outputs JSON. The Skill classifies the largest items and generates an HTML report showing the top space consumers with cleanup recommendations.

How to safely clean disk space without deleting important files?▼

The Skill classifies items into three tiers: green for regenerable caches safe to delete, yellow for user data needing manual review, and red for items best removed via proper uninstallers. Deletion actions are restricted to allowlisted paths and default to moving files to Trash for reversibility.

Does this disk analyzer work on Windows?▼

Yes, scan.py detects Windows via sys.platform and scans AppData, Temp, Downloads, and Program Files using os.scandir, with multi-drive support. However, the Windows code path is untested on real hardware, so first runs should verify paths and Recycle Bin deletion behavior.

Why are there no delete buttons in my storage report?▼

Delete buttons only appear when the report is served through server.py, not the static build_report.py output. They also require each green item to include trash_paths in the analysis JSON; missing trash_paths means no button renders.

Is it safe to let a script delete files from my disk?▼

The server enforces three allowlists: rm only permits green-tier cache paths, trash allows green and verified yellow subpaths, and open is non-destructive. Every path is realpath-validated, must be under the home directory, requires a session token, and the browser confirms each action.