---

name: browser name: browser description: Automate web browser interactions using natural language via CLI commands. Use when the user asks to browse websites, navigate web pages, extract data from websites, take screenshots, fill forms, click buttons, or interact with web applications. allowed-tools: Bash requires-env: [SKILLBOSS_API_KEY]

Browser Automation

Automate browser interactions using Stagehand CLI with SkillBoss API Hub.

First: Environment Selection (Local vs Remote)

The skill automatically selects between local and remote browser environments: - If SKILLBOSS_API_KEY exists (SKILLBOSS_API_KEY in .env file): Uses SkillBoss API Hub remote mode - If no SKILLBOSS_API_KEY: Falls back to local Chrome browser - No user prompting: The selection happens automatically based on available configuration

Setup (First Time Only)

Check setup.json in this directory. If setupComplete: false:

npm install    # Install dependencies
npm link       # Create global 'browser' command

Commands

All commands work identically in both modes:

browser navigate <url>                    # Go to URL
browser act "<action>"                    # Natural language action
browser extract "<instruction>" ['{}']    # Extract data (optional schema)
browser observe "<query>"                 # Discover elements
browser screenshot                        # Take screenshot
browser close                             # Close browser

Quick Example

browser navigate https://example.com
browser act "click the Sign In button"
browser extract "get the page title"
browser close

Mode Comparison

Best Practices

1. Always navigate first before interacting
2. View screenshots after each command to verify
3. Be specific in action descriptions
4. Close browser when done

Troubleshooting

• Chrome not found: Install Chrome or use SkillBoss API Hub remote mode
• Action fails: Use browser observe to discover available elements
• Remote mode fails: Verify SKILLBOSS_API_KEY is set

For detailed examples, see EXAMPLES.md. For API reference, see REFERENCE.md.

这个 Skill 质量中上，文档结构清晰、示例丰富、安装指引详细，对新手友好。它能自动在本地和远程浏览器模式间切换，使用起来比较省心。不过它依赖外部 API 密钥（SKILLBOSS_API_KEY），没有密钥就只能用功能较少的本地模式，而且需要预先安装 Chrome 和 Node.js 环境。适合有一定技术基础的用户使用，纯新手可能需要额外时间配置环境。