check-capacity

Monitors disk, inode, memory, and log store usage against configured thresholds on Linux and macOS.

2|Updated Jun 14, 2026
One-click install
npx skills add https://github.com/odysseyalive/claude-watchman --skill check-capacity-odysseyalive
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: check-capacity
Source: https://github.com/odysseyalive/claude-watchman/tree/main/skills/grammar/check-capacity
Command: npx skills add https://github.com/odysseyalive/claude-watchman --skill check-capacity-odysseyalive

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Servers and workstations fail silently when a filesystem fills up, an inode table exhausts, memory pressure builds, or log storage grows unbounded. This Skill detects those capacity risks early by measuring actual usage against configurable warn and critical thresholds, so you get a journaled finding before services break. ## Core Features & Use Cases - Disk and inode monitoring: Checks every mounted filesystem with df, escalates to critical severity past the danger band, and on critical findings lists the largest files consuming space so you know what to clean. - Cross-platform memory pressure: Uses free on Linux and vm_stat with the live page size on macOS (including Apple Silicon) to detect sustained low available memory. - Log store size tracking: Measures journald disk usage on Linux and the Unified Log store on macOS, flagging unbounded growth. - Use Case: During a scheduled /watchman audit, the Skill finds a root filesystem at 96% capacity, journals a critical finding with the top space-consuming files, and the report emails you exactly what is filling the disk. ## Quick Start Ask the AI to run a capacity check on this machine and report any disk, inode, memory, or log store findings against the configured thresholds.

Frequently Asked Questions about check-capacity

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

FAQPage Schema
How do I check disk space usage against thresholds on Linux?▼

Run df -P per mounted filesystem and compare usage against warn and critical percentage thresholds from the config file. This Skill automates that check, journals findings per mountpoint, and on critical usage lists the largest files consuming space.

How to monitor memory pressure on macOS with vm_stat?▼

Multiply vm_stat page counts by the live page size from sysctl -n hw.pagesize (16384 on Apple Silicon, 4096 on Intel) and compare against hw.memsize. The Skill records pages free, wired, and active, and raises a finding when available memory stays low.

Does this disk check work on Windows?▼

Yes, through a PowerShell dispatcher using Get-Volume for per-volume free space and ported capacity functions for memory and log store size. The inode check is skipped on Windows because NTFS has no inode table.

Why does a full inode table cause failures with free disk space?▼

Each file consumes one inode, so exhausting the inode table makes writes fail even when bytes remain. The Skill checks df -iP against inode warn and critical thresholds; on APFS it self-suppresses because inodes are allocated dynamically.

Can this Skill delete files to free up disk space?▼

No. It is strictly read-only and observational: it identifies what is filling a filesystem but never deletes data or frees space. Cleanup is a separate operator-approved action handled by the fixer workflow.