A command-line tool to identify large files, analyze partition usage, and monitor storage on Linux systems.

Install

mkdir -p .claude/skills/disk-usage && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/2353" && unzip -o skill.zip -d .claude/skills/disk-usage && rm skill.zip

Installs to .claude/skills/disk-usage

Activation

This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.

Analyze disk space usage, filesystem mounts, and storage allocation on Linux systems. Identifies large files and directories, checks partition usage, and reports inode consumption. Use when the user asks about disk full errors, free space, storage usage, du/df output, finding large files, or checking which directories consume the most space.
343 chars✓ has a “when” triggerlonger than Claude Code's old 250-char listing cap (fine on current versions)
Beginner

Key capabilities

  • Analyzes filesystem mount usage
  • Identifies large directories and files
  • Reports inode consumption
  • Lists block device information

How it works

It utilizes standard Linux utilities like df, du, and find to report on storage allocation and identify space-consuming files.

Inputs & outputs

You give it
Filesystem path
You get back
Disk usage statistics and large file list

When to use disk-usage

  • Troubleshooting disk full errors
  • Identifying largest directories and files
  • Checking filesystem mount usage
  • Auditing partition storage allocation

About this skill

Disk Usage Skill

Analyzes disk space and filesystem usage on Linux systems.

Suggested Workflow

  1. Run ./scripts/diskinfo.sh for a structured overview of mounts, block devices, and top directories.
  2. Check df -h output for any filesystem above 80% usage.
  3. Drill into high-usage mounts with du -h --max-depth=1 /mount to find large subdirectories.
  4. Locate specific large files with find /path -type f -size +100M.

Commands Reference

Filesystem Overview

  • df -h - Disk space usage for all mounted filesystems (human-readable)
  • df -i - Inode usage (number of files)
  • lsblk - Block device tree (disks, partitions)
  • mount - Currently mounted filesystems

Directory Size Analysis

  • du -sh /path - Total size of a directory
  • du -h --max-depth=1 /path - Size of immediate subdirectories
  • du -ah /path | sort -rh | head -20 - Largest files/directories

Finding Large Files

  • find /path -type f -size +100M - Files larger than 100MB
  • find /path -type f -size +1G - Files larger than 1GB
  • ls -lhS /path | head -20 - List files sorted by size (largest first)

Disk Information

  • cat /proc/partitions - Partition table
  • cat /proc/mounts - Mount information
  • stat -f /path - Filesystem statistics

Tips

  • Always use -h for human-readable sizes
  • The du command can be slow on large directories; use --max-depth=1 to limit recursion
  • Root filesystem (/) usage above 90% may cause issues

When not to use it

  • Non-Linux filesystems
  • Real-time performance monitoring

Prerequisites

Linux shell accessRead permissions for target paths

Limitations

  • du command can be slow on large directories
  • Requires root access for full system analysis

How it compares

It provides a structured diagnostic workflow for disk issues instead of requiring manual command chaining.

Compared to similar skills

disk-usage side by side with the closest alternatives in the catalog.

SkillInstallsUpdatedSafetyDifficulty
disk-usage (this skill)34moReviewBeginner
network-info34moReviewBeginner
debug-cluster28moReviewIntermediate
doctor13moCautionBeginner

Try saying

Example prompts that trigger this skill in your AI assistant.

You might also like

network-info

UKGovernmentBEIS

Gather network configuration and connectivity information including interfaces, routes, and DNS

329

debug-cluster

openshift

Provides systematic debugging approaches for HyperShift hosted-cluster issues. Auto-applies when debugging cluster problems, investigating stuck deletions, or troubleshooting control plane issues.

25

doctor

Yeachan-Heo

Diagnose and fix oh-my-claudecode installation issues

14

replit-advanced-troubleshooting

jeremylongshore

Apply Replit advanced debugging techniques for hard-to-diagnose issues. Use when standard troubleshooting fails, investigating complex race conditions, or preparing evidence bundles for Replit support escalation. Trigger with phrases like "replit hard bug", "replit mystery error", "replit impossible to debug", "difficult replit issue", "replit deep debug".

04

devops-troubleshooter

sickn33

Expert DevOps troubleshooter specializing in rapid incident response, advanced debugging, and modern observability. Masters log analysis, distributed tracing, Kubernetes debugging, performance optimization, and root cause analysis. Handles production outages, system reliability, and preventive monitoring. Use PROACTIVELY for debugging, incident response, or system troubleshooting.

12

vastai-common-errors

jeremylongshore

Diagnose and fix Vast.ai common errors and exceptions. Use when encountering Vast.ai errors, debugging failed requests, or troubleshooting integration issues. Trigger with phrases like "vastai error", "fix vastai", "vastai not working", "debug vastai".

03

Search skills

Search the agent skills registry