Agent skill · pinchtab
pinchtab
Use this skill when a task needs browser automation through PinchTab: open a website, inspect interactive elements, click through flows, fill out forms, scrape page text, reuse a dedicated automation profile with user approval, export screenshots or PDFs, manage multiple browser instances, or fall back to the HTTP API when the CLI is unavailable. Prefer this skill for token-efficient browser work driven by stable accessibility refs such as `e5` and `e12`.
What it needs
About 11k tokens when loaded.
What this skill does
Browser Automation with PinchTab CLI-first browser skill. Use pinchtab commands. Core Workflow 1. Create a session: export PINCHTABSESSION=$(pinchtab session create --agent-id myagent) — do this once before any browser command. 2. Navigate: pinchtab nav <url> --snap — auto-starts the local server if needed, then returns tab ID + interactive snapshot in one call. 3. Interact: pinchtab click <ref> --snap-diff — returns OK + only changed elements (most token-efficient). Click behavior: omit --mode for the normal click path, use --mode dom, or use --mode dispatch. Treat --mode as a broad, low-level escape hatch. Occlusion workaround is the common case: pinchtab click <ref> --mode dom or pinchtab click <ref> --mode dispatch --mode and --humanize are mutually exclusive. 4. For read-only observation: pinchtab text when you won't act on refs. Key optimization: Use --snap-diff on nav, click, fill, select, press, scroll, back, forward, reload to get only added/changed/removed elements — most token-efficient for multi-step flows. Use --snap when you need the full snapshot (e.g., first navigation, or after major page changes). --text is available on click, fill, select, press, back, forward, reload (but NOT on nav or scroll) when you need prose content for verification (skips snap, returns page text directly). dblclick does not support any observation flag — run a separate snap after. --snap-diff returns the same compact format as snap, but with change markers and a header showing counts: [+] = added, [~] = changed, removed refs listed at end. All valid refs are shown — no need to remember previous snapshot. Do not follow with redundant snap; only call text when you need prose content. Fallback observation (when --snap wasn't used): pinchtab snap — interactive elements + headings in compact format (default). pinchtab snap [selector] — scope the current-tab snapshot to one element. pinchtab snap --full — all nodes as JSON (for debugging). …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills pinchtab/pinchtab--b82d59