skills.rest
sliec
sliecCOMMUNITY
Explore all skills by this author →
GitHub

storage-analyzer

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

Updated Jun 22, 2026
Search Tags:#macos#windows#disk cleanup#disk usage#html report#cache cleaning#storage analysis
One-click install
npx skills add https://github.com/sliec/shared-files --skill storage-analyzer-sliec
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: storage-analyzer
Source: https://github.com/sliec/shared-files/tree/main/skills/storage-analyzer
Command: npx skills add https://github.com/sliec/shared-files --skill storage-analyzer-sliec

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 tell what is safe to delete and what is not. This Skill performs a read-only scan of your entire disk, identifies the biggest space consumers, classifies each item into three cleanup tiers, and produces an interactive HTML report with one-click cleanup actions. ## Core Features & Use Cases - Read-only disk scanning: Python scripts scan home directories, caches, app data, downloads, and developer caches on macOS and Windows without modifying anything. - Three-tier cleanup classification: Items are sorted into green (safe auto-clean caches), yellow (needs human judgment, e.g. offline videos or chat history), and red (do not delete manually, uninstall properly instead), each with concrete disposal instructions. - Interactive HTML report with guarded deletion: A local server renders a collapsible report where green items can be moved to Trash or deleted via a token-protected, allowlist-validated API. - Use Case: Your Mac says "disk almost full". Run the scan, get a report showing that 27 GB of Xcode DerivedData and browser caches can be freed immediately, and clean them with one click in the browser. ## Quick Start Ask the agent to analyze my disk storage and show me what is taking up space and what I can safely clean.

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 script, which uses du to measure directories under home, Library, Caches, Containers, and Downloads, then outputs JSON of the largest items. The agent classifies them and builds an HTML report showing the top space consumers and cleanup options.

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

The report classifies items into three tiers: green for regenerable caches safe to auto-clean, yellow for user data needing manual judgment, and red for items that should be uninstalled properly. Deletion commands are shown for review, and one-click actions use a strict path allowlist.

Does this disk analyzer work on Windows?▼

Yes, the scan script detects the OS and scans Windows locations like AppData, Temp, Downloads, and Program Files using os.scandir, with multi-drive support. However, the Windows code path has not been tested on a real Windows machine, so results should be verified.

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

Delete buttons only appear when the report is served through the local server script, not the static HTML file, because file:// pages cannot touch the filesystem. Also, each green item must include trash_paths in the analysis JSON for its button to render.

Is it safe to let the report delete files automatically?▼

The local server binds to 127.0.0.1 with a random session token, validates every path against an allowlist built from the report, and requires paths to be under the home directory. Trash mode is reversible via the system Trash, while direct delete is limited to green-tier cache paths only.

Related Skills

Explore More Personal & Entrepreneur Skills→
idemeumidemeum

disk-cleanup

Scan disks for large, duplicate, stale, and cache files with consent-gated deletion.

Official
Advanced
evolution-foundationevolution-foundation
520

plugin-uninstall

Uninstall EvoNexus plugins by removing files, clearing hooks, and running uninstall SQL.

Official
Intermediate
lucifertrjlucifertrj
17

qdrant-memory-usage-optimization

Diagnose and optimize Qdrant deployment memory usage with quantization and on-disk storage.

Community
Advanced
storyweaverstoryweaver
37

argus-gui-automation

Automate desktop GUI interactions on macOS and Windows via an MCP server.

Community
Intermediate