Disk Manager Skill

Analyze disk usage, find large files, clean up temporary files, and manage storage.

When to Use

✅ USE this skill when:

• "Check disk space"
• "Find large files"
• "Clean up temp files"
• "Analyze directory size"
• "What's using my disk space?"

When NOT to Use

❌ DON'T use this skill when:

• Need real-time monitoring ΓåÆ use system monitoring tools
• Disk benchmarks ΓåÆ use HD benchmarks tools
• File system repair ΓåÆ use fsck/repair tools

Commands

Disk Space

{baseDir}/disk.sh space
{baseDir}/disk.sh space --human-readable
{baseDir}/disk.sh space /path/to/check
{baseDir}/disk.sh space --all

Directory Usage

{baseDir}/disk.sh du /path/to/directory
{baseDir}/disk.sh du /path/to/directory --depth 2
{baseDir}/disk.sh du /path/to/directory --sort-by-size
{baseDir}/disk.sh du /path/to/directory --threshold 100M

Find Large Files

{baseDir}/disk.sh largest /path/to/search
{baseDir}/disk.sh largest /path/to/search --limit 20
{baseDir}/disk.sh largest /path/to/search --min-size 100M
{baseDir}/disk.sh largest /path/to/search --type f

Find Old Files

{baseDir}/disk.sh old /path/to/search --days 30
{baseDir}/disk.sh old /path/to/search --days 90 --delete
{baseDir}/disk.sh old /tmp --days 7 --list

Clean Up

{baseDir}/disk.sh clean --temp
{baseDir}/disk.sh clean --cache
{baseDir}/disk.sh clean --logs
{baseDir}/disk.sh clean --all
{baseDir}/disk.sh clean --dry-run

File Type Distribution

{baseDir}/disk.sh types /path/to/analyze
{baseDir}/disk.sh types /path/to/analyze --by-size
{baseDir}/disk.sh types /path/to/analyze --by-count

Inode Usage

{baseDir}/disk.sh inodes
{baseDir}/disk.sh inodes /path/to/check
{baseDir}/disk.sh inodes --find-high-usage

Options

Option	Description	Default
--human-readable	Show sizes in human format	false
--depth N	Directory traversal depth	1
--sort-by-size	Sort by size (largest first)	false
--limit N	Limit number of results	10
--min-size SIZE	Minimum file size (e.g., 100M)	None
--max-size SIZE	Maximum file size	None
--type TYPE	File type: f (file), d (dir)	all
--days N	Files older than N days	30
--delete	Delete found files (dangerous)	false
--dry-run	Show what would be deleted	false
--threshold SIZE	Show only directories above size	None
--by-size	Sort by total size	false
--by-count	Sort by file count	false

Size Units

Unit	Value
K	Kilobytes (1024 bytes)
M	Megabytes (1024K)
G	Gigabytes (1024M)
T	Terabytes (1024G)

Output Examples

Disk Space

Filesystem      Size  Used Avail Use% Mounted on
/dev/sda1       100G   45G   55G  45% /
/dev/sda2       500G  200G  300G  40% /home
tmpfs           8.0G     0  8.0G   0% /tmp

Directory Usage

Directory Usage: /home/user
================================
45.2G  Downloads/
32.1G  Documents/
10.5G  .cache/
8.2G   .local/
2.3G   .config/
--------------------------------
98.3G  Total

Large Files

Top 10 Largest Files in /home/user
====================================
4.2G   Downloads/ubuntu.iso
2.1G   VMs/ubuntu-vm.vdi
1.8G   Downloads/movie.mp4
950M   .cache/pip/http/...
...

File Types

File Types by Size: /home/user/Downloads
=========================================
mp4    12.5G  (45 files)
iso    4.2G   (1 file)
pdf    2.1G   (156 files)
zip    1.8G   (23 files)
jpg    1.2G   (890 files)
...

Examples

Check disk space:

{baseDir}/disk.sh space --human-readable
# Shows all mounted filesystems with usage

Find large files:

{baseDir}/disk.sh largest /home/user --limit 20 --min-size 100M
# Top 20 files over 100MB

Analyze directory:

{baseDir}/disk.sh du /var/log --depth 2 --sort-by-size
# Show log directory structure by size

Clean temp files:

{baseDir}/disk.sh clean --temp --dry-run
# Show what would be cleaned (dry run)
{baseDir}/disk.sh clean --temp
# Actually clean temp files

Find old files:

{baseDir}/disk.sh old /tmp --days 7 --list
# List files in /tmp older than 7 days

File type analysis:

{baseDir}/disk.sh types /home/user/Downloads --by-size
# Show space used by each file type

Danger Zone

Use --delete with caution:

# Dry run first!
{baseDir}/disk.sh old /tmp --days 30 --delete --dry-run

# Only then actually delete
{baseDir}/disk.sh old /tmp --days 30 --delete

Notes

• Uses df, du, and find under the hood
• Safe operations by default (no deletion without --delete)
• Dry run recommended before any cleanup
• Handles permission errors gracefully
• Can analyze specific directories or entire filesystem