shield_lock
JinDaGe
← Back to skills
extension
Category: Development & EngineeringNo API key required

gologin-agent-browser-skill

Use this skill when an agent needs browser automation through Gologin Cloud Browser, including live browser sessions, snapshots, ref-based clicks and typing, semantic find flows, screenshots, PDFs, uploads, waits, and daemon-backed session management with gologin-agent-browser.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

Gologin Agent Browser Skill

Use this skill when the task needs browser state, interaction, or multi-step navigation.

Core Rules

  • Use this skill for browser automation, not for scraping-only tasks.
  • Prefer snapshot refs like @e3 after snapshot.
  • Refresh the snapshot after navigation or DOM-changing actions.
  • Use semantic find when stale refs or dynamic pages make raw refs unreliable.
  • Keep browser session work inside the gologin-agent-browser CLI model.

CLI Surface

Package:

  • gologin-agent-browser-cli

CLI:

  • gologin-agent-browser

Main command families:

  • session lifecycle: open, close, sessions, current
  • ref loop: snapshot, click, type, fill
  • navigation helpers: wait, scroll, scrollintoview
  • semantic helpers: find, get
  • artifact helpers: screenshot, pdf, upload

Setup

Expected environment variables:

  • GOLOGIN_TOKEN
  • GOLOGIN_PROFILE_ID optional
  • GOLOGIN_DAEMON_PORT optional
  • GOLOGIN_CONNECT_BASE optional

Tool Map

| Skill tool | CLI command | Use when | | --- | --- | --- | | agent_browser_open | gologin-agent-browser open <url> | A browser session must start | | agent_browser_snapshot | gologin-agent-browser snapshot | The next actionable refs are needed | | agent_browser_click | gologin-agent-browser click <target> | A target should be clicked | | agent_browser_type | gologin-agent-browser type <target> <text> | Text should be typed into a target | | agent_browser_fill | gologin-agent-browser fill <target> <text> | An input should be filled in one step | | agent_browser_find | gologin-agent-browser find ... | Semantic targeting is more reliable than refs | | agent_browser_get | gologin-agent-browser get <kind> [target] | Data should be extracted from the page | | agent_browser_wait | gologin-agent-browser wait ... | The flow should wait on state, text, or load | | agent_browser_upload | gologin-agent-browser upload <target> <file...> | Files should be uploaded | | agent_browser_pdf | gologin-agent-browser pdf <path> | A PDF artifact is needed | | agent_browser_screenshot | gologin-agent-browser screenshot <path> | A screenshot artifact is needed | | agent_browser_close | gologin-agent-browser close | The session should end | | agent_browser_sessions | gologin-agent-browser sessions | All active sessions should be inspected | | agent_browser_current | gologin-agent-browser current | The active session summary is needed |

Operating Pattern

Ref Loop

  1. Open a session with agent_browser_open.
  2. Capture refs with agent_browser_snapshot.
  3. Act with agent_browser_click, agent_browser_type, or agent_browser_fill.
  4. If the result says snapshot=stale, refresh with agent_browser_snapshot.
  5. Repeat until the task is complete.

Semantic Loop

  1. Use agent_browser_find when the page is dynamic or refs are brittle.
  2. Use agent_browser_get when a value, title, HTML, or URL should be read back.
  3. Use agent_browser_wait when the flow must pause for text, load state, or target availability.

Artifact Loop

  1. Use agent_browser_screenshot when a visual artifact is needed.
  2. Use agent_browser_pdf when a document artifact is needed.
  3. Use agent_browser_upload when the site requires file input.

Snapshot Discipline

  • Refs are best-effort and local to the latest snapshot.
  • Do not reuse old refs after navigation or heavy DOM changes.
  • Prefer a fresh snapshot or semantic find if a ref stops resolving.

References