rugged-gemini: Skill for Gemini CLI

Browser Automation (Playwright MCP)

Tool Hierarchy

PRIMARY — MCP tools (always prefer):

• mcp_playwright_browser_snapshot — read page structure, get element refs
• mcp_playwright_browser_navigate — go to URL
• mcp_playwright_browser_click — click element
• mcp_playwright_browser_type — type into element
• mcp_playwright_browser_fill_form — fill multiple form fields
• mcp_playwright_browser_select_option — dropdown selection
• mcp_playwright_browser_hover — hover element
• mcp_playwright_browser_drag — drag and drop
• mcp_playwright_browser_drop — drop files/data onto element
• mcp_playwright_browser_press_key — keyboard input
• mcp_playwright_browser_evaluate — execute JS on page
• mcp_playwright_browser_wait_for — wait for text/disappearance/time
• mcp_playwright_browser_console_messages — read console output
• mcp_playwright_browser_network_requests — list network activity
• mcp_playwright_browser_network_request — inspect single request
• mcp_playwright_browser_file_upload — upload files
• mcp_playwright_browser_handle_dialog — accept/dismiss dialogs
• mcp_playwright_browser_tabs — manage tabs
• mcp_playwright_browser_resize — change viewport
• mcp_playwright_browser_run_code_unsafe — arbitrary Playwright code (escape hatch)

FALLBACK — CLI via run_command (only when MCP lacks capability):

• Tracing start/stop
• Video recording
• Persistent browser profiles
• Browser installation (npx playwright install)

NEVER mix MCP and CLI for the same session. One approach per workflow.

---

Snapshot-First Workflow

Every browser interaction follows this loop:

1. Snapshot — mcp_playwright_browser_snapshot to understand current state
2. Act — click/type/navigate using refs from snapshot
3. Verify — snapshot again to confirm mutation took effect

Rules:

• ALWAYS snapshot before first interaction on a page
• Use snapshot element refs (ref="e5") for targeting — not CSS selectors
• After navigation or state mutation, snapshot again to read new state
• Use depth param to limit snapshot size for large pages
• Use target param to scope snapshot to a subtree