Guide · Agent skill
How to use the Storage Analyzer agent skill (macOS and Windows)
Updated · written with AI from the project's own documentation and checked against our catalogue data
Storage Analyzer is an agent skill for Claude that scans your computer's disk, explains what is using the space and sorts the big items into three cleanup levels. It is aimed at people whose disk is nearly full, especially on macOS, and at developers who want to find large caches. By the end of this guide you will know what an agent skill is, how to install this one, how to ask for a scan in plain language and how to use the report it produces.
Storage AnalyzerKKKKhazix/khazix-skills · MIT Download the skill Quick start
- 1Download and unzip. Download the storage-analyzer ZIP from this page and unzip it.
- 2Place the folder. Move the storage-analyzer folder into ~/.claude/skills/ or a project's .claude/skills/ folder, or upload it under Settings → Capabilities → Skills.
- 3Check requirements. Make sure Python 3 is installed. On Windows, use python or py -3.
- 4Ask in plain words. Tell Claude something like 'my disk is full, what is taking space' so the skill loads.
- 5Review the report. Open the generated HTML report and read the three levels before acting on any suggestion.
- 6Act carefully. Use copy-to-clipboard commands yourself, or use the server buttons only for items you have verified.
What is an agent skill and what does Storage Analyzer do?
An agent skill is a folder of instructions and scripts that Claude can load when a request matches the skill's description. Storage Analyzer is one such skill. When you ask Claude why your disk is full, it runs read-only scans of your storage and groups the biggest items into three levels.
The three levels are: safe to auto-clean (caches and temporary files), needs your judgment (offline videos, documents, project folders) and risky to delete by hand (duplicate or large apps). The skill then produces an interactive HTML report with copyable cleanup commands.
- Scans run read-only: the skill is written to only list, count and measure, not to change files.
- Cleanup commands are shown for you to review and run yourself.
- Memory (RAM) and running processes are out of scope; the skill covers storage only.
How do you install the storage-analyzer skill?
Download the ZIP from this page and unzip it. Then place the storage-analyzer folder in one of two locations: ~/.claude/skills/ for all your projects, or a project's .claude/skills/ folder for that project only.
You can also upload the skill in the Claude apps under Settings → Capabilities → Skills.
- Personal install: ~/.claude/skills/storage-analyzer
- Project install: .claude/skills/storage-analyzer inside your project folder
- App install: Settings → Capabilities → Skills, then upload the skill
~/.claude/skills/storage-analyzerWhat do you need before you run it?
The skill's scripts use only the Python 3 standard library, so there is nothing to pip install. On macOS, Python 3 and the built-in tools du, diskutil and osascript are used. On Windows you need Python 3 installed, and the command is usually python or py -3 rather than python3.
You also need a browser to view the generated report.
- macOS: Python 3 plus built-in du, diskutil, osascript
- Windows: Python 3, run with python or py -3
- A browser to open the HTML report
- Runs scripts: yes. Uses network: no.
How do you trigger the skill with a natural request?
You do not need a special command. Describe the problem in ordinary words and Claude will load the skill when the request matches. The skill is triggered by phrases such as 'disk is full', 'free up space', 'what is taking up space' or 'disk cleanup'.
Be specific about what you want. If you only want to see the space used, say so; if you want cleanup ideas, ask for them.
- My disk is full, what is taking up the space?
- Do a storage analysis and show me what I can safely clean.
- Help me free up space on my Mac.
- Which folders are using my C: drive on Windows?
- Clear my caches and tell me what is risky to delete.
What happens during a scan and how is the report used?
The skill scans your home folder, Library, caches, app data and developer caches on macOS, or your user profile, AppData, temp, downloads and Program Files folders on Windows. Unreadable folders are listed in the report as denied, so you can see what was missed.
Claude then reads the results, classifies each item and builds the report. The report shows a disk overview, the top five space users, cleanup advice, the three collapsible levels with copyable commands and long-term tips. Sizes are estimates and are labelled as such.
- Green: automatically cleanable caches, temp files and installer leftovers, each with an estimated saving and a copyable command.
- Yellow: items with user data, such as offline videos, documents and node_modules. You get a content description, options and risk notes.
- Red: items you might want to remove but should not delete by hand, such as duplicate or large apps, with step-by-step uninstall advice.
- The skill does not give delete or uninstall buttons for red items.
What are the safety notes for scripts and the local server?
The skill runs scripts, so read SKILL.md and the scripts before you install it if you need to verify them. The optional local server listens on 127.0.0.1 on a random port with a random token. It lets you move items to the Trash or delete them from the report page. Every delete click asks for browser confirmation first.
Direct delete is permanent and cannot be undone. Move to Trash is reversible, but the space is only freed once you empty the Trash. The skill's notes say Windows support has not been tested on real machines, so check target paths and results carefully there.
- Direct delete (rm) is irreversible; use it only for items you have checked.
- Moving to the Trash is reversible until you empty it.
- Windows support has not been tested on real machines.
- Do not leave the server running unattended.
python3 scripts/server.py /tmp/storage_analysis.jsonWhat people use it for
- Finding which app or hidden folder holds tens of gigabytes of offline videos on a Mac.
- Clearing developer caches such as Xcode DerivedData, npm or pip caches.
- Seeing which folders on the C: drive are taking space on Windows, with Python 3 installed.
- Getting a prioritised list of what to clean first before deleting anything.
Frequently asked questions
Is the storage-analyzer skill free and what is its licence?
The skill is published under the MIT licence, as stated on this page. Check the licence file in the downloaded repository for the full terms.
What do I need to run storage-analyzer?
You need Python 3, which the scripts use with only the standard library, so no pip installs are needed. On macOS the built-in du, diskutil and osascript tools are used, and a browser is needed to view the report.
Does storage-analyzer work on Windows?
It includes Windows code, but the skill's notes say it has not been tested on real Windows machines. Install Python 3 and check the paths and results carefully on Windows.
Will the skill delete my files automatically?
No. Scans are read-only and cleanup commands are shown for you to run after confirming. Delete buttons only appear when you run the local server, and each click asks for browser confirmation.
Does storage-analyzer check RAM or memory usage?
No. The skill excludes memory usage and running processes because RAM is not storage. Ask Claude to check memory separately if you need that.
How does it compare with visual disk tools like DaisyDisk?
Storage Analyzer works through Claude and produces a tiered report with advice. Visual tools such as DaisyDisk, GrandPerspective and OmniDiskSweeper, which the skill also mentions, are better for browsing the disk map yourself.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
Storage Analyzer suits Mac users with a nearly full disk who want to know what is using space, developers hunting for large caches, and Windows users comfortable installing Python 3. Skip it if you need unattended deletion, RAM checks, or confidence on Windows, since its Windows support is untested and direct delete is irreversible.
Download the skill