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.
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-protectvetoes 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
Source: hashgraph-online/awesome-codex-plugins → plugins/boshu2/agentops/skills-codex/sbh/SKILL.md