diff --git a/browse/SKILL.md b/browse/SKILL.md index 5044f5179..5e06c5b39 100644 --- a/browse/SKILL.md +++ b/browse/SKILL.md @@ -619,6 +619,18 @@ $B screenshot /tmp/bug.png # plain screenshot $B console # error log ``` +Two behaviors that silently invalidate screenshots (#2445 — designed, but +surprising): +- **`hover` scrolls its target into view.** Hovering anything below the fold + scrolls the page first, so a "rest state" shot taken afterwards captures + the wrong section with exit 0. Before a rest-state screenshot, hover only + something already visible, and assert position when it matters: + `$B js "window.scrollY"` should be `0` (or your intended offset). +- **The tab persists across sessions.** The daemon keeps its tab between your + sessions, so `reload` or `screenshot` without a preceding `goto` can act on + whatever page earlier work left open. Start verification passes with an + explicit `$B goto `, never a bare `reload`. + ### 5. Find all clickable elements (including non-ARIA) ```bash $B snapshot -C # finds divs with cursor:pointer, onclick, tabindex diff --git a/browse/SKILL.md.tmpl b/browse/SKILL.md.tmpl index 1da7698b2..81a91775e 100644 --- a/browse/SKILL.md.tmpl +++ b/browse/SKILL.md.tmpl @@ -65,6 +65,18 @@ $B screenshot /tmp/bug.png # plain screenshot $B console # error log ``` +Two behaviors that silently invalidate screenshots (#2445 — designed, but +surprising): +- **`hover` scrolls its target into view.** Hovering anything below the fold + scrolls the page first, so a "rest state" shot taken afterwards captures + the wrong section with exit 0. Before a rest-state screenshot, hover only + something already visible, and assert position when it matters: + `$B js "window.scrollY"` should be `0` (or your intended offset). +- **The tab persists across sessions.** The daemon keeps its tab between your + sessions, so `reload` or `screenshot` without a preceding `goto` can act on + whatever page earlier work left open. Start verification passes with an + explicit `$B goto `, never a bare `reload`. + ### 5. Find all clickable elements (including non-ARIA) ```bash $B snapshot -C # finds divs with cursor:pointer, onclick, tabindex