disk-usage-audit

Map disk usage and identify reclaimable storage across macOS and Linux.

3|Updated Jan 14, 2014
One-click install
npx skills add https://github.com/prateek/dotfiles --skill disk-usage-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: disk-usage-audit
Source: https://github.com/prateek/dotfiles/tree/main/.agents/skills/disk-usage-audit
Command: npx skills add https://github.com/prateek/dotfiles --skill disk-usage-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Map disk usage and identify reclaimable storage across macOS, Linux, and similar environments.

Core Features & Use Cases

  • Build a storage map that separates logical usage from reclaimable bytes.
  • Perform clone-aware validation for APFS to estimate immediate reclaim.
  • Generate structured reports with measurements, notes, and actionable cleanup guidance.

Quick Start

Run the disk-usage-audit on a target path to generate a storage map and cleanup recommendations.

Frequently Asked Questions about disk-usage-audit

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I map disk usage and find large files to clean up on macOS?

To map disk usage on macOS, you need a tool that separates logical storage from reclaimable bytes. This audit builds a storage map using true metrics from df and diskutil, ranking large items by risk and reclaimability to guide safe cleanup.

Does APFS clone-aware validation help estimate reclaimable disk space?

APFS clone-aware validation estimates reclaimable disk space by identifying cloned files that appear large but consume minimal actual storage. The audit script uses non-destructive measurements to distinguish true usage from shared data, ensuring accurate cleanup recommendations.

How do I rank cleanup candidates by impact when my disk is almost full?

Ranking cleanup candidates by impact requires analyzing true usage metrics rather than apparent file sizes. The audit evaluates large items by risk and reclaimability, generating structured reports with actionable guidance for safe space recovery during low-disk warnings.

Can I use the same disk usage audit tool on both macOS and Linux?

Yes, the disk usage audit works across macOS, Linux, and similar environments. It relies on standard utilities like df and diskutil to gather true usage metrics, applying clone-aware validation logic specifically for APFS while supporting broader storage mapping on Linux.

What is the best way to identify reclaimable storage without deleting important files?

Identifying reclaimable storage safely requires non-destructive measurements that distinguish between logical usage and truly reclaimable bytes. The audit applies clone-aware validation and ranks items by reclaimability, providing clear reporting to guide cleanup without risking important data.

Why does disk usage show different numbers between df and actual file sizes on APFS?

Disk usage discrepancies on APFS occur because of clone-aware file sharing, where cloned files share data blocks but appear as separate sizes. The audit uses clone-aware validation logic to provide non-destructive measurements that reflect true reclaimable storage rather than apparent file sizes.