How do I install the Sbh skill?

Run npx skillmds@latest add jordanchoo/sbh in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sbh?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

JordanChoo (@jordanchoo) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sbh by jordanchoo — Agent Skill

Name: Sbh
Author: JordanChoo

File contents

SBH — Storage Ballast Helper

Prevents disk-full disasters via ballast files, artifact scanning, and predictive pressure monitoring. Three-pronged: ballast (instant space), scanner (stale artifacts), special locations (/tmp, /dev/shm, swap).

Quick Check

sbh status                     # Pressure level + free space
sbh status --json | jq '.pressure'  # Machine-parseable
sbh check --need 5G            # "Do I have 5 GB free?"
sbh check --predict 30         # "Will I run out in 30 min?"

Exit codes: 0 = healthy, 1 = pressure, 2 = error.

Daemon

sbh daemon                          # Foreground (debugging)
systemctl --user start sbh          # Systemd user scope
sbh install --systemd --user --auto # Install + start (Linux)
sbh install --launchd --auto        # Install + start (macOS)
sbh install --wizard                # Guided interactive setup

Signals: SIGHUP = reload config, SIGUSR1 = force scan now, SIGTERM = graceful stop.

Ballast

Pre-allocated sacrificial files — released in milliseconds, no scanning needed.

sbh ballast status             # Per-volume inventory
sbh ballast provision          # Create/rebuild pool
sbh ballast release 3          # Free 3 files NOW
sbh ballast replenish          # Rebuild after pressure passes

Defaults: 10 x 1 GiB = 10 GiB. Ensure ballast dir is on same mount as pressure source.

Scanning & Cleanup

sbh scan /data/projects --top 20       # Rank artifacts by score
sbh clean /data/projects --dry-run     # Preview what would go
sbh clean --target-free 50G --yes      # Delete until 50 GB free

Scoring: Location (.25) + Name (.25) + Age (.20) + Size (.15) + Structure (.15) = 1.0.

Protection

sbh protect /path              # .sbh-protect marker (subtree)
sbh unprotect /path            # Remove marker

Config globs: scanner.protected_paths. Hard vetoes (always enforced): .git/ dirs, open files, age < 10 min, non-writable parents.

Emergency Recovery

Zero-write mode for near-100% full disks. No config file needed.

sbh emergency /data --yes              # Aggressive cleanup NOW
sbh emergency --target-free 10G        # Stop at 10 GB recovered

Observability

sbh dashboard                  # TUI: 7 screens (1-7 to jump)
sbh stats --window 24h         # Activity over last 24 hours
sbh blame --top 10             # Top 10 pressure sources
sbh explain --id <ID>          # Why was this decision made?

Configuration

Config: ~/.config/sbh/config.toml | Env: SBH_ prefix | Fallback: /etc/sbh/config.toml

sbh config show                # Current values
sbh config validate            # Check constraints
sbh config set KEY VALUE       # Change a value
sbh tune --apply --yes         # Auto-tune for this system

Anti-Patterns

Don't	Do Instead
Ballast on `/tmp`	`paths.ballast_dir` on same mount as pressure source
Daemon as root, CLI as user	`--user` scope — avoids state file permission mismatch
Skip pre-build check	`sbh check --need 10G` in CI/hook
Delete `.sbh-protect` by hand	`sbh unprotect /path`
Wait for Red to act	Act at Yellow — agent swarms escalate fast
`min_file_age_minutes = 0`	Keep >= 5 to protect in-flight writes

Docs

Full documentation: https://github.com/Dicklesworthstone/storage_ballast_helper

---name: sbhdescription: Disk-pressure defense for AI coding workloads. Use when: disk full, low space, ballast, cleanup, scan artifacts, emergency, sbh daemon, sbh status.---# SBH — Storage Ballast HelperPrevents disk-full disasters via ballast files, artifact scanning, and predictive pressure monitoring. Three-pronged: ballast (instant space), scanner (stale artifacts), special locations (/tmp, /dev/shm, swap).## Quick Check```bashsbh status # Pressure level + free spacesbh status --json | jq '.pressure' # Machine-parseablesbh check --need 5G # "Do I have 5 GB free?"sbh check --predict 30 # "Will I run out in 30 min?"```Exit codes: 0 = healthy, 1 = pressure, 2 = error.---## Daemon```bashsbh daemon # Foreground (debugging)systemctl --user start sbh # Systemd user scopesbh install --systemd --user --auto # Install + start (Linux)sbh install --launchd --auto # Install + start (macOS)sbh install --wizard # Guided interactive setup```**Signals:** `SIGHUP` = reload config, `SIGUSR1` = force scan now, `SIGTERM` = graceful stop.---## BallastPre-allocated sacrificial files — released in milliseconds, no scanning needed.```bashsbh ballast status # Per-volume inventorysbh ballast provision # Create/rebuild poolsbh ballast release 3 # Free 3 files NOWsbh ballast replenish # Rebuild after pressure passes```Defaults: 10 x 1 GiB = 10 GiB. Ensure ballast dir is on **same mount** as pressure source.---## Scanning & Cleanup```bashsbh scan /data/projects --top 20 # Rank artifacts by scoresbh clean /data/projects --dry-run # Preview what would gosbh clean --target-free 50G --yes # Delete until 50 GB free```Scoring: Location (.25) + Name (.25) + Age (.20) + Size (.15) + Structure (.15) = 1.0.---## Protection```bashsbh protect /path # .sbh-protect marker (subtree)sbh unprotect /path # Remove marker```Config globs: `scanner.protected_paths`. Hard vetoes (always enforced): `.git/` dirs, open files, age < 10 min, non-writable parents.---## Emergency RecoveryZero-write mode for near-100% full disks. No config file needed.```bashsbh emergency /data --yes # Aggressive cleanup NOWsbh emergency --target-free 10G # Stop at 10 GB recovered```---## Observability```bashsbh dashboard # TUI: 7 screens (1-7 to jump)sbh stats --window 24h # Activity over last 24 hourssbh blame --top 10 # Top 10 pressure sourcessbh explain --id <ID> # Why was this decision made?```---## ConfigurationConfig: `~/.config/sbh/config.toml` | Env: `SBH_` prefix | Fallback: `/etc/sbh/config.toml````bashsbh config show # Current valuessbh config validate # Check constraintssbh config set KEY VALUE # Change a valuesbh tune --apply --yes # Auto-tune for this system```---## Anti-Patterns| Don't | Do Instead ||-------|------------|| Ballast on `/tmp` | `paths.ballast_dir` on same mount as pressure source || Daemon as root, CLI as user | `--user` scope — avoids state file permission mismatch || Skip pre-build check | `sbh check --need 10G` in CI/hook || Delete `.sbh-protect` by hand | `sbh unprotect /path` || Wait for Red to act | Act at Yellow — agent swarms escalate fast || `min_file_age_minutes = 0` | Keep >= 5 to protect in-flight writes |---## DocsFull documentation: https://github.com/Dicklesworthstone/storage_ballast_helper

Frequently asked questions

Sbh