Configure the browser tool for Clacky. Guides the user through Chrome or Edge setup,
verifies the connection, and writes ~/.clacky/browser.yml.
Supports macOS, Linux, and WSL (Windows Chrome/Edge via remote debugging).
Trigger on: "browser setup", "setup browser", "้ ็ฝฎๆต่งๅจ", "browser config",
"browser doctor".
Subcommands: setup, doctor.
Standardmรครig ist der Prompt ausgewรคhlt, der zuerst die Quelle prรผft. Sie kรถnnen zu einem direkten Befehl wechseln oder eine lokale Kopie herunterladen.
Quelldateien prรผfen
Lesen Sie SKILL.md und alle von SkillsMP angezeigten Begleitdateien, bevor Sie sich fรผr eine Installation entscheiden.
Mit Codex oder Claude installieren Kopieren Sie diesen Prompt, fรผgen Sie ihn in Codex, Claude oder einen anderen Assistant ein und lassen Sie die Skill-Seite prรผfen und installieren.
Ein direkter Befehl รผberspringt den Prรผf-Prompt. Prรผfen Sie die Quelle, bevor Sie ihn ausfรผhren.
Configure the browser tool for Clacky. Guides the user through Chrome or Edge setup,
verifies the connection, and writes ~/.clacky/browser.yml.
Supports macOS, Linux, and WSL (Windows Chrome/Edge via remote debugging).
Trigger on: "browser setup", "setup browser", "้ ็ฝฎๆต่งๅจ", "browser config",
"browser doctor".
Subcommands: setup, doctor.
argument-hint
setup | doctor
allowed-tools
["Bash","Read","Write","browser"]
Browser Setup Skill
Configure the browser tool for Clacky. Config is stored at ~/.clacky/browser.yml.
Region-Aware Download Links
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
If there are any โ or โ ๏ธ items, show them first in a Problems Found section, followed by specific Recommended Actions:
Browser Doctor โ Diagnostic Report
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
โ ๏ธ Problems Found
[โ] Chrome not connected
Error: Chrome/Edge is not running or remote debugging is not enabled
[โ] Chrome version v142 is too old
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
Configuration
[โ ] Config file found
[โ ] Browser tool enabled
Dependencies
[โ ] Node.js v22.1.0
[โ ] chrome-devtools-mcp installed
Connection
[โ ] Clacky server running
[โ] Chrome not connected
โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ
๐ง Recommended Actions
1. Enable remote debugging:
- Open Chrome and visit: chrome://inspect/#remote-debugging
- Click "Allow remote debugging for this browser instance"
2. Upgrade your browser:
- Chrome v142 is too old (need v146+)
- Pick the download link for the user's region from the
**Region-Aware Download Links** section at the top of this skill
(China users โ google.cn; others โ google.com).
After fixing these issues, run `/browser-setup` again to verify.
Common Diagnostic Scenarios
Scenario 1: Config not found
[โ] Config file not found
๐ง Fix: Run `/browser-setup` to configure the browser tool.
Scenario 2: Chrome not running
[โ] Chrome not connected
Error: Chrome/Edge is not running or remote debugging is not enabled
๐ง Fix:
1. Open Chrome or Edge
2. Visit: chrome://inspect/#remote-debugging
3. Click "Allow remote debugging"
Scenario 3: MCP not installed
[โ] chrome-devtools-mcp not installed
๐ง Fix: Run `npm install -g chrome-devtools-mcp@latest`
(or run `/browser-setup` to install automatically)
Scenario 4: Everything OK
โ All systems operational!
The browser tool is ready to use.
Online Troubleshooting Guide
If any โ items are found, or the user reports a problem you cannot resolve with the above scenarios, fetch the latest troubleshooting guide:
Use the content from that page to provide up-to-date diagnosis and resolution steps. This online document is maintained separately and may contain newer solutions not listed here.
