AgentiaPT/vela-slides / .claude/skills/burst-bug-hunter
burst-bug-hunter
VerifiedTime-boxed adversarial bug-hunting of a LIVE app driven by MULTI-STEP PLAYWRIGHT BURSTS against a persistent warm browser — not one LLM turn per CLI step. The app is opened ONCE; the agent submits full scripts that run to completion unattended (one structured result per burst); reset to a known initial state between scenarios; inherit the implementer's driver verbs instead of re-predicting selectors. Generic / repo-agnostic: all app specifics come from the repo's own config. Use when hunting bugs in a browser-drivable app under a hard wall-clock budget.
| File | Kind | Size |
|---|---|---|
| .gitignore | other | 20 B |
| SKILL.md | skill md | 5.9 KB |
| assets/driver-server.mjs | script | 20.4 KB |
| assets/example-burst.mjs | script | 1.3 KB |
| assets/start-hunt.shexecutable | script | 744 B |
| assets/test-timeout-isolation.mjs | script | 18.9 KB |
| assets/vrunexecutable | script | 2.0 KB |
assets/vrun
View on GitHub#!/usr/bin/env bash
# vrun — submit a multi-step Playwright job (burst) to the persistent warm-app server
# and block until it returns the full structured result. One call = one whole burst.
#
# vrun <job.mjs> run a job file (export async function run(page, ctx))
# vrun --reset reset app to known initial state
# vrun --shutdown stop the server
# vrun --inline 'CODE' run an inline body: `export async function run(page,ctx){ CODE }`
# vrun --finding '{json}' append one finding line to $VDRIVE/findings.jsonl (no server round-trip)
#
# Env: VDRIVE=<workdir> (default /tmp/burst-drive)
set -euo pipefail
WORK="${VDRIVE:-/tmp/burst-drive}"
INBOX="$WORK/inbox"; OUTBOX="$WORK/outbox"
mkdir -p "$INBOX" "$OUTBOX"
if [ "${1:-}" = "--finding" ]; then printf '%s\n' "$2" >> "$WORK/findings.jsonl"; echo "recorded"; exit 0; fi
id="j$(date +%s%N)"
case "${1:-}" in
--reset) id="reset-$id"; : > "$INBOX/$id.mjs" ;;
--shutdown) id="shutdown-$id"; : > "$INBOX/$id.mjs" ;;
--inline) printf 'export async function run(page, ctx){\n%s\n}\n' "$2" > "$INBOX/$id.mjs" ;;
*) [ -f "${1:-}" ] || { echo "vrun: job file not found: ${1:-}" >&2; exit 2; }
cp "$1" "$INBOX/$id.mjs" ;;
esac
# Client wait is bounded to a few seconds over the server's job cap (VRUN_WAIT, default
# 15s). The server ALWAYS writes a result within its JOB_TIMEOUT_MS (~8s) even for a
# hung burst, so THIS job's own call never blocks longer than this. A job queued right
# behind one that just timed out may also wait on the server's bounded recovery budget
# (recoverBudgetMs, default 5s) — repo configs must keep jobTimeoutMs + recoverBudgetMs
# comfortably under VRUN_WAIT. Never 180s.
WAIT_ITERS=$(( ${VRUN_WAIT:-15} * 5 ))
for _ in $(seq 1 "$WAIT_ITERS"); do
if [ -f "$OUTBOX/$id.json" ]; then cat "$OUTBOX/$id.json"; rm -f "$OUTBOX/$id.json"; exit 0; fi
sleep 0.2
done
echo '{"ok":false,"error":"vrun: no server result within '"${VRUN_WAIT:-15}"'s (server down or overloaded)"}' >&2; exit 1
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the work | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation code | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy. | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |