- Home
- Skills
- DevOps & Cloud
- Disk Preflight
Works with the AI Agents you already use
Disk Preflight
Read-only diagnostic tool to check free disk space and identify large dev caches before installs or builds.
Free
Disk Preflight
Example session with this skill installed
I'm about to pull a 5GB Docker image. Is my disk full and will it fit?
- Read your context and instructions
- Compiled the disk preflight
Disk preflight check completed. I've analyzed your primary filesystem and common development cache locations to determine if the 5GB pull is safe to proceed.
Disk preflight — workstation-alpha
Verdict: TIGHT · 8.4 GB free (8.2%)
| Consumer | Path | Size |
|---|---|---|
| Xcode DerivedData | ~/Library/Developer/Xcode/DerivedData | 14.2 GB |
| Docker data | ~/Library/Containers/com.docker.docker/Data | 12.1 GB |
| npm cache | ~/.npm/_cacache | 5.8 GB |
| Rust/Cargo | ~/.cargo/registry | 3.2 GB |
Fits a 5 GB install? Yes, but with less than 4GB remaining, system performance may degrade.
Next steps:
- Proceed with the Docker pull if immediate, but monitor for "no space" errors during extraction.
- Run
dev-disk-reclaimerto generate a risk-labeled cleanup plan for the Xcode and npm caches. - Consider pruning unused Docker volumes to move the verdict back to OK.
Nothing was measured outside the home directory. No files were changed. Sizes are estimates based on directory traversal.
Connects securely to your tools. The creator never sees your data.
About this skill
Builds fail when storage hits zero. This skill provides a read-only assessment of disk health and identifies the largest development-related space consumers before you trigger a large operation. It prevents failed installs, container pulls, and clones by checking capacity against the expected load.
What it does
- Capacity verification calculates total and free filesystem space for the home directory.
- Resource auditing scans for high-volume development caches including npm, Cargo, and Homebrew.
- Environment analysis identifies space-heavy project artifacts like
node_modules,target/, and.nextdirectories. - Container inspection measures Docker data and container images without requiring sudo.
- Safety verdict provides a clear OK, TIGHT, or CRITICAL status based on free percentage and volume.
How it works
- Triggering occurs via the
/disk-preflightcommand or when you ask about remaining space. - OS detection determines the correct diagnostic commands for macOS or Linux environments.
- Data gathering runs read-only checks on standard development paths and package manager caches.
- Analysis compares findings against pre-defined thresholds to issue a resource verdict.
Frameworks & tools
Uses native OS utilities like df and du. Scans for ecosystem-specific paths including Docker, npm, Xcode, and Rust/Cargo.
Why this beats prompting it yourself
Generic prompts often lead to agents attempting sudo operations or scanning irrelevant system files. This skill follows a strict read-only protocol that skips database directories and symlinks, focusing only on the high-impact dev folders that actually matter for cleanup.
Use cases
- Check if a 15GB Docker image pull will fit on the current volume.
- Debug why a CI/CD build script is failing with "no space left on device".
- Perform a quick triage of project bloat before a major system update.
- Verify available overhead before cloning a large monorepo.
Known limitations
Windows is not supported. It cannot modify or delete files and does not scan database directories or paths outside the home directory.
Windows is unsupported. Read-only only; cannot delete files. Skips database directories and paths outside the home directory. Requires standard shell utilities like df and du.
How to use
- 1
Connect your agent to the Agensi MCP
Copy the prompt and paste it into Claude, ChatGPT, Cursor or any agent that supports MCP. It sets up the connection for you. Manual setup
- 2
Sign in to Agensi
Your agent shows a sign-in link. Sign in and click Allow.
- 3
Ask for what you need
Your agent loads this skill and uses it on your task. It always asks before any payment.
Reviews
No reviews yet
Be one of the first to try it. Every listed skill goes through the trust checks below.
Security scanned
Checked by our 8-point scan before listing
1 use
Times used to date
Free forever
No account required to browse
Trust & safety
Security scan
Security scan passed 26 days ago
- Free with an Agensi account
Requires
Permissions
File Scopes