macos-storage-management

Reclaim Mac storage by safely archiving resident files to external drives with hash verification.

115|9|Updated Aug 5, 2026
One-click install
npx skills add https://github.com/AtlasOmnia/donna-starter --skill macos-storage-management-atlasomnia
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: macos-storage-management
Source: https://github.com/AtlasOmnia/donna-starter/tree/main/skills/apple/macos-storage-management
Command: npx skills add https://github.com/AtlasOmnia/donna-starter --skill macos-storage-management-atlasomnia

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Freeing space on a Mac is risky: iCloud and File Provider placeholders look like real files, ExFAT drives silently drop macOS metadata, and a failed cross-volume move can destroy data. This Skill provides a fail-closed workflow for diagnosing storage pressure and moving data to external SSDs without losing files or cloud content. ## Core Features & Use Cases - Accurate storage diagnosis: Measures the live APFS Data volume with df -h "$HOME", distinguishes allocated blocks from logical sizes, and detects dataless File Provider placeholders before any cleanup. - Fail-closed verified transfers: Archives resident files to APFS or ExFAT destinations with SHA-256 verification, atomic .partial finalization, and source re-checks before any deletion. - Application data classification: Separates movable archives, rebuildable caches, app-managed stores (Docker.raw, Photos, OneDrive), and live state so only safe candidates are moved. - Use Case: Your Mac shows a full disk and a bloated "System Data" category. The Skill ranks space consumers, archives inactive Git repositories and dated backups to an external SSD with hash verification, skips open files during cache cleanup, and reports actual reclaimed capacity. ## Quick Start Ask the assistant to free up space on your Mac by moving old files from Documents to your external SSD safely.

Frequently Asked Questions about macos-storage-management

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

FAQPage Schema
How do I free up space on my Mac safely?

Measure the live Data volume with df -h "$HOME", rank large directories with du, and classify candidates into movable archives, rebuildable caches, and app-managed stores. Move only verified inactive data to an external drive using hash-checked copies before deleting any source files.

How do I move files from iCloud Drive to an external SSD?

First detect File Provider placeholders using ls -lO@ and stat: files with dataless flags and zero blocks are not resident. Archive only resident regular files with SHA-256 verification, and leave placeholders untouched since deleting them removes cloud originals without reclaiming local space.

Why does my Mac show a huge System Data category?

System Data is a classification bucket, not a folder. Check APFS snapshots, Time Machine local snapshots, app containers, caches, developer runtimes, and /private/var/folders with allocated-block measurements to find the real consumers before deleting anything.

Can I copy macOS files directly to an ExFAT drive?

ExFAT does not preserve macOS symlinks, permissions, extended attributes, or resource forks, so direct copies of app bundles or Git trees lose metadata. Use an uncompressed PAX tar archive with a manifest on ExFAT, and verify hashes before removing sources.

How do I reduce Docker Desktop disk usage on Mac?

Docker.raw is a sparse disk, so compare its logical size with allocated blocks first. Use docker system df -v to attribute usage, remove retired projects in dependency-safe order, and never run docker system prune --volumes blindly or delete Docker.raw manually.

Why did my file copy fail with Resource deadlock avoided?

This error signals cloud-only placeholder files in a File Provider tree that cannot be opened locally. Stop retrying bulk copies, inspect dataless flags and allocated blocks, and switch to a resident-only archiving strategy that skips placeholders.