disk-space-optimizer

SKILL.md: Disk Space Optimization

Purpose: Intelligently free disk space by removing build artifacts, caches, and stale repositories without affecting active development.

Scope: Analyze disk usage, identify safe cleanup targets, preserve active projects, and report freed space.

---

Overview

This skill helps manage constrained disk space by:

1. Diagnosing current usage hotspots
2. Identifying artifacts that can be safely removed (caches, builds, stale repos)
3. Preserving all active projects and development environments
4. Reporting what was freed and what remains

Safe to use: Does NOT delete source code, .git history, or active project dependencies.

---

Usage

# Full diagnosis and cleanup
openclaw skill disk-space-optimizer analyze --aggressive
openclaw skill disk-space-optimizer cleanup --exclude="active,important"

# Report only (no changes)
openclaw skill disk-space-optimizer report

# Verify what's safe to delete
openclaw skill disk-space-optimizer candidates --days=30

---

Core Procedures

1. Diagnosis: Identify Hotspots

Goal: Find what's consuming space, categorized by age and type.

# Overall disk usage
df -h ~

# Largest directories by category
du -sh ~/.npm ~/.cache ~/.openclaw/workspace ~/Documents/GitHub 2>/dev/null | sort -rh

# Repository sizes
cd ~/Documents/GitHub && for dir in */; do 
  du -sh "$dir" 2>/dev/null
done | sort -rh

# Build artifacts (largest by far)
find ~/Documents/GitHub -maxdepth 3 -type d \( -name ".next" -o -name "target" -o -name "build" -o -name "dist" \) -exec du -sh {} \; 2>/dev/null | sort -rh

# Git repositories by activity
cd ~/Documents/GitHub && find . -maxdepth 2 -name ".git" -type d | while read d; do
  repo=$(dirname "$d")
  commits=$(git -C "$repo" log --oneline --since='7 days ago' 2>/dev/null | wc -l)
  size=$(du -sh "$d" 2>/dev/null | cut -f1)
  echo "$commits commits | $size | $repo"
done | sort -rn

2. Categorize by Safety

Safe to Remove (auto-regenerate):

• ~/.npm/ — npm cache
• ~/.cache/zig, ~/.cache/puppeteer, ~/.cache/cmux, etc. — dev tool caches
• repo/.next/ — Next.js build (in stale repos, <1 commit/7 days)
• repo/target/ — Rust build (in stale repos)
• repo/build/, repo/dist/ — Build artifacts (in inactive repos)
• repo/node_modules/ — Dependencies (in stale repos only)