ssh_host_disk_usage

Check remote host disk usage via SSH and parse output into a structured report.

6|Updated Apr 17, 2026
One-click install
npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-host-disk-usage
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ssh_host_disk_usage
Source: https://github.com/Nightreaver/python-ssh-mcp/tree/main/skills/ssh-host-disk-usage
Command: npx skills add https://github.com/Nightreaver/python-ssh-mcp --skill ssh-host-disk-usage

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

Quickly identify disk usage on remote hosts to prevent overage and ensure system performance.

Core Features & Use Cases

  • Disk Usage Reporting: Provides detailed disk usage information for each filesystem on a remote host.
  • POSIX Support: Designed for POSIX-compliant systems, with support for Windows via alternative commands.
  • Use Case: When a host is slow or unresponsive, use this skill to check if any filesystems are at 100% capacity, which can be a sign of a silent failure.

Quick Start

Check the disk usage on a remote host by running ssh_host_disk_usage(host="db01").

Frequently Asked Questions about ssh_host_disk_usage

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

FAQPage Schema
How do I check disk usage on a remote host via SSH?

To check disk usage on a remote host via SSH, the skill connects using SSH credentials and parses output to provide a structured report. You can execute it by passing the target hostname, like `ssh_host_disk_usage(host="db01")`.

What's the best way to check remote filesystem capacity for troubleshooting?

Checking remote filesystem capacity is best done by running a script that parses disk usage output into a structured report. This helps identify if any filesystems are at 100% capacity, which can indicate a silent failure causing system slowness.

Does this disk usage monitoring work with POSIX systems?

Yes, this disk usage monitoring is designed for POSIX-compliant systems. It parses standard disk usage output to provide a structured report, with support for Windows via alternative commands to ensure compatibility.

Do I need Python to monitor remote host disk space?

Yes, you need Python to monitor remote host disk space using this skill. It requires Python script execution capabilities on the host running the check, along with SSH access to the target remote host.

Why would I need to check disk space on a remote server?

You need to check disk space on a remote server to quickly identify overage and prevent performance degradation. When a host is slow or unresponsive, checking if filesystems are at 100% capacity can reveal silent failures.

Can I get a detailed disk usage report for each filesystem on a remote machine?

Yes, you can get a detailed disk usage report for each filesystem on a remote machine. The skill parses the SSH output to provide a structured report detailing the disk usage of individual filesystems on the target host.