# browser-harness

> Claude/Codex skill by [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 3.5k stars · Updated 2026-08-08

Direct browser control via CDP. Use when the user wants to automate, scrape, test, or interact with web pages. Connects to the user's already-running Chrome.

## Install

```sh
git clone https://github.com/davidondrej/skills /tmp/skills && ln -s /tmp/skills/skills/research-and-web/browser-harness ~/.claude/skills/browser-harness
```

## From README

browser-harness Direct browser control via CDP. For task-specific edits, use agent-workspace/agenthelpers.py. For , , or connection problems, read .md. Routing check first: if the task needs no interaction (no clicks, logins, or forms) and you just want page content, use DeepAPI POST /v1/scrape/website instead of driving a browser — see the deepapi skill. Use browser-harness when the task needs a real browser: interaction, JS-heavy flows, logged-in sessions, or visual verification. Domain skills (community-contributed per-site playbooks under agent-workspace/domain-skills/) are off by default. Set BHDOMAINSKILLS=1 to enable them; see the bottom section. If BHDOMAINSKILLS=1 and the task is site-specific, read every file in the matching agent-workspace/domain-skills/ / directory before inventing an approach. Invoke as browser-harness — it's on $PATH. No cd, no uv run. First navigation is newtab(url), not gotourl(url) — goto runs in the user's active tab and clobbers their work.

## Links

- HTML page: https://omgskills.com/library/davidondrej/skills/browser-harness/
- GitHub: https://github.com/davidondrej/skills
- Author: [@davidondrej](https://omgskills.com/library/davidondrej/index.md)

## More from this repo

- [anti-sleep](https://omgskills.com/library/davidondrej/skills/anti-sleep/index.md) — Keep a Mac awake for a set duration or while a process runs.
   - [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars
- [adr-verbatim](https://omgskills.com/library/davidondrej/skills/skills/thinking-and-docs/adr-verbatim/index.md) — Record concise ADRs that preserve the user's decisions without conversational noise.
   - [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars
- [ask-then-build](https://omgskills.com/library/davidondrej/skills/skills/thinking-and-docs/ask-then-build/index.md) — Clarify a feature, change, or refactor through questions, then write a build prompt for another agent.
   - [@davidondrej](https://omgskills.com/library/davidondrej/index.md) · 4.2k stars