BrowserSkill/packages/dsh-plugin-browserskill/skill/prelude.md

browser-skill (dsh edition)

DSH tool-routing requirement (highest priority)

This skill is running inside DeepSeek Harness, where the plugin has injected structured browser_* model tools. Always call those injected browser_* tools for browser work. Never use bash, shell, exec, or another tool to invoke the bsk CLI directly. The CLI command names shown below are only conceptual mappings for understanding the tools; they are not instructions to run commands. If a browser_* tool is available, using the CLI directly is incorrect because it bypasses plugin session ownership, observation UI, tool cards, and cleanup.

Use the injected tool whose name matches the operation, for example: browser_session_start, browser_navigate, browser_observe, browser_snapshot, browser_click, browser_fill, browser_press, browser_screenshot, and browser_session_stop. Pass arguments as the tool schema specifies (not CLI flags).

Drive the user's real Chromium browser (logins, cookies, Agent Window isolation) through this plugin's browser_* tools. Each injected tool is implemented by the plugin using the bsk engine internally — the model must not invoke that engine itself. The workflow, judgment rules, and safety constraints remain identical to the canonical CLI skill.

Tool availability: invoking this skill (which you just did) makes the plugin's browser_* tools available for the rest of the session — they are injected on successful skill load. Until then they are deliberately hidden, so do not attempt a browser action before loading this skill.

Tool ↔ CLI map

The tools below are thin, structured wrappers over the bsk CLI verbs of the same name; session parameters take the 4-letter session id (no --session flag spelling here):

dsh tool	bsk equivalent
browser_session_start / browser_session_stop / browser_session_list	bsk session start/stop/list
browser_navigate	bsk navigate
browser_snapshot / browser_observe	bsk snapshot / bsk observe
browser_click / browser_fill / browser_press	bsk click / bsk fill / bsk press
browser_screenshot	bsk screenshot
browser_emulate	bsk emulate

(bsk console / bsk network have no tool counterpart in this plugin yet.)

Plugin-specific semantics that override or narrow the CLI rules below:

• Owned sessions only: this plugin sees and acts on just the sessions IT started via browser_session_start. browser_session_list shows only those (with the current marker); passing a session id created by another program (or person) sharing the bsk daemon is refused outright — never retry those with the same id.
• Current session: omitted session parameters resolve to the most recently started or used OWNED session. With several sessions in flight, pass session explicitly to avoid surprises.
• Screenshots: when the model route accepts images, browser_screenshot returns the PNG inline as an image attachment; otherwise it returns the saved file path.
• browser_emulate mobile: requires width+height — the bsk daemon refuses --mobile without viewport dimensions.
• Live observation: in the dsh Web UI, every owned session is watched by the floating overlay (thumbnails, action, interrupt) — observational side traffic is free and never steals your command turn; just keep acting.

The canonical CLI skill body follows verbatim (source of truth: skill/SKILL.md in the BrowserSkill repo, mirrored by build into crates/bsk-cli/skill/SKILL.md). Read bsk <verb> --session <id> as "the browser_<verb> tool with session: <id>"; everything else — when to use, the stop-when-done rules, the interaction loop, refs, sandbox rules — applies unchanged.

---