rjv-agent-browser-noteslisted
Install: claude install-skill rjvim/ai-skills
# agent-browser — what the vendor skill leaves out
The vendor skill (`agent-browser skills get core`) is the reference: refs, commands,
troubleshooting for stale refs, overlay-covered clicks, key-event interception. **Read it first.**
These are the failures it does not name. Every one below cost a real debugging session, and two of
them produced *false bug reports* against the application before being understood.
## 0. RULE ZERO — a dead session lies to you
**Before concluding anything about the app, prove input still reaches the page.**
A session can reach a state where every command returns `✓ Done`, `snapshot` and `eval` keep
working, and **no real input lands**. Clicks do nothing. Hover fires nothing. Radix exit
animations never run, so closed dialog overlays never unmount and then block everything else.
`agent-browser doctor` does **not** catch this — it checks the daemon and pid, and happily prints
`pass Session <name> (pid …)` while the page is dead.
```bash
# is the session alive? empty output = dead.
agent-browser eval '(()=>{window.__s=[];["pointermove","pointerover"].forEach(n=>document.addEventListener(n,e=>window.__s.push(n),true));return "ok"})()'
agent-browser mouse move 500 400; sleep 1; agent-browser mouse move 520 420; sleep 1
agent-browser eval '(()=>JSON.stringify(window.__s.slice(0,3)))()'
# ["pointerover","pointermove","pointermove"] → alive
# [] → dead: close and reopen, then log back in
```
Fix is alwa