AgentSkillsCN

browser-automation

基于极简的 OpenCode 浏览器原语，实现可靠且可组合的浏览器自动化。

SKILL.md
--- frontmatter
name: browser-automation
description: Reliable, composable browser automation using minimal OpenCode Browser primitives.
license: MIT
compatibility: opencode
metadata:
  audience: agents
  domain: browser

What I do

  • •Provide a safe, composable workflow for browsing tasks
  • •Use browser_query list and index selection to click reliably
  • •Confirm state changes after each action

Best-practice workflow

  1. •Inspect tabs with browser_get_tabs
  2. •Open new tabs with browser_open_tab when needed
  3. •Navigate with browser_navigate if needed
  4. •Wait for UI using browser_query with timeoutMs
  5. •Discover candidates using browser_query with mode=list
  6. •Click, type, or select using index
  7. •Confirm using browser_query or browser_snapshot

Selecting options

  • •Use browser_select for native <select> elements
  • •Prefer value or label; use optionIndex when needed
  • •Example: browser_select({ selector: "select", value: "plugin" })

Query modes

  • •text: read visible text from a matched element
  • •value: read input values
  • •list: list many matches with text/metadata
  • •exists: check presence and count
  • •page_text: extract visible page text

Opening tabs

  • •Use browser_open_tab to create a new tab, optionally with url and active
  • •Example: browser_open_tab({ url: "https://example.com", active: false })

Troubleshooting

  • •If a selector fails, run browser_query with mode=page_text to confirm the content exists
  • •Use mode=list on broad selectors (button, a, *[role="button"]) and choose by index
  • •Confirm results after each action