browser-setup

browser-setup is a skill for Claude Code, Codex from clacky-ai/openclacky. It costs 83 tokens per session (3,105 once invoked), scanned A, original, MIT.

A setup guide for connecting Clacky's browser tool to Chrome or Edge. It supports macOS, Linux, and Windows installations used through WSL, and stores the connection settings in a configuration file.

In plain words
What is it for?
Use it to configure the browser, check whether the connection works, and create or update the browser configuration.
Why use it?
It helps resolve browser connection and setup problems before you try to automate websites.

Skill for Claude CodeCodex

About the project

OpenClacky is an open-source AI coding agent that uses OpenAI-compatible models to perform tasks through tools and subagents. It is intended for developers who want an agent with flexible model choice and lower token usage. The catalogue skills and agents extend its workflows and capabilities.

clacky-ai/openclacky · 1,184 stars · on GitHub · openclacky.com

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/clacky-ai/openclacky/browser-setup
Any agent
npx skills add clacky-ai/openclacky --skill browser-setup
Clone the repo
git clone --depth 1 https://github.com/clacky-ai/openclacky

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for browser-setup

README.md
[![agentmods](https://agentmods.dev/badge/skills/clacky-ai/openclacky/browser-setup.svg)](https://agentmods.dev/skills/clacky-ai/openclacky/browser-setup)
Your own site
<a href="https://agentmods.dev/skills/clacky-ai/openclacky/browser-setup"><img src="https://agentmods.dev/badge/skills/clacky-ai/openclacky/browser-setup.svg" alt="Measured on agentmods" height="20"></a>
Per session 83 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,105 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 1 finding. 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.1 $0.00083 $0.03105
Opus 5 $0.00042 $0.01553
Sonnet 5 $0.00017 $0.00621
Haiku 4.5 $0.00008 $0.00311

Measured 6d ago against content hash f7eb0d1afda3, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-05, from the pricing page.

Security

Grade A, and why

browser-setup scanned grade A with 1 finding 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 6d 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.

Makes network callslowCapability

Not a fault in itself. Listed so you know the mod talks to something, and to what.

- `curl -s --max-time 3 https://www.google.com -o /dev/null -w "%{http_code}"` returns `000` while baidu.com works
lib/clacky/default_skills/browser-setup/SKILL.md · 443 lines

How it starts

The opening of the file, as written. The whole thing — 443 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Browser Setup Skill

Configure the browser tool for Clacky. Config is stored at ~/.clacky/browser.yml.

Whenever you show the user a link to download or upgrade Chrome/Edge, pick the right one for their region instead of always using google.com.

Treat the user as in China when any of these is true:

  • The user is talking to you in Chinese
  • The system locale is Chinese (echo $LANG contains zh_CN / zh_)
  • A previous run of install_browser.sh reported Region: china (visible in its output)
  • curl -s --max-time 3 https://www.google.com -o /dev/null -w "%{http_code}" returns 000 while baidu.com works

Use these links accordingly:

Region Chrome Edge
China https://www.google.cn/chrome/ https://www.microsoft.com/zh-cn/edge
Global https://www.google.com/chrome/ https://www.microsoft.com/edge

When unsure, show both lines (label them "China:" and "Global:") so the user can pick.

Command Parsing

User says Subcommand
browser setup, 配置浏览器, setup browser setup
browser doctor doctor

If no subcommand is clear, default to setup.


setup

Core Strategy: Progressive validation with clear next steps at each failure point.

Step 1 — Ensure Node.js is installed

Check Node.js version:

node --version 2>/dev/null

Parse the version. If Node.js is missing or version < 20:

Run the bundled installer to automatically install Node.js:

bash ~/.clacky/scripts/install_browser.sh

If the script exits 0 → Node.js is now installed. Proceed to Step 2.

If the script exits non-zero or doesn't exist:

❌ Node.js 20+ is required for browser automation.

Please install Node.js from: https://nodejs.org

Let me know when done and I'll continue.

Wait for user confirmation, then retry this step once. If still failing, stop.

Step 2 — Ensure chrome-devtools-mcp is installed

Check if installed:

chrome-devtools-mcp --version 2>/dev/null

Read the full file on GitHub · 443 lines

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. 6d ago First seen · 443 lines · 83 tokens per session scan A f7eb0d1afda3

Subscribe to this mod's changes

browser-setup is a skill published in the GitHub repository clacky-ai/openclacky (1,184 stars, last pushed yesterday), licensed MIT. It adds 83 tokens to every session and 3,105 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 1 finding (makes network calls). 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