Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
ulpi-io avatar

Browse

ulpi-io/skills

  • 243 installs
  • 4 repo stars
  • Updated July 23, 2026
  • ulpi-io/skills

Let coding agents browse repos, docs, or structured sources interactively instead of guessing paths or stale context.

About

Provides browse-oriented agent tooling from ulpi-io for systematically exploring repositories, documentation trees, or linked resources so assistants gather ground-truth context before editing code.

  • Interactive source browsing
  • Agent-friendly navigation
  • Reduced hallucinated file paths
  • Structured exploration workflow
  • CLI-oriented discovery

Browse by the numbers

  • 243 all-time installs (skills.sh)
  • +5 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #2,614 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/ulpi-io/skills --skill browse

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs243
repo stars★ 4
Last updatedJuly 23, 2026
Repositoryulpi-io/skills ↗

What it does

Let coding agents browse repos, docs, or structured sources interactively instead of guessing paths or stale context.

Files

SKILL.mdMarkdownGitHub ↗

browse: Browser & Native App Automation for AI Agents

Target Decision — ALWAYS check this first

Before running any browse command, decide the correct target:

User wants to...TargetCommand pattern
Open a URL, test a website, scrape web contentBrowser (default)browse goto <url>
Test a local dev server (localhost)Browserbrowse goto http://localhost:3000
Browse a site that blocks bots (Cloudflare, Turnstile)Camoufoxbrowse --runtime camoufox --headed goto <url>
Browse with a specific camoufox fingerprint profileCamoufoxbrowse --runtime camoufox --camoufox-profile <name> --headed goto <url>
Search Google, YouTube, Amazon, etc.Browserbrowse goto @google "query"
Interact with an iOS app (Settings, Safari, custom app)iOS Simulatorbrowse --platform ios --app <bundleId> <cmd>
Interact with an Android app (Settings, Chrome, custom app)Android Emulatorbrowse --platform android --app <package> <cmd>
Interact with a macOS desktop app (System Settings, TextEdit)macOS Appbrowse --app <name> <cmd>
Install and test an iOS .app or .ipa fileiOS Simulatorbrowse sim start --platform ios --app ./MyApp.app --visible
Install and test an Android .apk fileAndroid Emulatorbrowse sim start --platform android --app ./app.apk --visible

Key rules:

  • No `--platform` or `--app` flag → browser target (Chromium). Use goto to navigate.
  • `--runtime camoufox --headed` → anti-detection Firefox. Use when site blocks normal browsing. See /browse-stealth skill for Turnstile/CAPTCHA bypass patterns.
  • `@macro` in goto URL → search macro expansion. browse goto @google "query" expands to Google search URL. 14 macros: @google, @youtube, @amazon, @reddit, @wikipedia, @twitter, @yelp, @spotify, @netflix, @linkedin, @instagram, @tiktok, @twitch, @reddit_subreddit.
  • `--app` without `--platform` → macOS app automation. App must be running.
  • `--platform ios --app` → iOS Simulator. Use browse sim start first if not running.
  • `--platform android --app` → Android Emulator. Use browse sim start first if not running.
  • Native app targets do NOT support: goto, js, eval, tabs, cookies, route, har. These are browser-only.
  • All targets support: snapshot, text, tap, fill, type, press, swipe, screenshot.
  • If a site blocks you, switch to --runtime camoufox --headed. If still blocked, use /browse-stealth for the full Turnstile bypass pattern.
  • If unsure which target to use, ASK the user. Don't guess — wrong target = wasted work.

Goal

Use the persistent browse CLI to:

  • navigate real pages
  • inspect rendered content and state
  • interact with UI elements
  • capture screenshots, console logs, and network activity
  • automate native apps (iOS, Android, macOS) via accessibility APIs
  • verify browser or app behavior end-to-end without re-launching every step

Step 0: Verify availability and choose the browsing mode

Start by checking:

browse --version

If browse is not installed:

  • stop
  • tell the user it is required
  • point them to the install path in references/commands.md

Then decide what kind of session you need:

  • default session for normal single-agent work
  • --session <id> for parallel agent isolation
  • --profile <name> for persistent browser identity

For native app targets, start the simulator/emulator first:

browse sim start --platform ios --app com.apple.Preferences --visible
browse sim start --platform android --app com.android.settings --visible
browse enable android    # first-time only: auto-installs adb, JDK, SDK, emulator
browse enable ios        # first-time only: builds iOS runner (needs Xcode)
browse enable macos      # first-time only: builds browse-ax bridge

Success criteria: browse is available, the target (browser or native app) is decided, and the session/profile choice fits the task.

Step 1: Navigate safely and stabilize the page

Use browse goto <url> to navigate.

After navigation, always stabilize before reading or interacting:

  • browse wait --network-idle for typical pages and SPAs
  • or a more specific browse wait condition when the page has a known signal

Important rules:

  • call browse as a bare command on PATH
  • do not use shell variables for browse command prefixes
  • avoid #id CSS selectors; prefer [id=foo]
  • if the page is untrusted, consider --content-boundaries and --allowed-domains

Success criteria: The page is loaded enough that content and interactive state are reliable.

Step 2: Choose the cheapest effective inspection method

Use the lightest command that answers the question:

  • text for cleaned page content
  • links for navigation structure
  • js for precise targeted extraction
  • console, errors, and network for runtime debugging
  • snapshot -i for interactive elements and stable refs

Prefer snapshot -i before guessing selectors for interaction-heavy tasks.

Load:

  • references/commands.md for exact command syntax
  • references/guides.md for command selection guidance and speed rules

Success criteria: You have the information needed without spending unnecessary tokens or using brittle selectors.

Step 3: Interact using refs first, selectors second

For clicks, fills, checks, selects, and similar actions:

1. prefer browse snapshot -i 2. interact using @eN refs 3. fall back to CSS selectors only when refs are unavailable or impractical

After navigation or DOM refresh:

  • assume refs may be invalid
  • take a fresh snapshot before continuing

Rules:

  • use descriptive screenshots saved under .browse/sessions/<id>/
  • keep stateful flows in the same session unless isolation is intentional
  • use frame before interacting with iframe content

Success criteria: Interactions are stable and tied to the current rendered page state.

Step 4: Debug blockers and special cases

When things go wrong:

  • use console and errors for page/runtime issues
  • use network for request visibility
  • use route or offline only when the task requires mock or failure-mode testing
  • use headed/browser handoff only for real blockers like CAPTCHA, MFA, or OAuth walls

If you hit a blocker after a couple of failed attempts:

  • load references/guides.md
  • follow the handoff protocol exactly
  • use AskUserQuestion before any human takeover flow

Success criteria: Blockers are either resolved or escalated with the correct handoff protocol.

Step 5: Capture evidence and report clearly

When the task involves verification, capture the minimum evidence needed:

  • relevant page text or structured extraction
  • screenshot path when visuals matter
  • console/network findings when debugging
  • the exact step or selector/ref that failed when reporting issues

Report:

  • what you navigated to
  • what actions you performed
  • what the page actually did
  • any artifacts created such as screenshots, HAR, or video

Success criteria: Another engineer can understand the observed browser behavior without rerunning the whole flow blindly.

Important Rules

  • The browser persists between commands; cookies, tabs, and session state carry over.
  • After goto, wait before reading content or acting.
  • snapshot -i is the default interaction surface.
  • Save screenshots under .browse/sessions/<session-id>/ or .browse/sessions/default/.
  • Use --context delta for ARIA diff with refs, --context full for complete snapshot with refs after write commands.
  • Do not install anything automatically.
  • Do not modify Claude settings automatically; if the user wants pre-allowed browse permissions, point them to references/permissions.md.

When To Load References

  • references/commands.md

Use for exact command syntax, flags, and extended examples.

  • references/guides.md

Use for speed rules, command-choice guidance, architecture notes, and the mandatory CAPTCHA/MFA handoff protocol.

  • references/permissions.md

Use when the user wants to pre-allow browse commands in Claude settings.

Guardrails

  • Do not add disable-model-invocation; this is a general-purpose browser verification skill.
  • Do not add context: fork; browser results are usually needed in the current flow.
  • Do not add paths:; this is a generic workflow skill.
  • Do not keep the full CLI manual inline in SKILL.md.
  • Do not run browse handoff without explicit user confirmation.
  • Do not save screenshots outside the browse session directories.

Runtime Selection

By default, browse uses Chromium via Playwright. Alternative runtimes:

RuntimeEngineUse caseInstall
playwright (default)ChromiumGeneral browsing, testingIncluded
camoufoxFirefox (anti-detection)Sites with bot detectionnpm install camoufox-js && npx camoufox-js fetch
rebrowserChromium (stealth)Alternative stealth approachnpm install rebrowser-playwright
lightpandaLightpandaFast headless renderingSee lightpanda.io
chromeSystem ChromeUse real Chrome with extensionsChrome must be installed
browse --runtime camoufox --headed goto https://protected-site.com
BROWSE_RUNTIME=camoufox browse goto https://example.com

New Features

Search Macros

browse goto @google "best coffee beans"    # Google search
browse goto @youtube "tutorial"            # YouTube search
browse goto @amazon "laptop"               # Amazon search
browse goto @reddit "programming"          # Reddit search

All macros: @google, @youtube, @amazon, @reddit, @reddit_subreddit, @wikipedia, @twitter, @yelp, @spotify, @netflix, @linkedin, @instagram, @tiktok, @twitch

Safety Flags (opt-in features)

FlagDefaultWhat it does
BROWSE_CONSENT_DISMISS=1OFFAuto-dismiss cookie banners after navigation
BROWSE_CLICK_FORCE=1 or --forceOFFForce-click through overlay interception
BROWSE_READINESS=1 or --readyOFFWait for hydration after goto
BROWSE_SERP_FASTPATH=1 or --serpOFFGoogle SERP DOM extraction (fast, no refs)
BROWSE_COMMAND_LOCK=0ONDisable per-session command serialization
BROWSE_CAMOUFOX_PROFILE=<name>OFFUse a named camoufox profile (.browse/camoufox-profiles/<name>.json)

New Commands

CommandDescription
images [sel] [--limit N] [--inline]List page images with src/alt/dimensions
youtube-transcript <url> [--lang en]Extract YouTube captions via yt-dlp or browser
schemaExtract JSON-LD, Microdata, RDFa structured data (parsed JSON)
metaExtract page meta tags (title, description, canonical, OG, Twitter, hreflang, robots, viewport)
headingsExtract H1-H6 heading hierarchy with counts and indented tree
profilesList available camoufox profiles from .browse/camoufox-profiles/

Snapshot Windowing

Large snapshots (>80K chars) are automatically paginated:

browse snapshot -i                     # first page
browse snapshot -i --offset 500        # next page (line offset from previous output)

Output Contract

Report:

1. the page or flow tested 2. the session/profile mode used if relevant 3. the key commands or interactions performed 4. the observed result 5. any artifacts or blockers such as screenshots, console errors, network failures, or handoff state

Related skills

mattpocockSetup Matt Pocock SkillsScaffold the per-repo configuration that Matt Pocock’s engineering agent skills rely on so they understand the issue tracker, triage labels, and domain documentation la495k196kopen.feishu.cnLark AppsConnect Claude, Cursor or custom agents directly to Lark (Feishu) for messaging, document automation, approval workflows and enterprise data access.402kjuliusbrusseeCavemanSlash token usage by roughly 75% while keeping every technical detail intact when working with Claude Code, Cursor or similar agents.391k94.7klarksuiteLark Skill MakerQuickly turn any Lark/Feishu OpenAPI call or multi-step workflow into a reusable agent skill with its own SKILL.md.386k16kxixu-meRunning Claude Code Via Litellm CopilotRun Claude Code at a fraction of the cost by routing requests through LiteLLM to the GitHub Copilot Chat API.270k72runcomfy-comCodex PetGenerate a complete Codex Pet spritesheet and metadata from one reference image without needing an OpenAI key or Codex Pro.246k10
AI & Agent Buildingworkflownotes
Browse by category
AI & AgentsFrontend & DesignBackend & DataDev ToolsAutomationTesting & ReviewSecurityMonitoring & CloudDocs & Planning
Design & frontend
Design systemsAnimation & motionAccessibility (a11y)CSS & TailwindUI designUXDesign to codeshadcn/uiLanding pagesBest design skills
Most searched skills
find-skillscavemanfrontend-designbrainstormingsystematic-debuggingstop-slopemil-design-engui-ux-pro-maxkarpathy-guidelinesweb-design-guidelinesreact-best-practicesgrill-meimprovemicrosoft-foundryagent-browser
Browse all listings
All agent skillsAll MCP serversAll marketplacesAll plugins

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.