web-browser

Automate and interact with web pages through Chrome or Chromium using the Chrome DevTools Protocol (CDP): navigate, click, fill forms, inspect content, take screenshots, and debug console or network activity. Use when an agent needs a real browser. Prefer headless Chrome unless visible browser inter

By mitsuhiko · 664 installs

npx skills add mitsuhiko/agent-stuff --skill web-browser

Source repository · Upstream listing

Web Browser Skill Minimal CDP tools for collaborative site exploration. Start Chrome (Prefer Headless) Starts Chrome with remote debugging (default port :9222 ). Agents should use headless by default because it is less disruptive and supports navigation, evaluation, screenshots, emulation, and logging. User extensions are disabled for headless launches; a copied profile still provides its cookies and other browser state, but extension based features are unavailable. Headed launches continue to load extensions normally. Use headed mode only when a person needs to see or interact with the browser, such as for pick.js , manual authentication, or debugging a headless specific difference. The start script only reuses a running browser when its profile and launch settings match. Stop the running skill browser before switching between headless and headed mode. Changing the debugging port does not isolate the profile: startup refuses to modify a profile already used on another port and preserves Chrome's profile locks. Profile behavior: Default mode uses: ~/.cache/agent web/browser/fresh profile profile mode uses: ~/.cache/agent web/browser/profile copy The skill does not attach to your live Chrome profile directly If :9222 is already used by an unknown instance, start will fail instead of reusing it If Chrome is installed in a non standard location, set: Optional debug endpoint override: Stop Chrome Works for headless and headed browsers. Only processes using the skill's cached profiles are stopped, not your regular Chrome. Shutdown preserves cookies and other cached state; it never force kills Chrome. Stop before using reset profile . To switch to a visible browser: Navigate Navigate current tab or open new tab. Device Emulation (Mobile) Set an active device emulation preference (viewport, DPR, touch, UA) for browser skill commands. Use reset to clear. Commands like nav.js , eval.js , pick.js , dismiss cookies.js , and screenshot.js automatically apply the active preference. Evaluate JavaScript Execute JavaScript in the active tab. Input can be an expression or statement list; the console style completion value is printed and promises/top level await are awaited. Be careful with string escaping, best to use single quotes. Screenshot Takes a screenshot and returns a temp file path. Default: current viewport full page : captures full document height device <preset : temporary mobile emulation for that screenshot only Pick Elements Interactive element picker. Click to select, Cmd/Ctrl+Click for multi select, Enter to finish. This requires headed Chrome; launch start.js without headless . Dismiss Cookie Dialogs Automatically dismisses EU cookie consent dialogs. Run after navigating to a page: Quick Mobile Debug Flow Background Logging (Console + Errors + Network) Automatically started by start.js and writes JSONL logs to: Manually start: Tail latest log: Summarize network responses: