disk-space-analyzer-skill

Disk Space Analyzer

Analyze disk space and find cleanable files. Works with Claude Code, other AI assistants, or standalone.

Features

• Smart Detection - Identifies temp files, caches, logs, dev artifacts (node_modules, pycache, .vs, obj)
• Safety Levels - Categorizes files as safe / check first / admin required
• Migration Hints - Suggests how to relocate large caches (npm, pip, uv, HuggingFace, Docker)
• Flexible Analysis - Search, filter, explore folders at any depth
• Cross-Platform - Supports Windows (via WizTree) and macOS

Demo

https://github.com/user-attachments/assets/b559c502-a1ad-4e1b-98bf-1bf0b550d65e

Requirements

• Python 3.8+
• Windows: WizTree (free, portable version works)
• macOS: No additional tools required

Installation

Claude Code

Option 1: From Marketplace (Recommended)

/plugin marketplace add WhiteMinds/disk-space-analyzer-skill
/plugin install disk-space-analyzer@disk-space-analyzer-skill

Option 2: From GitHub

/plugin install https://github.com/WhiteMinds/disk-space-analyzer-skill

Option 3: Manual - Global Installation

macOS/Linux:

git clone https://github.com/WhiteMinds/disk-space-analyzer-skill.git /tmp/disk-space-analyzer-temp
mkdir -p ~/.claude/skills
cp -r /tmp/disk-space-analyzer-temp/skills/disk-space-analyzer ~/.claude/skills/
rm -rf /tmp/disk-space-analyzer-temp

Windows (PowerShell):

git clone https://github.com/WhiteMinds/disk-space-analyzer-skill.git $env:TEMP\disk-space-analyzer-temp
New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
Copy-Item -Recurse $env:TEMP\disk-space-analyzer-temp\skills\disk-space-analyzer $env:USERPROFILE\.claude\skills\
Remove-Item -Recurse -Force $env:TEMP\disk-space-analyzer-temp

Option 4: Manual - Project-Specific Installation

macOS/Linux:

git clone https://github.com/WhiteMinds/disk-space-analyzer-skill.git /tmp/disk-space-analyzer-temp
mkdir -p .claude/skills
cp -r /tmp/disk-space-analyzer-temp/skills/disk-space-analyzer .claude/skills/
rm -rf /tmp/disk-space-analyzer-temp

Windows (PowerShell):

git clone https://github.com/WhiteMinds/disk-space-analyzer-skill.git $env:TEMP\disk-space-analyzer-temp
New-Item -ItemType Directory -Force -Path .claude\skills
Copy-Item -Recurse $env:TEMP\disk-space-analyzer-temp\skills\disk-space-analyzer .claude\skills\
Remove-Item -Recurse -Force $env:TEMP\disk-space-analyzer-temp

Cursor

Copy the skills/disk-space-analyzer/ folder to your Cursor skills directory:

• macOS/Linux: ~/.cursor/skills/disk-space-analyzer/
• Windows: %USERPROFILE%\.cursor\skills\disk-space-analyzer\

Standalone / Other AI Tools

git clone https://github.com/WhiteMinds/disk-space-analyzer-skill
cd disk-space-analyzer-skill/skills/disk-space-analyzer

No dependencies required - uses Python standard library only.

Usage

With AI Assistants

Once installed, just ask naturally:

• "clean my disk"
• "what's taking up space on C:?"
• "find large files"
• "analyze disk usage"

The AI will automatically detect your OS and use the appropriate workflow.

❯ /disk-space-analyzer C:

● I'll analyze your C: drive disk space. Let me first check the OS and then read the Windows workflow documentation.

● Bash(python3 -c "import sys; print(sys.platform)")
  ⎿  win32

● Read 1 file (ctrl+o to expand)

● You're on Windows. Let me set up WizTree and start the disk analysis.

● Bash(cd "...\disk-space-analyzer" && python scripts/windows/find_wiztree.…)
  ⎿  C:\Users\white\.wiztree\WizTree64.exe

● WizTree is available. Now let me run it to scan your C: drive and export the data.

● Bash(cd "...\disk-space-analyzer" && python scripts/windows/run_wiztree.p…)
  ⎿ Running: C:\Users\white\.wiztree\WizTree64.exe C: /export=...\disk_report.csv /admin=0
    Exporting... 32,616,892 bytes
    Exporting... 71,684,470 bytes
    … +7 lines (ctrl+o to expand)

● Scan complete. Now let me analyze the disk space usage.

● C: Drive Disk Space Analysis

  Overview
  ┌─────────────────────┬───────────┐
  │       Metric        │   Value   │
  ├─────────────────────┼───────────┤
  │ Total Used          │ 846.5 GB  │
  ├─────────────────────┼───────────┤
  │ Total Files         │ 3,935,901 │
  ├─────────────────────┼───────────┤
  │ Potential Cleanable │ ~247 GB   │
  └─────────────────────┴───────────┘

  Top Space Consumers by Folder
  ┌───────────────────────────┬──────────┐
  │         Location          │   Size   │
  ├───────────────────────────┼──────────┤
  │ C:\Users\white\           │ 458.9 GB │
  ├───────────────────────────┼──────────┤
  │ C:\ProgramData\Microsoft\ │ 136.8 GB │
  ├───────────────────────────┼──────────┤
  │ C:\Windows\System32\      │ 20.6 GB  │
  └───────────────────────────┴──────────┘