Gsd Browser

What it does

When your agent uses it

• The user needs to interact with websites
• Take screenshots
• Share a live browser view
• Narrate browser actions

Example prompts

• “open a website”
• “fill out a form”
• “take a screenshot”
• “/gsd-browser”

Requirements

• Pre-approved tools (allowed-tools): Bash(gsd-browser:*), Bash(gsd-browser *)

What it can do on your machine

Read from SKILL.md and the folder at commit e5ec085. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves these tools, so the agent can use them without asking each time:

  • Bash(gsd-browser:*)
  • Bash(gsd-browser *)

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gsd Browser loads about 1.3k tokens when it runs, and up to ~6.9k if it reads all its reference files. Until then it costs about 157 tokens; SKILL.md has 453 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~157

When it runs · the whole SKILL.md, loaded when a task matches

~1.3k

With references · SKILL.md plus every file in references/, read only if the agent opens them

~6.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from gsd-build/gsd-browser at commit e5ec085, republished under its Apache-2.0 licence (© gsd-build). 453 words, ~1,283 tokens.

name

gsd-browser

description

Native Rust browser automation CLI for AI agents. Use when the user needs to interact with websites, navigate pages, fill forms, click buttons, take screenshots, share a live browser view, narrate browser actions, extract structured data, run assertions, test web apps, mock network requests, or automate any browser task. Triggers include "open a website", "fill out a form", "take a screenshot", "show me the browser", "share the screen", "pause the browser", "step through this", "scrape data", "test this web app", "login to a site", "visual regression test", or any task requiring programmatic web interaction.

allowed-tools

Bash(gsd-browser:*), Bash(gsd-browser *)

gsd-browser navigate https://example.com
gsd-browser snapshot
# Read snapshot output: @v1:e1 [input type="email"], @v1:e2 [button] "Submit"
gsd-browser fill-ref @v1:e1 "user@example.com"
gsd-browser click-ref @v1:e2
gsd-browser wait-for --condition network_idle
gsd-browser snapshot  # REQUIRED - old refs are now stale

<routing>

</routing>

© gsd-build, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 11 other files (references) in gsd-browser-skill of gsd-build/gsd-browser.

• SKILL.md
• references/command-reference.md
• references/configuration.md
• references/error-recovery.md
• references/semantic-intents.md
• references/snapshot-and-refs.md
• workflows/debug-and-diagnose.md
• workflows/live-viewer-and-narration.md
• workflows/navigate-and-interact.md
• workflows/scrape-and-extract.md
• workflows/setup-and-configure.md
• workflows/test-and-assert.md

Open the folder on GitHubat commit e5ec085