disk-usagelisted
Install: claude install-skill tony/ai-workflow-plugins
Survey this machine's disk usage and report where the space went.
Scope: $ARGUMENTS — when empty, survey every mounted filesystem.
This command is read-only. Do not delete, move, compress, or modify
anything. Do not halt a virtual machine or WSL guest under any
circumstance. Produce an analysis the user can act on, and end by
offering the `disk-reclaim` skill.
## Establish the layer structure
Read `references/virtual-disks.md` first.
Run `df -h` and identify every distinct filesystem with its used and
available space. Determine which of them is the binding constraint —
the one closest to full — because that governs which findings matter.
When a filesystem is a virtual disk, find its backing file on the host
and compare that file's allocated size against the used space reported
inside the guest. The gap is balloon: space recoverable by compaction
alone, without deleting anything. Report it as a distinct figure.
Check whether the guest issues TRIM, so the report can explain whether
balloon will keep re-accumulating.
## Measure
Survey each filesystem separately. Prefer `dust` with an explicit depth
and minimum size, falling back to `du` when unavailable.
Set the minimum size relative to the filesystem rather than using a
fixed value, so a small disk still produces findings and a large one is
not drowned in them. Around one percent of total capacity works.
Resolve symlinks before recording a size. Configuration directories
managed by a dotfiles repository routinely app