fix .agent commits

interactive-browser/SKILL.md

@@ -255,6 +255,7 @@ done
 - **Secrets** — when possible, ask the user to type passwords themselves in the visible window rather than passing them through chat/commands
 - **Screenshots are saved** to the temp directory with timestamps — you can review them later
 - **Interaction timeouts are 8s** — failures return a JSON error fast; check the error's `details` for Playwright's call log
+- **Trust the screenshot image, not a timing theory.** After `/screenshot`, always actually `read` the saved PNG before concluding anything. Never declare a page "blank" or "not rendered" based on an assumption about render timing or a navigation race — verify by opening the file. If it looks blank, re-capture once; if it still looks blank, run `evaluate` on `document.body.scrollHeight` to confirm rather than assuming. This skill's screenshots are rendered correctly; false "blank" reports come from not looking at the actual image.
 - **Always close the browser** when done to free resources
 - **The server stays running** until explicitly closed — you can launch, do other work, then come back and continue interacting
 
@@ -269,6 +270,7 @@ done
 | Click succeeds but nothing happens | Element is covered or JS-gated | Retry with `force=true`, then screenshot to verify |
 | `Missing required parameter: X` | Param in URL but not decoded properly | Move it to the body with `--data-urlencode "X=..."` |
 | Stale page content after navigation | Page still loading / lazy content | `reload`, or scroll before extracting |
+| Screenshot looks blank (but page is fine) | Agent assumed a render race without reading the image | `read` the actual PNG; re-capture once; check `document.body.scrollHeight` — don't assume blank |
 | Server port busy | Old server instance | `kill $(lsof -ti:9876)` before starting |
 
 ## Example Session