Skip to content

The agent that grows with you

docs(skills): rewrite bundled skills from built-in browser_* tools to browser_exec

Tekniumad5e44daa2df
diff --git a/skills/autonomous-ai-agents/computer-use/SKILL.md b/skills/autonomous-ai-agents/computer-use/SKILL.md
index 7e891d38498..798b72cb09a 100644
--- a/skills/autonomous-ai-agents/computer-use/SKILL.md
+++ b/skills/autonomous-ai-agents/computer-use/SKILL.md
@@ -192,9 +192,8 @@ inferring support from the executable's reported version.
`computer_use` is desktop-only: it does not expose a typed route for browser
page content (no `cua_browser_*` actions). For reading or acting on a page's
DOM — navigation, clicking a link by text, typed input into a form field —
-use the separate `browser_navigate`/`browser_click`/`browser_type`/`browser_snapshot`
-tools (or `browser_exec` when the Browser Use CLI backend is active); their
-own schemas document the current contract. Reserve `computer_use` for browser
+use the separate `browser_exec` tool (Python CDP helpers driving a headless
+Chromium); its own schema documents the current contract. Reserve `computer_use` for browser
*chrome* (the address bar, permission prompts, extension popups, native
dialogs) and anything else on screen that isn't page content.
@@ -312,7 +311,7 @@ in your conversation context.
## When NOT to use `computer_use`
-- **Web automation you can do via separate headless `browser_*` tools** — those use a
+- **Web automation you can do via the separate headless `browser_exec` tool** — it drives a
real headless Chromium and are more reliable than driving the user's
GUI browser. Reach for `computer_use` specifically when the task
needs the user's actual native apps (Finder/Explorer/Files, Mail/
diff --git a/skills/autonomous-ai-agents/hermes-agent/references/configuration.md b/skills/autonomous-ai-agents/hermes-agent/references/configuration.md
index 76ca658a8f2..599ff4e3394 100644
--- a/skills/autonomous-ai-agents/hermes-agent/references/configuration.md
+++ b/skills/autonomous-ai-agents/hermes-agent/references/configuration.md
@@ -17,6 +17,7 @@ Full reference: https://hermes-agent.nousresearch.com/docs/user-guide/configurat
| `tts` | `provider` (edge/elevenlabs/openai/minimax/mistral/neutts/gemini/piper/kittentts/deepinfra/xai) |
| `memory` | `memory_enabled`, `user_profile_enabled`, `provider`, `write_approval` |
| `security` | `redact_secrets`, `website_blocklist` |
+| `browser` | `headed` (false), `engine` (auto/lightpanda), `executable_path` ("" = auto-detect Chromium), `user_data_dir` ("" = fresh ephemeral profile per session), `chromium_args` ([]), `command_timeout` (Chromium launch timeout floor), `cloud_provider`, `cdp_url`, `use_real_profile` |
| `delegation` | `model`, `provider`, `max_concurrent_children`, `max_iterations` (50), `max_spawn_depth` |
| `checkpoints` | `enabled`, `max_snapshots` (50) |
| `curator` | `enabled`, `consolidate` (false, opt-in aux-model consolidation), `interval_hours`, `stale_after_days` |
@@ -31,7 +32,7 @@ Full enumeration: `TOOLSETS` dict in `toolsets.py` (`_HERMES_CORE_TOOLS` is the
| Toolset | What it provides |
|---------|-----------------|
| `web` / `search` | Web search + extraction / search-only subset |
-| `browser` | Browser automation (Browserbase, Camofox, or local Chromium) |
+| `browser` | `browser_exec` (Python CDP helpers), `browser_cdp`, `browser_dialog`, `browser_vault` — local Chromium, a cloud provider, or `/browser connect`. Disable this toolset to turn browsing off |
| `terminal` | Shell commands and process management |
| `file` | File read/write/search/patch |
| `code_execution` | Sandboxed Python execution |
@@ -56,6 +57,8 @@ Full enumeration: `TOOLSETS` dict in `toolsets.py` (`_HERMES_CORE_TOOLS` is the
| `safe` | Minimal low-risk toolset for locked-down sessions |
| `discord`, `discord_admin`, `feishu_doc`, `feishu_drive`, `yuanbao` | Service integrations (gated on their credentials). `homeassistant` (`ha_*` tools) and `spotify` (`spotify_*` tools) are not built in: they come from the `homeassistant` / `spotify` catalog plugins (`hermes plugins install <name>`) |
+Camofox is no longer built in: `hermes plugins install camofox` adds it as the `camofox` toolset with its own browser tools. Existing Camofox setups are migrated automatically on `hermes update`.
+
Tool changes take effect on `/reset` (new session) — never mid-conversation, to preserve prompt caching.
## Voice
diff --git a/skills/creative/popular-web-designs/SKILL.md b/skills/creative/popular-web-designs/SKILL.md
index 9792a4e3779..8b569397f57 100644
--- a/skills/creative/popular-web-designs/SKILL.md
+++ b/skills/creative/popular-web-designs/SKILL.md
@@ -44,7 +44,7 @@ system, shadows, responsive behavior, and practical agent prompts with exact CSS
Each template includes a **Hermes Implementation Notes** block at the top with:
- CDN font substitute and Google Fonts `<link>` tag (ready to paste)
- CSS font-family stacks for primary and monospace
-- Reminders to use `write_file` for HTML creation and `browser_vision` for verification
+- Reminders to use `write_file` for HTML creation and `browser_exec` (`capture_screenshot()`) for verification
## HTML Generation Pattern
@@ -83,7 +83,7 @@ Each template includes a **Hermes Implementation Notes** block at the top with:
```
Write the file with `write_file`, serve with the `generative-widgets` workflow (cloudflared tunnel),
-and verify the result with `browser_vision` to confirm visual accuracy.
+and verify the result with `browser_exec`: open the page, `capture_screenshot()`, and inspect the image to confirm visual accuracy.
## Font Substitution Reference
diff --git a/skills/creative/popular-web-designs/templates/airbnb.md b/skills/creative/popular-web-designs/templates/airbnb.md
index fb233553208..9ef4c8feb6e 100644
--- a/skills/creative/popular-web-designs/templates/airbnb.md
+++ b/skills/creative/popular-web-designs/templates/airbnb.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/airtable.md b/skills/creative/popular-web-designs/templates/airtable.md
index 1807f7ea846..aeb26a743b5 100644
--- a/skills/creative/popular-web-designs/templates/airtable.md
+++ b/skills/creative/popular-web-designs/templates/airtable.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/apple.md b/skills/creative/popular-web-designs/templates/apple.md
index c8c7cef6479..8791b57e31b 100644
--- a/skills/creative/popular-web-designs/templates/apple.md
+++ b/skills/creative/popular-web-designs/templates/apple.md
@@ -11,7 +11,7 @@
> <!-- No CDN needed — uses system fonts -->
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/bmw.md b/skills/creative/popular-web-designs/templates/bmw.md
index 0b8dab2b3ef..df03272cfb8 100644
--- a/skills/creative/popular-web-designs/templates/bmw.md
+++ b/skills/creative/popular-web-designs/templates/bmw.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/cal.md b/skills/creative/popular-web-designs/templates/cal.md
index e650380042a..8097d8d5ff5 100644
--- a/skills/creative/popular-web-designs/templates/cal.md
+++ b/skills/creative/popular-web-designs/templates/cal.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Roboto+Mono:wght@400;500;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/claude.md b/skills/creative/popular-web-designs/templates/claude.md
index 9e1414827ba..6912234c4bc 100644
--- a/skills/creative/popular-web-designs/templates/claude.md
+++ b/skills/creative/popular-web-designs/templates/claude.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/clay.md b/skills/creative/popular-web-designs/templates/clay.md
index 30038b56eb6..58fef11976b 100644
--- a/skills/creative/popular-web-designs/templates/clay.md
+++ b/skills/creative/popular-web-designs/templates/clay.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/clickhouse.md b/skills/creative/popular-web-designs/templates/clickhouse.md
index 67dc1ed22a6..9b192f6cdb7 100644
--- a/skills/creative/popular-web-designs/templates/clickhouse.md
+++ b/skills/creative/popular-web-designs/templates/clickhouse.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/cohere.md b/skills/creative/popular-web-designs/templates/cohere.md
index d43a012e256..dfe4e9b172d 100644
--- a/skills/creative/popular-web-designs/templates/cohere.md
+++ b/skills/creative/popular-web-designs/templates/cohere.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/coinbase.md b/skills/creative/popular-web-designs/templates/coinbase.md
index 45d3803b015..dd8bc7c3d58 100644
--- a/skills/creative/popular-web-designs/templates/coinbase.md
+++ b/skills/creative/popular-web-designs/templates/coinbase.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/composio.md b/skills/creative/popular-web-designs/templates/composio.md
index 2a9e09db1c3..4e8acdcf1d0 100644
--- a/skills/creative/popular-web-designs/templates/composio.md
+++ b/skills/creative/popular-web-designs/templates/composio.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/cursor.md b/skills/creative/popular-web-designs/templates/cursor.md
index b51600775d6..fc5fccad644 100644
--- a/skills/creative/popular-web-designs/templates/cursor.md
+++ b/skills/creative/popular-web-designs/templates/cursor.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/elevenlabs.md b/skills/creative/popular-web-designs/templates/elevenlabs.md
index 2a7fd35e227..584d9b9d75f 100644
--- a/skills/creative/popular-web-designs/templates/elevenlabs.md
+++ b/skills/creative/popular-web-designs/templates/elevenlabs.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/expo.md b/skills/creative/popular-web-designs/templates/expo.md
index 9fa2b825815..2e541d44ee9 100644
--- a/skills/creative/popular-web-designs/templates/expo.md
+++ b/skills/creative/popular-web-designs/templates/expo.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/figma.md b/skills/creative/popular-web-designs/templates/figma.md
index 0a1437981d3..d95a8a28397 100644
--- a/skills/creative/popular-web-designs/templates/figma.md
+++ b/skills/creative/popular-web-designs/templates/figma.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/framer.md b/skills/creative/popular-web-designs/templates/framer.md
index cbef2b6eb92..70de4b49b53 100644
--- a/skills/creative/popular-web-designs/templates/framer.md
+++ b/skills/creative/popular-web-designs/templates/framer.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Azeret+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/hashicorp.md b/skills/creative/popular-web-designs/templates/hashicorp.md
index 8b9e5533fd7..ee28dcc9594 100644
--- a/skills/creative/popular-web-designs/templates/hashicorp.md
+++ b/skills/creative/popular-web-designs/templates/hashicorp.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/ibm.md b/skills/creative/popular-web-designs/templates/ibm.md
index c2f62530a07..a21c938416c 100644
--- a/skills/creative/popular-web-designs/templates/ibm.md
+++ b/skills/creative/popular-web-designs/templates/ibm.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=IBM+Plex+Mono:wght@400;500;600&family=IBM+Plex+Sans:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/intercom.md b/skills/creative/popular-web-designs/templates/intercom.md
index 9293886e789..34539701608 100644
--- a/skills/creative/popular-web-designs/templates/intercom.md
+++ b/skills/creative/popular-web-designs/templates/intercom.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/kraken.md b/skills/creative/popular-web-designs/templates/kraken.md
index 875f5617f28..880516d356a 100644
--- a/skills/creative/popular-web-designs/templates/kraken.md
+++ b/skills/creative/popular-web-designs/templates/kraken.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/linear.app.md b/skills/creative/popular-web-designs/templates/linear.app.md
index f87e8eb0b55..7b7f3c43eac 100644
--- a/skills/creative/popular-web-designs/templates/linear.app.md
+++ b/skills/creative/popular-web-designs/templates/linear.app.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/lovable.md b/skills/creative/popular-web-designs/templates/lovable.md
index c9afddd23ff..dad42d01b2e 100644
--- a/skills/creative/popular-web-designs/templates/lovable.md
+++ b/skills/creative/popular-web-designs/templates/lovable.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/minimax.md b/skills/creative/popular-web-designs/templates/minimax.md
index 77c89ed0f2f..d01e28eff5d 100644
--- a/skills/creative/popular-web-designs/templates/minimax.md
+++ b/skills/creative/popular-web-designs/templates/minimax.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/mintlify.md b/skills/creative/popular-web-designs/templates/mintlify.md
index 5ea730d29d1..59460076f0b 100644
--- a/skills/creative/popular-web-designs/templates/mintlify.md
+++ b/skills/creative/popular-web-designs/templates/mintlify.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/miro.md b/skills/creative/popular-web-designs/templates/miro.md
index 4b3b86d6940..ec4d8eb7e5a 100644
--- a/skills/creative/popular-web-designs/templates/miro.md
+++ b/skills/creative/popular-web-designs/templates/miro.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/mistral.ai.md b/skills/creative/popular-web-designs/templates/mistral.ai.md
index 122da4a4877..ab56f016cb0 100644
--- a/skills/creative/popular-web-designs/templates/mistral.ai.md
+++ b/skills/creative/popular-web-designs/templates/mistral.ai.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/mongodb.md b/skills/creative/popular-web-designs/templates/mongodb.md
index ec230ed24d6..be6de0425d9 100644
--- a/skills/creative/popular-web-designs/templates/mongodb.md
+++ b/skills/creative/popular-web-designs/templates/mongodb.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Source+Code+Pro:wght@400;500;600&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/notion.md b/skills/creative/popular-web-designs/templates/notion.md
index 627fe67743a..7ef6acf268c 100644
--- a/skills/creative/popular-web-designs/templates/notion.md
+++ b/skills/creative/popular-web-designs/templates/notion.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/nvidia.md b/skills/creative/popular-web-designs/templates/nvidia.md
index 848038f6022..70f0d7ba723 100644
--- a/skills/creative/popular-web-designs/templates/nvidia.md
+++ b/skills/creative/popular-web-designs/templates/nvidia.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/ollama.md b/skills/creative/popular-web-designs/templates/ollama.md
index 8e516db58b8..f8611adc332 100644
--- a/skills/creative/popular-web-designs/templates/ollama.md
+++ b/skills/creative/popular-web-designs/templates/ollama.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/opencode.ai.md b/skills/creative/popular-web-designs/templates/opencode.ai.md
index 445b699d63e..7df04b59901 100644
--- a/skills/creative/popular-web-designs/templates/opencode.ai.md
+++ b/skills/creative/popular-web-designs/templates/opencode.ai.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/pinterest.md b/skills/creative/popular-web-designs/templates/pinterest.md
index bcddf7e2d23..8a0e7fdd24c 100644
--- a/skills/creative/popular-web-designs/templates/pinterest.md
+++ b/skills/creative/popular-web-designs/templates/pinterest.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/posthog.md b/skills/creative/popular-web-designs/templates/posthog.md
index 16498375ff3..dfe08b9ea28 100644
--- a/skills/creative/popular-web-designs/templates/posthog.md
+++ b/skills/creative/popular-web-designs/templates/posthog.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/raycast.md b/skills/creative/popular-web-designs/templates/raycast.md
index f55e41d5d30..38bf8374f81 100644
--- a/skills/creative/popular-web-designs/templates/raycast.md
+++ b/skills/creative/popular-web-designs/templates/raycast.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/replicate.md b/skills/creative/popular-web-designs/templates/replicate.md
index e59f1565083..5530800cae1 100644
--- a/skills/creative/popular-web-designs/templates/replicate.md
+++ b/skills/creative/popular-web-designs/templates/replicate.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/resend.md b/skills/creative/popular-web-designs/templates/resend.md
index cdae528799d..6f44e28add8 100644
--- a/skills/creative/popular-web-designs/templates/resend.md
+++ b/skills/creative/popular-web-designs/templates/resend.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/revolut.md b/skills/creative/popular-web-designs/templates/revolut.md
index 685fe4016fb..a8d47ea91cf 100644
--- a/skills/creative/popular-web-designs/templates/revolut.md
+++ b/skills/creative/popular-web-designs/templates/revolut.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/runwayml.md b/skills/creative/popular-web-designs/templates/runwayml.md
index cbd2b1eac3a..c06c43099d7 100644
--- a/skills/creative/popular-web-designs/templates/runwayml.md
+++ b/skills/creative/popular-web-designs/templates/runwayml.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/sanity.md b/skills/creative/popular-web-designs/templates/sanity.md
index 31c67da93b5..cfa5ca9a6fa 100644
--- a/skills/creative/popular-web-designs/templates/sanity.md
+++ b/skills/creative/popular-web-designs/templates/sanity.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Space+Grotesk:wght@300;400;500;600;700&family=IBM+Plex+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/sentry.md b/skills/creative/popular-web-designs/templates/sentry.md
index 113ff3f1d19..fdba17e6e3b 100644
--- a/skills/creative/popular-web-designs/templates/sentry.md
+++ b/skills/creative/popular-web-designs/templates/sentry.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Rubik:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/spacex.md b/skills/creative/popular-web-designs/templates/spacex.md
index 4d62bf6a4fa..7f31ac31204 100644
--- a/skills/creative/popular-web-designs/templates/spacex.md
+++ b/skills/creative/popular-web-designs/templates/spacex.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/spotify.md b/skills/creative/popular-web-designs/templates/spotify.md
index 7cfa4547b94..c9a3172cb63 100644
--- a/skills/creative/popular-web-designs/templates/spotify.md
+++ b/skills/creative/popular-web-designs/templates/spotify.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/stripe.md b/skills/creative/popular-web-designs/templates/stripe.md
index 12296387091..3bba763778c 100644
--- a/skills/creative/popular-web-designs/templates/stripe.md
+++ b/skills/creative/popular-web-designs/templates/stripe.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Source+Sans+3:wght@300;400;500;600&family=Source+Code+Pro:wght@400;500;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/supabase.md b/skills/creative/popular-web-designs/templates/supabase.md
index 5e697b3647b..5e20e5bb617 100644
--- a/skills/creative/popular-web-designs/templates/supabase.md
+++ b/skills/creative/popular-web-designs/templates/supabase.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=Source+Code+Pro:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/superhuman.md b/skills/creative/popular-web-designs/templates/superhuman.md
index b3c4c318ee9..1f08e0db366 100644
--- a/skills/creative/popular-web-designs/templates/superhuman.md
+++ b/skills/creative/popular-web-designs/templates/superhuman.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/together.ai.md b/skills/creative/popular-web-designs/templates/together.ai.md
index 581f592e4f1..afe92d07416 100644
--- a/skills/creative/popular-web-designs/templates/together.ai.md
+++ b/skills/creative/popular-web-designs/templates/together.ai.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/uber.md b/skills/creative/popular-web-designs/templates/uber.md
index bdd4d3f898d..c7b4b7e5c23 100644
--- a/skills/creative/popular-web-designs/templates/uber.md
+++ b/skills/creative/popular-web-designs/templates/uber.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=DM+Sans:ital,opsz,wght@0,9..40,100..1000;1,9..40,100..1000&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/vercel.md b/skills/creative/popular-web-designs/templates/vercel.md
index 7ecd1449d92..0c0695b77bc 100644
--- a/skills/creative/popular-web-designs/templates/vercel.md
+++ b/skills/creative/popular-web-designs/templates/vercel.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/voltagent.md b/skills/creative/popular-web-designs/templates/voltagent.md
index d8623bd605d..49c144acb4e 100644
--- a/skills/creative/popular-web-designs/templates/voltagent.md
+++ b/skills/creative/popular-web-designs/templates/voltagent.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=JetBrains+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/warp.md b/skills/creative/popular-web-designs/templates/warp.md
index 08e8fa6a19c..bc083382855 100644
--- a/skills/creative/popular-web-designs/templates/warp.md
+++ b/skills/creative/popular-web-designs/templates/warp.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Geist:wght@300;400;500;600&family=Geist+Mono:wght@400;500&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/webflow.md b/skills/creative/popular-web-designs/templates/webflow.md
index db80ddc42f0..5b4e4b1dbcb 100644
--- a/skills/creative/popular-web-designs/templates/webflow.md
+++ b/skills/creative/popular-web-designs/templates/webflow.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/wise.md b/skills/creative/popular-web-designs/templates/wise.md
index 1f0a9494b34..7bd897ebcfd 100644
--- a/skills/creative/popular-web-designs/templates/wise.md
+++ b/skills/creative/popular-web-designs/templates/wise.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/x.ai.md b/skills/creative/popular-web-designs/templates/x.ai.md
index c22ac1e2c0d..79190c06e7d 100644
--- a/skills/creative/popular-web-designs/templates/x.ai.md
+++ b/skills/creative/popular-web-designs/templates/x.ai.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Geist+Mono:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/creative/popular-web-designs/templates/zapier.md b/skills/creative/popular-web-designs/templates/zapier.md
index f728c78a9e5..eb75f9c3bea 100644
--- a/skills/creative/popular-web-designs/templates/zapier.md
+++ b/skills/creative/popular-web-designs/templates/zapier.md
@@ -11,7 +11,7 @@
> <link href="https://fonts.googleapis.com/css2?family=Inter:wght@300;400;500;600;700&display=swap" rel="stylesheet">
> ```
> Use `write_file` to create HTML, serve via `generative-widgets` skill (cloudflared tunnel).
-> Verify visual accuracy with `browser_vision` after generating.
+> Verify visual accuracy with `browser_exec` (`capture_screenshot()`) after generating.
## 1. Visual Theme & Atmosphere
diff --git a/skills/productivity/airtable/SKILL.md b/skills/productivity/airtable/SKILL.md
index d628c231fee..a7e0d3aae33 100644
--- a/skills/productivity/airtable/SKILL.md
+++ b/skills/productivity/airtable/SKILL.md
@@ -221,7 +221,7 @@ done
## Important Notes for Hermes
-- **Always use the `terminal` tool with `curl`.** Do NOT use `web_extract` (it can't send auth headers) or `browser_navigate` (needs UI auth and is slow).
+- **Always use the `terminal` tool with `curl`.** Do NOT use `web_extract` (it can't send auth headers) or `browser_exec` (needs UI auth and is slow).
- **`AIRTABLE_API_KEY` flows from `${HERMES_HOME:-~/.hermes}/.env` into the subprocess automatically** when this skill is loaded — no need to re-export it before each `curl` call.
- **Escape curly braces in formulas carefully.** In a heredoc body, `{Status}` is literal. In a shell argument, `{Status}` is safe outside `{...}` brace-expansion context — but pass dynamic strings through `python urllib.parse.quote` before splicing into a URL.
- **Pretty-print with `python -m json.tool`** (always present) rather than `jq` (optional). Only reach for `jq` when you need filtering/projection.
diff --git a/skills/productivity/product-price-monitor/SKILL.md b/skills/productivity/product-price-monitor/SKILL.md
index 169e4dee565..e689351dd86 100644
--- a/skills/productivity/product-price-monitor/SKILL.md
+++ b/skills/productivity/product-price-monitor/SKILL.md
@@ -37,7 +37,7 @@ Specify currency, all-in vs pre-tax price, maximum price, availability/stock rul
### 3. Establish a live baseline, then schedule
-Fetch a bounded live result with `web_extract` or `browser_navigate` and record retrieval time, source price, fees/taxes, availability, and terms. Do not schedule until one foreground fetch works. Write the watch contract (item, condition, baseline observation) to a state file under `~/.hermes/price-watches/<watch-slug>.json`, then create the job:
+Fetch a bounded live result with `web_extract` or `browser_exec` and record retrieval time, source price, fees/taxes, availability, and terms. Do not schedule until one foreground fetch works. Write the watch contract (item, condition, baseline observation) to a state file under `~/.hermes/price-watches/<watch-slug>.json`, then create the job:
```
cronjob(action="create",
diff --git a/skills/research/grounded-citations/SKILL.md b/skills/research/grounded-citations/SKILL.md
index 97c4bce6639..558e2fcf037 100644
--- a/skills/research/grounded-citations/SKILL.md
+++ b/skills/research/grounded-citations/SKILL.md
@@ -48,7 +48,7 @@ Mention a URL only if the user would plausibly want the link.
None beyond the standard toolset. `scripts/sources.py` is stdlib-only Python 3.
Retrieval comes from whatever is configured: `web_search`, `web_extract`,
-`browser_navigate`, or `terminal` (curl, CLIs).
+`browser_exec`, or `terminal` (curl, CLIs).
Ledger location: `$HERMES_HOME/cache/citations/ledger.json` (profile-aware).
Override per task with `--ledger <path>` or `HERMES_CITATION_LEDGER`.
@@ -91,7 +91,7 @@ answer or document. Skip the reset when continuing work whose ids are already
in a draft — reusing the ledger keeps the numbering stable.
② **Register every source at retrieval time.** After each `web_search` /
-`web_extract` / `browser_navigate` / fetch, pass the URLs to `sources.py add`
+`web_extract` / `browser_exec` / fetch, pass the URLs to `sources.py add`
(or pipe the raw JSON through `sources.py ingest`). Do this *before* writing
prose. Registering later, from memory, is the failure mode this skill exists to
prevent.
diff --git a/skills/software-development/dogfood/SKILL.md b/skills/software-development/dogfood/SKILL.md
index a41419fe58e..3a37e6834db 100644
--- a/skills/software-development/dogfood/SKILL.md
+++ b/skills/software-development/dogfood/SKILL.md
@@ -15,11 +15,11 @@ metadata:
## Overview
-This skill guides you through systematic exploratory QA testing of web applications using the browser toolset. You will navigate the application, interact with elements, capture evidence of issues, and produce a structured bug report.
+This skill guides you through systematic exploratory QA testing of web applications with `browser_exec`. You will navigate the application, interact with elements, capture evidence of issues, and produce a structured bug report.
## Prerequisites
-- Browser toolset must be available (`browser_navigate`, `browser_snapshot`, `browser_click`, `browser_type`, `browser_vision`, `browser_console`, `browser_scroll`, `browser_back`, `browser_press`)
+- The `browser` toolset must be enabled (`browser_exec`). `browser_exec` runs Python with pre-imported helpers (`new_tab`, `goto_url`, `wait_for_load`, `page_info`, `js`, `fill_input`, `click_at_xy`, `capture_screenshot`, `cdp`); browser state persists across calls, Python variables do not.
- A target URL and testing scope from the user
## Inputs
@@ -51,52 +51,55 @@ Follow this 5-phase systematic workflow:
### Phase 2: Explore
-For each page or feature in your plan:
-
-1. **Navigate** to the page:
+Batch each step's actions into one `browser_exec` call. For each page or feature in your plan:
+
+1. **Navigate with a console hook installed.** Register the hook on the tab before navigating so errors thrown during page load are captured too:
+ ```python
+ # Open page with console-error capture
+ HOOK = """window.__qa_errors = [];
+ const _e = console.error;
+ console.error = (...a) => { window.__qa_errors.push(a.map(String).join(' ')); _e(...a); };
+ addEventListener('error', e => window.__qa_errors.push('uncaught: ' + e.message));
+ addEventListener('unhandledrejection', e => window.__qa_errors.push('rejection: ' + String(e.reason)));"""
+ new_tab('about:blank') # first call only: the hook binds to the current tab
+ cdp('Page.addScriptToEvaluateOnNewDocument', source=HOOK)
+ goto_url("https://example.com/page")
+ wait_for_load()
+ print(page_info())
+ print(js('window.__qa_errors || []'))
```
- browser_navigate(url="https://example.com/page")
+ Re-register the hook at the start of any later call that navigates. Silent JS errors are high-value findings.
+
+2. **Read the page structure** — list visible interactive elements with their viewport centres (use `cdp('Accessibility.getFullAXTree')` and filter in Python when you need roles/names):
+ ```python
+ # List interactive elements
+ print(js("""(() => [...document.querySelectorAll('a,button,input,select,textarea,[role=button]')]
+ .filter(e => e.offsetParent).slice(0, 80).map((e, i) => { const r = e.getBoundingClientRect();
+ return {i, tag: e.tagName, text: (e.innerText || e.value || e.getAttribute('aria-label') || '').trim().slice(0, 60),
+ id: e.id, name: e.name, x: Math.round(r.x + r.width / 2), y: Math.round(r.y + r.height / 2)}; }))()"""))
```
-2. **Take a snapshot** to understand the DOM structure:
- ```
- browser_snapshot()
- ```
+3. **Visually assess the page:** call `capture_screenshot()` and inspect the attached image for layout issues, broken elements, or accessibility concerns. If your model cannot view images, pass the printed path to `vision_analyze`.
-3. **Check the console** for JavaScript errors:
- ```
- browser_console(clear=true)
- ```
- Do this after every navigation and after every significant interaction. Silent JS errors are high-value findings.
-
-4. **Take an annotated screenshot** to visually assess the page and identify interactive elements:
- ```
- browser_vision(question="Describe the page layout, identify any visual issues, broken elements, or accessibility concerns", annotate=true)
- ```
- The `annotate=true` flag overlays numbered `[N]` labels on interactive elements. Each `[N]` maps to ref `@eN` for subsequent browser commands.
-
-5. **Test interactive elements** systematically:
- - Click buttons and links: `browser_click(ref="@eN")`
- - Fill forms: `browser_type(ref="@eN", text="test input")`
- - Test keyboard navigation: `browser_press(key="Tab")`, `browser_press(key="Enter")`
- - Scroll through content: `browser_scroll(direction="down")`
+4. **Test interactive elements** systematically:
+ - Click buttons and links: `js("document.querySelector('#submit').click()")`, or `click_at_xy(x, y)` with a centre from step 2
+ - Fill forms: `fill_input('input[name=email]', 'test input')`
+ - Test keyboard navigation: `cdp('Input.dispatchKeyEvent', type='keyDown', key='Tab', code='Tab', windowsVirtualKeyCode=9)` followed by the matching `keyUp`, then `js('document.activeElement.outerHTML.slice(0, 200)')` to see where focus landed; same pattern with `key='Enter'`, `code='Enter'`, `windowsVirtualKeyCode=13`
+ - Scroll through content: `js('window.scrollBy(0, 800)')`
+ - Go back: `js('history.back()')`, then `wait_for_load()`
- Test form validation with invalid inputs
- Test empty submissions
-6. **After each interaction**, check for:
- - Console errors: `browser_console()`
- - Visual changes: `browser_vision(question="What changed after the interaction?")`
- - Expected vs actual behavior
+5. **After each interaction**, in the same call, check for:
+ - Console errors: `print(js('window.__qa_errors || []'))`
+ - Visual changes: `capture_screenshot()` and compare with the previous one
+ - Expected vs actual behavior (`page_info()`, or `js()` reading the relevant element)
### Phase 3: Collect Evidence
For every issue found:
-1. **Take a screenshot** showing the issue:
- ```
- browser_vision(question="Capture and describe the issue visible on this page", annotate=false)
- ```
- Save the `screenshot_path` from the response — you will reference it in the report.
+1. **Take a screenshot** showing the issue: `capture_screenshot()` prints the saved path. Copy it to `{output_dir}/screenshots/` under a descriptive name (e.g. `issue-03-broken-login.png`) — you will reference it in the report.
2. **Record the details**:
- URL where the issue occurs
@@ -140,22 +143,26 @@ Save the report to `{output_dir}/report.md`.
## Tools Reference
-| Tool | Purpose |
+All browser actions are `browser_exec` calls; these are the helpers and idioms used above.
+
+| Action | `browser_exec` idiom |
|------|---------|
-| `browser_navigate` | Go to a URL |
-| `browser_snapshot` | Get DOM text snapshot (accessibility tree) |
-| `browser_click` | Click an element by ref (`@eN`) or text |
-| `browser_type` | Type into an input field |
-| `browser_scroll` | Scroll up/down on the page |
-| `browser_back` | Go back in browser history |
-| `browser_press` | Press a keyboard key |
-| `browser_vision` | Screenshot + AI analysis; use `annotate=true` for element labels |
-| `browser_console` | Get JS console output and errors |
+| Go to a URL | `new_tab(url)` once (or `new_tab('about:blank')` before registering the hook), then `goto_url(url)`; follow with `wait_for_load()` |
+| Page state | `page_info()` |
+| DOM / accessibility tree | `js(...)` extraction, or `cdp('Accessibility.getFullAXTree')` filtered in Python |
+| Click | `js("document.querySelector(sel).click()")` or `click_at_xy(x, y)` |
+| Type into an input | `fill_input(selector, text)` |
+| Scroll | `js('window.scrollBy(0, 800)')` |
+| Go back | `js('history.back()')` |
+| Press a key | `cdp('Input.dispatchKeyEvent', type='keyDown', key=..., code=..., windowsVirtualKeyCode=...)` + `keyUp` |
+| Screenshot | `capture_screenshot()` (image attached to the result; text-only models use `vision_analyze` on the path) |
+| JS console errors | hook via `cdp('Page.addScriptToEvaluateOnNewDocument', source=HOOK)`, read with `js('window.__qa_errors || []')` |
## Tips
-- **Always check `browser_console()` after navigating and after significant interactions.** Silent JS errors are among the most valuable findings.
-- **Use `annotate=true` with `browser_vision`** when you need to reason about interactive element positions or when the snapshot refs are unclear.
+- **Always read `window.__qa_errors` after navigating and after significant interactions.** Silent JS errors are among the most valuable findings.
+- **Batch each sub-procedure into one `browser_exec` call** (navigate, wait, extract, act, check errors) — fewer round-trips, and the hook stays in place.
+- **Take a `capture_screenshot()`** when you need to reason about element positions or when DOM extraction is ambiguous; `click_at_xy` takes the centres from the element listing.
- **Test with both valid and invalid inputs** — form validation bugs are common.
- **Scroll through long pages** — content below the fold may have rendering issues.
- **Test navigation flows** — click through multi-step processes end-to-end.
diff --git a/skills/software-development/hermes-agent-skill-authoring/SKILL.md b/skills/software-development/hermes-agent-skill-authoring/SKILL.md
index 1d39a900b37..51a4ff4ab03 100644
--- a/skills/software-development/hermes-agent-skill-authoring/SKILL.md
+++ b/skills/software-development/hermes-agent-skill-authoring/SKILL.md
@@ -129,7 +129,7 @@ Not every section applies to every skill (a pure-procedure task skill may have n
### Reference Hermes tools, not raw shell
-When the skill needs a capability, name the proper Hermes tool in backticks: `terminal`, `read_file`, `write_file`, `patch`, `search_files`, `web_search`, `web_extract`, `browser_navigate`, `vision_analyze`, `delegate_task`, `cronjob`. Do NOT name shell utilities the agent already has wrapped (`grep` → `search_files`, `cat` → `read_file`, `sed`/`awk` → `patch`, `find`/`ls` → `search_files target='files'`). A CLI-wrapper skill should frame invocations as `terminal(command="{tool} ...", timeout=...)` — bare shell prose ("run `foo --version`") is a review-blocking non-conformance. If the skill depends on an MCP server, name it and document setup in Prerequisites.
+When the skill needs a capability, name the proper Hermes tool in backticks: `terminal`, `read_file`, `write_file`, `patch`, `search_files`, `web_search`, `web_extract`, `browser_exec`, `vision_analyze`, `delegate_task`, `cronjob`. Do NOT name shell utilities the agent already has wrapped (`grep` → `search_files`, `cat` → `read_file`, `sed`/`awk` → `patch`, `find`/`ls` → `search_files target='files'`). A CLI-wrapper skill should frame invocations as `terminal(command="{tool} ...", timeout=...)` — bare shell prose ("run `foo --version`") is a review-blocking non-conformance. If the skill depends on an MCP server, name it and document setup in Prerequisites.
### Never use machine-local paths
diff --git a/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md b/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md
index b8543e43fd3..9e7c5c15c7d 100644
--- a/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md
+++ b/website/docs/user-guide/skills/bundled/autonomous-ai-agents/autonomous-ai-agents-computer-use.md
@@ -208,9 +208,8 @@ inferring support from the executable's reported version.
`computer_use` is desktop-only: it does not expose a typed route for browser
page content (no `cua_browser_*` actions). For reading or acting on a page's
DOM — navigation, clicking a link by text, typed input into a form field —
-use the separate `browser_navigate`/`browser_click`/`browser_type`/`browser_snapshot`
-tools (or `browser_exec` when the Browser Use CLI backend is active); their
-own schemas document the current contract. Reserve `computer_use` for browser
+use the separate `browser_exec` tool (Python CDP helpers driving a headless
+Chromium); its own schema documents the current contract. Reserve `computer_use` for browser
*chrome* (the address bar, permission prompts, extension popups, native
dialogs) and anything else on screen that isn't page content.
@@ -328,7 +327,7 @@ in your conversation context.
## When NOT to use `computer_use`
-- **Web automation you can do via separate headless `browser_*` tools** — those use a
+- **Web automation you can do via the separate headless `browser_exec` tool** — it drives a
real headless Chromium and are more reliable than driving the user's
GUI browser. Reach for `computer_use` specifically when the task
needs the user's actual native apps (Finder/Explorer/Files, Mail/
diff --git a/website/docs/user-guide/skills/bundled/creative/creative-popular-web-designs.md b/website/docs/user-guide/skills/bundled/creative/creative-popular-web-designs.md
index 5352e475029..81b3e487379 100644
--- a/website/docs/user-guide/skills/bundled/creative/creative-popular-web-designs.md
+++ b/website/docs/user-guide/skills/bundled/creative/creative-popular-web-designs.md
@@ -53,7 +53,7 @@ system, shadows, responsive behavior, and practical agent prompts with exact CSS
Each template includes a **Hermes Implementation Notes** block at the top with:
- CDN font substitute and Google Fonts `<link>` tag (ready to paste)
- CSS font-family stacks for primary and monospace
-- Reminders to use `write_file` for HTML creation and `browser_vision` for verification
+- Reminders to use `write_file` for HTML creation and `browser_exec` (`capture_screenshot()`) for verification
## HTML Generation Pattern
@@ -92,7 +92,7 @@ Each template includes a **Hermes Implementation Notes** block at the top with:
```
Write the file with `write_file`, serve with the `generative-widgets` workflow (cloudflared tunnel),
-and verify the result with `browser_vision` to confirm visual accuracy.
+and verify the result with `browser_exec`: open the page, `capture_screenshot()`, and inspect the image to confirm visual accuracy.
## Font Substitution Reference
diff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-airtable.md b/website/docs/user-guide/skills/bundled/productivity/productivity-airtable.md
index e0150b437cd..3166b0a6738 100644
--- a/website/docs/user-guide/skills/bundled/productivity/productivity-airtable.md
+++ b/website/docs/user-guide/skills/bundled/productivity/productivity-airtable.md
@@ -235,7 +235,7 @@ done
## Important Notes for Hermes
-- **Always use the `terminal` tool with `curl`.** Do NOT use `web_extract` (it can't send auth headers) or `browser_navigate` (needs UI auth and is slow).
+- **Always use the `terminal` tool with `curl`.** Do NOT use `web_extract` (it can't send auth headers) or `browser_exec` (needs UI auth and is slow).
- **`AIRTABLE_API_KEY` flows from `${HERMES_HOME:-~/.hermes}/.env` into the subprocess automatically** when this skill is loaded — no need to re-export it before each `curl` call.
- **Escape curly braces in formulas carefully.** In a heredoc body, `{Status}` is literal. In a shell argument, `{Status}` is safe outside `{...}` brace-expansion context — but pass dynamic strings through `python urllib.parse.quote` before splicing into a URL.
- **Pretty-print with `python -m json.tool`** (always present) rather than `jq` (optional). Only reach for `jq` when you need filtering/projection.
diff --git a/website/docs/user-guide/skills/bundled/productivity/productivity-product-price-monitor.md b/website/docs/user-guide/skills/bundled/productivity/productivity-product-price-monitor.md
index 0c84cdf645f..4c321ac9ba9 100644
--- a/website/docs/user-guide/skills/bundled/productivity/productivity-product-price-monitor.md
+++ b/website/docs/user-guide/skills/bundled/productivity/productivity-product-price-monitor.md
@@ -55,7 +55,7 @@ Specify currency, all-in vs pre-tax price, maximum price, availability/stock rul
### 3. Establish a live baseline, then schedule
-Fetch a bounded live result with `web_extract` or `browser_navigate` and record retrieval time, source price, fees/taxes, availability, and terms. Do not schedule until one foreground fetch works. Write the watch contract (item, condition, baseline observation) to a state file under `~/.hermes/price-watches/<watch-slug>.json`, then create the job:
+Fetch a bounded live result with `web_extract` or `browser_exec` and record retrieval time, source price, fees/taxes, availability, and terms. Do not schedule until one foreground fetch works. Write the watch contract (item, condition, baseline observation) to a state file under `~/.hermes/price-watches/<watch-slug>.json`, then create the job:
```
cronjob(action="create",
diff --git a/website/docs/user-guide/skills/bundled/research/research-grounded-citations.md b/website/docs/user-guide/skills/bundled/research/research-grounded-citations.md
index 0e80bac0dca..6bcfb153d7d 100644
--- a/website/docs/user-guide/skills/bundled/research/research-grounded-citations.md
+++ b/website/docs/user-guide/skills/bundled/research/research-grounded-citations.md
@@ -65,7 +65,7 @@ Mention a URL only if the user would plausibly want the link.
None beyond the standard toolset. `scripts/sources.py` is stdlib-only Python 3.
Retrieval comes from whatever is configured: `web_search`, `web_extract`,
-`browser_navigate`, or `terminal` (curl, CLIs).
+`browser_exec`, or `terminal` (curl, CLIs).
Ledger location: `$HERMES_HOME/cache/citations/ledger.json` (profile-aware).
Override per task with `--ledger <path>` or `HERMES_CITATION_LEDGER`.
@@ -108,7 +108,7 @@ answer or document. Skip the reset when continuing work whose ids are already
in a draft — reusing the ledger keeps the numbering stable.
② **Register every source at retrieval time.** After each `web_search` /
-`web_extract` / `browser_navigate` / fetch, pass the URLs to `sources.py add`
+`web_extract` / `browser_exec` / fetch, pass the URLs to `sources.py add`
(or pipe the raw JSON through `sources.py ingest`). Do this *before* writing
prose. Registering later, from memory, is the failure mode this skill exists to
prevent.
diff --git a/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md b/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md
index 953add5b009..0e00dfa16cc 100644
--- a/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md
+++ b/website/docs/user-guide/skills/bundled/software-development/software-development-dogfood.md
@@ -32,11 +32,11 @@ The following is the complete skill definition that Hermes loads when this skill
## Overview
-This skill guides you through systematic exploratory QA testing of web applications using the browser toolset. You will navigate the application, interact with elements, capture evidence of issues, and produce a structured bug report.
+This skill guides you through systematic exploratory QA testing of web applications with `browser_exec`. You will navigate the application, interact with elements, capture evidence of issues, and produce a structured bug report.
## Prerequisites
-- Browser toolset must be available (`browser_navigate`, `browser_snapshot`, `browser_click`, `browser_type`, `browser_vision`, `browser_console`, `browser_scroll`, `browser_back`, `browser_press`)
+- The `browser` toolset must be enabled (`browser_exec`). `browser_exec` runs Python with pre-imported helpers (`new_tab`, `goto_url`, `wait_for_load`, `page_info`, `js`, `fill_input`, `click_at_xy`, `capture_screenshot`, `cdp`); browser state persists across calls, Python variables do not.
- A target URL and testing scope from the user
## Inputs
@@ -70,52 +70,55 @@ Follow this 5-phase systematic workflow:
### Phase 2: Explore
-For each page or feature in your plan:
-
-1. **Navigate** to the page:
+Batch each step's actions into one `browser_exec` call. For each page or feature in your plan:
+
+1. **Navigate with a console hook installed.** Register the hook on the tab before navigating so errors thrown during page load are captured too:
+ ```python
+ # Open page with console-error capture
+ HOOK = """window.__qa_errors = [];
+ const _e = console.error;
+ console.error = (...a) => { window.__qa_errors.push(a.map(String).join(' ')); _e(...a); };
+ addEventListener('error', e => window.__qa_errors.push('uncaught: ' + e.message));
+ addEventListener('unhandledrejection', e => window.__qa_errors.push('rejection: ' + String(e.reason)));"""
+ new_tab('about:blank') # first call only: the hook binds to the current tab
+ cdp('Page.addScriptToEvaluateOnNewDocument', source=HOOK)
+ goto_url("https://example.com/page")
+ wait_for_load()
+ print(page_info())
+ print(js('window.__qa_errors || []'))
```
- browser_navigate(url="https://example.com/page")
+ Re-register the hook at the start of any later call that navigates. Silent JS errors are high-value findings.
+
+2. **Read the page structure** — list visible interactive elements with their viewport centres (use `cdp('Accessibility.getFullAXTree')` and filter in Python when you need roles/names):
+ ```python
+ # List interactive elements
+ print(js("""(() => [...document.querySelectorAll('a,button,input,select,textarea,[role=button]')]
+ .filter(e => e.offsetParent).slice(0, 80).map((e, i) => { const r = e.getBoundingClientRect();
+ return {i, tag: e.tagName, text: (e.innerText || e.value || e.getAttribute('aria-label') || '').trim().slice(0, 60),
+ id: e.id, name: e.name, x: Math.round(r.x + r.width / 2), y: Math.round(r.y + r.height / 2)}; }))()"""))
```
-2. **Take a snapshot** to understand the DOM structure:
- ```
- browser_snapshot()
- ```
+3. **Visually assess the page:** call `capture_screenshot()` and inspect the attached image for layout issues, broken elements, or accessibility concerns. If your model cannot view images, pass the printed path to `vision_analyze`.
-3. **Check the console** for JavaScript errors:
- ```
- browser_console(clear=true)
- ```
- Do this after every navigation and after every significant interaction. Silent JS errors are high-value findings.
-
-4. **Take an annotated screenshot** to visually assess the page and identify interactive elements:
- ```
- browser_vision(question="Describe the page layout, identify any visual issues, broken elements, or accessibility concerns", annotate=true)
- ```
- The `annotate=true` flag overlays numbered `[N]` labels on interactive elements. Each `[N]` maps to ref `@eN` for subsequent browser commands.
-
-5. **Test interactive elements** systematically:
- - Click buttons and links: `browser_click(ref="@eN")`
- - Fill forms: `browser_type(ref="@eN", text="test input")`
- - Test keyboard navigation: `browser_press(key="Tab")`, `browser_press(key="Enter")`
- - Scroll through content: `browser_scroll(direction="down")`
+4. **Test interactive elements** systematically:
+ - Click buttons and links: `js("document.querySelector('#submit').click()")`, or `click_at_xy(x, y)` with a centre from step 2
+ - Fill forms: `fill_input('input[name=email]', 'test input')`
+ - Test keyboard navigation: `cdp('Input.dispatchKeyEvent', type='keyDown', key='Tab', code='Tab', windowsVirtualKeyCode=9)` followed by the matching `keyUp`, then `js('document.activeElement.outerHTML.slice(0, 200)')` to see where focus landed; same pattern with `key='Enter'`, `code='Enter'`, `windowsVirtualKeyCode=13`
+ - Scroll through content: `js('window.scrollBy(0, 800)')`
+ - Go back: `js('history.back()')`, then `wait_for_load()`
- Test form validation with invalid inputs
- Test empty submissions
-6. **After each interaction**, check for:
- - Console errors: `browser_console()`
- - Visual changes: `browser_vision(question="What changed after the interaction?")`
- - Expected vs actual behavior
+5. **After each interaction**, in the same call, check for:
+ - Console errors: `print(js('window.__qa_errors || []'))`
+ - Visual changes: `capture_screenshot()` and compare with the previous one
+ - Expected vs actual behavior (`page_info()`, or `js()` reading the relevant element)
### Phase 3: Collect Evidence
For every issue found:
-1. **Take a screenshot** showing the issue:
- ```
- browser_vision(question="Capture and describe the issue visible on this page", annotate=false)
- ```
- Save the `screenshot_path` from the response — you will reference it in the report.
+1. **Take a screenshot** showing the issue: `capture_screenshot()` prints the saved path. Copy it to `{output_dir}/screenshots/` under a descriptive name (e.g. `issue-03-broken-login.png`) — you will reference it in the report.
2. **Record the details**:
- URL where the issue occurs
@@ -159,22 +162,26 @@ Save the report to `{output_dir}/report.md`.
## Tools Reference
-| Tool | Purpose |
+All browser actions are `browser_exec` calls; these are the helpers and idioms used above.
+
+| Action | `browser_exec` idiom |
|------|---------|
-| `browser_navigate` | Go to a URL |
-| `browser_snapshot` | Get DOM text snapshot (accessibility tree) |
-| `browser_click` | Click an element by ref (`@eN`) or text |
-| `browser_type` | Type into an input field |
-| `browser_scroll` | Scroll up/down on the page |
-| `browser_back` | Go back in browser history |
-| `browser_press` | Press a keyboard key |
-| `browser_vision` | Screenshot + AI analysis; use `annotate=true` for element labels |
-| `browser_console` | Get JS console output and errors |
+| Go to a URL | `new_tab(url)` once (or `new_tab('about:blank')` before registering the hook), then `goto_url(url)`; follow with `wait_for_load()` |
+| Page state | `page_info()` |
+| DOM / accessibility tree | `js(...)` extraction, or `cdp('Accessibility.getFullAXTree')` filtered in Python |
+| Click | `js("document.querySelector(sel).click()")` or `click_at_xy(x, y)` |
+| Type into an input | `fill_input(selector, text)` |
+| Scroll | `js('window.scrollBy(0, 800)')` |
+| Go back | `js('history.back()')` |
+| Press a key | `cdp('Input.dispatchKeyEvent', type='keyDown', key=..., code=..., windowsVirtualKeyCode=...)` + `keyUp` |
+| Screenshot | `capture_screenshot()` (image attached to the result; text-only models use `vision_analyze` on the path) |
+| JS console errors | hook via `cdp('Page.addScriptToEvaluateOnNewDocument', source=HOOK)`, read with `js('window.__qa_errors || []')` |
## Tips
-- **Always check `browser_console()` after navigating and after significant interactions.** Silent JS errors are among the most valuable findings.
-- **Use `annotate=true` with `browser_vision`** when you need to reason about interactive element positions or when the snapshot refs are unclear.
+- **Always read `window.__qa_errors` after navigating and after significant interactions.** Silent JS errors are among the most valuable findings.
+- **Batch each sub-procedure into one `browser_exec` call** (navigate, wait, extract, act, check errors) — fewer round-trips, and the hook stays in place.
+- **Take a `capture_screenshot()`** when you need to reason about element positions or when DOM extraction is ambiguous; `click_at_xy` takes the centres from the element listing.
- **Test with both valid and invalid inputs** — form validation bugs are common.
- **Scroll through long pages** — content below the fold may have rendering issues.
- **Test navigation flows** — click through multi-step processes end-to-end.
diff --git a/website/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring.md b/website/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring.md
index 4f0af07a562..b76b4813239 100644
--- a/website/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring.md
+++ b/website/docs/user-guide/skills/bundled/software-development/software-development-hermes-agent-skill-authoring.md
@@ -147,7 +147,7 @@ Not every section applies to every skill (a pure-procedure task skill may have n
### Reference Hermes tools, not raw shell
-When the skill needs a capability, name the proper Hermes tool in backticks: `terminal`, `read_file`, `write_file`, `patch`, `search_files`, `web_search`, `web_extract`, `browser_navigate`, `vision_analyze`, `delegate_task`, `cronjob`. Do NOT name shell utilities the agent already has wrapped (`grep` → `search_files`, `cat` → `read_file`, `sed`/`awk` → `patch`, `find`/`ls` → `search_files target='files'`). A CLI-wrapper skill should frame invocations as `terminal(command="{tool} ...", timeout=...)` — bare shell prose ("run `foo --version`") is a review-blocking non-conformance. If the skill depends on an MCP server, name it and document setup in Prerequisites.
+When the skill needs a capability, name the proper Hermes tool in backticks: `terminal`, `read_file`, `write_file`, `patch`, `search_files`, `web_search`, `web_extract`, `browser_exec`, `vision_analyze`, `delegate_task`, `cronjob`. Do NOT name shell utilities the agent already has wrapped (`grep` → `search_files`, `cat` → `read_file`, `sed`/`awk` → `patch`, `find`/`ls` → `search_files target='files'`). A CLI-wrapper skill should frame invocations as `terminal(command="{tool} ...", timeout=...)` — bare shell prose ("run `foo --version`") is a review-blocking non-conformance. If the skill depends on an MCP server, name it and document setup in Prerequisites.
### Never use machine-local paths