Skip to content

docs: refresh README for current domain skills #193

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
justyn-clark wants to merge 2 commits into
base: main
Choose a base branch
from
Open

docs: refresh README for current domain skills #193

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
c8d02bf
docs: refresh README for current domain skills
justyn-clark Apr 24, 2026
9381cd3
docs: refresh harness debug notes
justyn-clark Apr 29, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 6 additions & 6 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -20,7 +20,7 @@ The agent writes what's missing, mid-task. No framework, no recipes, no rails. O

## Setup prompt

Paste into Claude Code or Codex:
Paste into Codex or another human-spawned agent session:

```text
Set up https://github.com/browser-use/browser-harness for me.
Expand All @@ -32,7 +32,7 @@ When this page appears, tick the checkbox so the agent can connect to your brows

<img src="docs/setup-remote-debugging.png" alt="Remote debugging setup" width="520" style="border-radius: 12px;" />

See [domain-skills/](domain-skills/) for example tasks.
See [domain-skills/](domain-skills/) for example tasks. The library now includes browser-tested playbooks for common scraping targets plus action-oriented flows such as GitHub repo actions, Facebook groups/pages, Trello boards/lists, Framer editor work, Reddit JSON/DOM extraction, Medium article hydration, Atlas, and Centilebrain normative z-scores.

## Free remote browsers

Expand All @@ -42,13 +42,13 @@ Useful for stealth, sub-agents, or deployment.<br>
- Grab a key at [cloud.browser-use.com/new-api-key](https://cloud.browser-use.com/new-api-key)
- Or let the agent sign up itself via [docs.browser-use.com/llms.txt](https://docs.browser-use.com/llms.txt) (setup flow + challenge context included).

## How simple is it? (~592 lines of Python)
## How simple is it? (~816 lines of Python)

- `install.md` — first-time install and browser bootstrap
- `SKILL.md` — day-to-day usage
- `run.py` (~36 lines) — runs plain Python with helpers preloaded
- `helpers.py` (~195 lines) — starting tool calls; the agent edits these
- `admin.py` + `daemon.py` (~361 lines) — daemon bootstrap plus the CDP websocket and socket bridge
- `run.py` (~44 lines) — runs plain Python with helpers preloaded
- `helpers.py` (~216 lines) — starting tool calls; the agent edits these
- `admin.py` + `daemon.py` (~556 lines) — daemon bootstrap, profile detection, remote stop/restart helpers, plus the CDP websocket and socket bridge

## Contributing

Expand Down
6 changes: 6 additions & 0 deletions SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,12 @@ rg --files domain-skills
rg -n "tiktok|upload" domain-skills
```

## Debugging helpers

Use `browser-harness --debug-clicks` when coordinate clicks need a visual receipt. It draws a DPR-aware overlay for click debugging so retina and scaled displays do not mislead the next action.

For JavaScript snippets, `run.py` sends code with Python's `-c` path rather than heredoc stdin. Top-level `return` expressions in JS snippets are auto-wrapped in an IIFE, so quick probes can stay terse without hand-writing wrapper functions.

## Always contribute back

If you learned anything non-obvious about how a site works, open a PR to domain-skills/<site>/ before you finish. Default to contributing. The harness gets better only because agents file what they learn. If figuring something out cost you a few steps, the next run should not pay the same tax.
Expand Down