Skip to main content
ClaudeWave
Skill434 repo starsupdated today

sbh

SBH (Storage Ballast Helper) is a disk space management tool that prevents storage exhaustion through pre-allocated ballast files, artifact scanning and cleanup, and predictive pressure monitoring. Use it to monitor free disk space, automatically release reserved capacity when thresholds are breached, identify and remove stale artifacts by configurable scoring, and run as a daemon for continuous protection across mounted volumes.

Install in Claude Code
Copy
git clone --depth 1 https://github.com/boshu2/agentops /tmp/sbh && cp -r /tmp/sbh/images/gemini/skills/sbh ~/.claude/skills/sbh
Then start a new Claude Code session; the skill loads automatically.

SKILL.md

# SBH — storage pressure specialist

SBH exposes disk-pressure status, ballast, scanning, and recovery commands. This
skill gathers evidence and performs at most the explicit action authorized by the
caller. Its authorized actions can delete files and change host storage
configuration, so no mutation runs without explicit caller authority. The command
surface below is anchored to `sbh` 0.4.27; re-verify against `sbh --version` on
another host before relying on an exact flag.

Evidence-first recovery works because disk pressure has cheap reversible
remedies and expensive irreversible ones; a factual baseline is what tells them
apart before anything is deleted. Order remediation by irreversibility:
status and dry runs first, ballast release next, cleanup of unprotected files
after that, and emergency deletion last — never skip forward while a more
reversible step remains untried.

Named failure mode — **wrong-mount relief**: reclaiming gigabytes on a
filesystem that is not the constrained mount and declaring the pressure
resolved.

Anti-pattern: escalating straight to `emergency --yes` because pressure is
critical. Corrective: urgency raises the stakes of an irreversible mistake; it
never lowers the authorization bar or the ordering above.

## Constraints

- Begin with `sbh --json status`, `sbh check`, or a dry run on the exact mount
  because recovery decisions need a factual baseline.
- Never run `clean --yes`, `emergency --yes`, ballast release, `tune --apply`,
  `unprotect`, or service/configuration changes without explicit authority
  because those operations mutate host state.
- Preserve `.git/`, open-file, young-file, non-writable-parent, and
  `.sbh-protect` vetoes because they prevent unsafe or ineffective cleanup.
- Confirm that ballast or reclaimed bytes affect the constrained mount because
  free space on another filesystem does not resolve the pressure.
- Run one action once, capture before/after evidence, and stop because the
  caller owns any further mutation. A negative result
  is returned to the caller; this skill does not retry or escalate it.

## Output

Return mount, free bytes, pressure state, dry-run candidates, authorization used,
exact command and exit code, bytes reclaimed, protection vetoes, and checked/not
checked surfaces.

Full command documentation: <https://github.com/Dicklesworthstone/storage_ballast_helper>