rig-check

star 0

System-domain health snapshot of the fuzz rig — host memory/disk/swap, systemd unit state, worker counts with uptime, OOM-kill events from dmesg, watchdog respawn rate, spurious kernel signals. Orthogonal to $check-in (which only covers fuzz-domain state). Use when the operator asks about VM/host health, OOM investigation, why workers keep dying, or invokes $rig-check. Equivalent of /rig-check in Claude Code.

sandbornm By sandbornm schedule Updated 4/23/2026

name: rig-check description: System-domain health snapshot of the fuzz rig — host memory/disk/swap, systemd unit state, worker counts with uptime, OOM-kill events from dmesg, watchdog respawn rate, spurious kernel signals. Orthogonal to $check-in (which only covers fuzz-domain state). Use when the operator asks about VM/host health, OOM investigation, why workers keep dying, or invokes $rig-check. Equivalent of /rig-check in Claude Code.

Run the shared rig-check.sh. It auto-detects host:

  • Mac / Linux host with orb → proxies commands through orb -m fuzzer
  • Inside the fuzzing VM / host → runs commands directly
bash "$(git rev-parse --show-toplevel 2>/dev/null || echo .)/shared/rig-check.sh"

After the output prints, summarize anything flagged with [!]:

  • Available memory < 512 MiB — under pressure; check afl-tmin or concurrent ASAN children.
  • Disk free < 5 GB — archive findings/ or extend storage.
  • Systemd service inactive — report which unit, suggest systemctl --user start ….
  • OOM-kill count ≥ 5 — categorize victims:
    • total-vm ≈ 38 TB = ASAN child (unavoidable; ASAN shadow needs unbounded virtual). Expected noise.
    • total-vm few GB = fast-build child that escaped -m 1024 — check if afl-tmin is invoked with the right flag.
  • Watchdog respawns > 10/hr — flap loop; drill into which role dies.
  • Spurious kernel signals — non-fuzzer-child SIGSEGV / GPF; surface the listed process.

If nothing is flagged, report "rig healthy" — don't manufacture follow-ups.

Install via CLI
npx skills add https://github.com/sandbornm/fuzzah --skill rig-check
Repository Details
star Stars 0
call_split Forks 0
navigation Branch main
article Path SKILL.md
More from Creator