browser_visible

Instructions for starting and controlling a real web browser either visibly or in the background. A visible browser shows its window so a person can watch, log in, or help with a task.

In plain words
What is it for?
It helps start and stop the browser, open pages, inspect them, click elements, enter text, use a shared debugging port, and work with login screens or verification codes.
Why use it?
It clarifies when to show the browser for demonstrations or manual login steps and when to keep it hidden for unattended automation.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/mateaix/mateclaw/browser_visible
Any agent
npx skills add mateaix/mateclaw --skill browser_visible
Clone the repo
git clone --depth 1 https://github.com/mateaix/mateclaw

Made for: Claude Code, Codex.

Per session 37 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 695 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00037 $0.00695
Opus 5 $0.00018 $0.00347
Sonnet 5 $0.00007 $0.00139
Haiku 4.5 $0.00004 $0.00069

Measured 2d ago against content hash 95e548414360, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

browser_visible scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

mateclaw-server/src/main/resources/skills/browser_visible/SKILL.md · 94 lines

What it actually says

浏览器启动模式

本技能控制 browser_use 的启动方式,核心参数:

参数 类型 说明
headed Boolean true = 显示窗口;false(默认)= 无头模式
cdpPort Integer 指定 CDP 调试端口(不填则自动选择)

常见用法

无头模式(默认,后台自动化)

browser_use(action="start")

可见窗口(演示 / 需要人工操作)

browser_use(action="start", headed=true)

指定 CDP 端口(与外部工具共享)

browser_use(action="start", headed=true, cdpPort=9222)

标准操作序列

# 1. 启动
browser_use(action="start", headed=true)

# 2. 打开页面
browser_use(action="open", url="https://example.com")

# 3. 截取快照(查看页面内容)
browser_use(action="snapshot")

# 4. 点击元素
browser_use(action="click", selector="#submit-btn")

# 5. 输入文本
browser_use(action="type", selector="input[name=email]", text="[email protected]")

# 6. 完成后关闭
browser_use(action="stop")

何时用可见模式

场景 推荐参数
向用户演示操作过程 headed=true
需要用户手动登录(扫码、验证码) headed=true,遇到登录页暂停并提示用户
调试自动化脚本 headed=true
纯自动化、不需要展示 headed=false(默认)

跨平台可执行文件路径(需自定义浏览器时)

MateClaw 的 browser_use 会自动检测系统浏览器,无需手动指定路径。如需调试特定 Chrome 安装位置:

Windows 默认路径:

C:\Program Files\Google\Chrome\Application\chrome.exe
C:\Program Files (x86)\Google\Chrome\Application\chrome.exe

macOS 默认路径:

/Applications/Google Chrome.app/Contents/MacOS/Google Chrome

Linux 默认路径:

/usr/bin/google-chrome
/usr/bin/chromium-browser

注意事项

  • 可见模式需要图形环境(GUI);无桌面的服务器无法使用
  • 若浏览器已在运行,须先 stop 再重新 start 才能切换 headed 状态
  • cdpPort 被占用时会报错,换端口或先停止占用该端口的进程
  • 用户手动操作可见浏览器不会刷新 Agent 的 idle 超时计时
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 94 lines · 37 tokens per session scan A 95e548414360

Subscribe to this mod's changes

browser_visible is a skill published in the GitHub repository mateaix/mateclaw (1,061 stars, last pushed 2d ago), licensed Apache-2.0. It adds 37 tokens to every session and 695 once invoked, about $0.0002 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

dingtalk_channel_connect

Use a headed browser to automatically complete DingTalk channel integration for QwenPaw. Applicable when the user mentions DingTalk, developer console, Client ID, Client Secret, bot, Stream mode, binding or configuring a channel. Supports pausing when a login page is detected and resuming after the user logs in.

agentscope-ai/QwenPaw · 69 tokens

dingtalk_channel_connect

使用可视浏览器自动完成 QwenPaw 的钉钉频道接入。适用于用户提到钉钉、DingTalk、开发者后台、Client ID、Client Secret、机器人、Stream 模式、绑定或配置 channel 的场景;支持遇到登录页时暂停,等待用户登录后继续。.

agentscope-ai/QwenPaw · 78 tokens

browser_cdp

Use this skill when the user explicitly wants to connect to a running Chrome browser, scan local CDP ports, specify a cdpport, or share a single browser across multiple agents/tools. By default browser opens no debugging port; pass an explicit cdpport only when the user wants another local tool to attach.

agentscope-ai/QwenPaw · 70 tokens

browser_cdp

当用户明确希望连接到已运行的 Chrome 浏览器、扫描本地 CDP 端口、显式指定 cdpport,或让多个 agent / 工具共享同一个浏览器时,使用本 skill。browser 默认不开放调试端口;仅当用户明确希望其他本地工具附加时才显式传入 cdpport。.

agentscope-ai/QwenPaw · 85 tokens

browser_visible

当用户需要控制 browser 的浏览器启动方式时,使用本 skill。browser 默认由 Playwright 直接管理、不开放调试端口(需让其他本地工具附加时显式传 cdpport);headed 控制是否显示窗口,privatemode 保留用于兼容、不再改变默认行为,browserargs 传入额外的 Chromium 启动参数,executablepath 指定自定义浏览器可执行文件路径。.

agentscope-ai/QwenPaw · 108 tokens

browser_visible

Use this skill when the user needs to control the browser launch mode for browser. By default browser is managed by Playwright and opens no debugging port (pass an explicit cdpport to let another local tool attach); headed controls whether the window is visible, and privatemode is kept for backward compatibility and…

agentscope-ai/QwenPaw · 75 tokens