- name
SKILL.md
スキルファイルは公開元のリポジトリに置かれたままです。
コピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-browser -a cursor -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-browser -a claude-code -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-browser -a codex -yコピーしたコマンドをターミナルに貼り付けてください。この SKILL.md がそのエージェントにインストールされます。
npx skills add Hacker-Valley-Media/Interceptor --skill interceptor-browser -a grok -yコピーしたメッセージを Grok Bot のチャットで送信してください。Bot がこの SKILL.md を GitHub から取得し、すべての Bot が共有するスキルに追加します。
Install this skill: https://github.com/Hacker-Valley-Media/Interceptor/tree/HEAD/.agents/skills/interceptor-browser公開元より
Agent-operator skill for the Browser surface of Interceptor. Use the interceptor CLI (no prefix) to drive a live Chrome, Brave, or Safari session: pages, network, scene graph, monitor, screenshots. For native macOS apps load interceptor-macos instead.
Agent-operator skill for the Browser surface of Interceptor. Use the interceptor CLI (no prefix) to drive a live Chrome, Brave, or Edge session: pages, network, scene graph, monitor, screenshots. For native apps load interceptor-desktop instead.
Agent-operator skill for the Browser surface of Interceptor. Use the interceptor CLI (no prefix) to drive a live Chrome or Brave session: pages, network, scene graph, monitor, screenshots. For native apps load interceptor-desktop instead.
This installed skill is self-contained. Source checkouts also have AGENTS.md, but packaged users may only have the skill directory below /Library/Application Support/Interceptor/skills.
This installed skill is self-contained. Source checkouts also have AGENTS.md, but packaged users may only have the skills folder in the Interceptor install folder (%LOCALAPPDATA%\Programs\Interceptor\skills).
This installed skill is self-contained. Source checkouts also have AGENTS.md, but packaged users may only have the skill directory below ~/.local/share/interceptor/skills.
Assume the person is using this browser and this Mac while you work. Never change the tab showing in a window they are using, never focus a window, and never bring the browser forward to make your own work easier or to test something. Stop at the first rung that works: Assume the person is using this browser and this computer while you work. Never change the tab showing in a window they are using, never focus a window, and never bring the browser forward to make your own work easier or to test something. Stop at the first rung that works:
open, read, act, click, type, screenshot, net, and the rest run on a hidden tab.interceptor tab keepalive <id> when a page will not render while hidden (it reads visible and runs its animation frames).interceptor window new [url] opens a background window and moves your tab group into it, and interceptor window new --tab <id> does the same around a tab you already have. The tab showing there paints like a foreground tab even when the window is fully covered. tab switch changes only that window, but a tab switched in while the window is covered stays hidden: use window new --tab <id> for it.interceptor window new [url] opens a background window and moves your tab group into it, and interceptor tab switch <id> there changes only that window. Read the page again to confirm it rendered; a covered window painting in the background is measured on the Mac only.interceptor click <ref> --trusted (also type, keys) reaches any tab on a full install. A tab that is not showing gets a background window of its own for the input and goes back where it was, and the result says whether the page reported it. No tab switch in the user's window, no window focus.tab switch in a window the user is working in and window focus are last resorts. Say so first, do one fast batch, and put the previous tab back.
--trusted (or --os), read interceptor capabilities. data.osInput reports availability, foreground/background support and refusal reasons for click, key, type and move. The legacy layers.os_input flag requires click, key and type; it can be true while move is unavailable.--trusted (or --os) when one native click is required.window new --group my-group avoid the browser crash. Groups already moved between windows by 2.1.11, or moved by dragging the whole group, can still crash when closed. Save your work and record the URLs, restart the browser, then restore the session or reopen the URLs in a fresh named group. Use window new --group my-group for later moves. Updating the extension alone does not clear the old browser state.open, websearch, read, act, inspect) before low-level verbs.websearch "<query>" searches through the browser's configured default provider in an Interceptor-managed background tab and returns the provider page. It is not Google-specific. find "<query>" never navigates: it searches the current page's complete rendered-text snapshot plus accessible elements. Use find --text-only for passages and find --elements-only/--role for controls.--any-tab unless the user explicitly authorizes acting outside those groups.s-<hash16>, so bare commands reuse one tab per session and the idle sweeper has a cleanup unit. is the harness-neutral contract; Interceptor also detects verified Maestro, Claude Code, and Codex session variables. Open your own page first (). While your session group is empty, input (click, type, keys, eval, navigate, tab close) refuses instead of landing on the tab the user is viewing; a read may answer from that tab with a line, or refuse when other agents' groups are open. Pass only when the user asked you to act on their tab. A browser without tab groups keeps the old fallback. (or empty ) explicitly uses Interceptor's shared default group; it does not remove managed grouping. , so give each lane a unique or . Explicit and non-empty provide hard isolation by default: resolution stays within that group and cross-group targets are rejected unless is explicitly authorized. shows the automatic label and marks yours . Every other group belongs to another agent that may still be working: leave it alone, even when asked to clean up; Interceptor closes it after it sits unused. Close another agent's group only when the user names that group.interceptor contexts # 0. Browser profiles connected. More than one? Pick the lane's once:
export INTERCEPTOR_CONTEXT=<id> # (or pass --context <id> on every call; the flag overrides the env)
interceptor status --verbose # 1. Daemon + extension alive per context; eval --main availability
interceptor websearch "example docs" # 2a. Default provider → managed background results tab
interceptor open "https://example.com" --tree-format compact # 2b. Or open a known URL → wait + compact tree + text
interceptor read # 3. Current state (re-read after any mutation)
interceptor act e5 # 4. Click ref e5 (refs come from `read`)
interceptor act e7 "example user" # 5. Type into ref e7
interceptor act e7 "query" --submit # Type and submit the form in one call (a typed Enter never submits)
interceptor inspect # 6. Tree + text + network in one read
If your harness truncates tool results, also set INTERCEPTOR_TREE_MAX_CHARS / INTERCEPTOR_TEXT_MAX_CHARS once (defaults 50000 / 8000); a truncated tree or text ends in a marker that says how to scope or widen. A stale element [eN] error means the element left the DOM and nothing was clicked or typed; refs never re-bind to look-alike elements, so read again. A timeout … The outcome is unknown means the action may still land; read before retrying it.
Inside this repo without interceptor on PATH, use ./dist/interceptor ....
Each workflow is a complete self-contained "you are doing X" procedure. Open the file when the task matches.
If the target is outside the page - a native dialog, browser chrome (URL bar, profile picker), Save/Open file picker, OS notification, or any non-browser macOS app - load interceptor-macos instead.
If the target is outside the page - a native dialog, browser chrome (address bar, profile picker), Save/Open file picker, OS notification, or any other app - load interceptor-desktop instead.
If the target is an Electron / Chromium desktop app's web contents (Slack, VS Code, Notion, Descript, etc.), use the CDP/app reference from interceptor-macos: references/cdp-app.md.
If the target is an Electron / Chromium desktop app's web contents (Slack, VS Code, Notion, Descript, etc.), use interceptor desktop cdp from interceptor-desktop.
If the task is breadth research — "investigate / go deep on / find everything about X" across many sources — load interceptor-research, which layers a planner loop, source ledger, and verification pass on top of this surface.
A browser job is complete only when:
read/inspect) taken after the last mutation, not from the action's success alone;interceptor group close <label>) and interceptor group list no longer shows it — the list output is the proof, not the close command's exit code.Report what failed or was skipped as prominently as what worked. Never report only the happy fields.
Drive a signed-in Chrome / Brave / Safari session via the interceptor CLI: open/read pages, click, type, inspect DOM/text/network, automate rich browser editors and scene graphs, capture WebSocket/Bea
---name: interceptor-browserdescription: Drive a signed-in Chrome / Brave / Safari session via the interceptor CLI: open/read pages, click, type…---# .agents/skills/interceptor-browser/SKILL.md概要
Drive a signed-in Chrome / Brave / Safari session via the interceptor CLI: open/read pages, click, type, inspect DOM/text/network, automate rich browser editors and scene graphs, capture WebSocket/Beacon/BroadcastChannel traffic, record/replay flows, take VLM-budgeted screenshots, compare pages, and route to specific browser contexts with --context. Use for browser page content, tabs, forms, SPA extraction, request overrides, page communication capture, and deployment checks. Not for native macOS apps, Electron desktop app web contents, OS dialogs, browser chrome, or large scraping.
よくある質問
公開元から .agents/skills/interceptor-browser/SKILL.md をダウンロードするか、パスをコピーしてリポジトリを開いてください。PlugMCP はスキルを掲載するだけで、ファイルはホストしていません。
公開元は https://github.com/Hacker-Valley-Media/Interceptor で管理しています。
Claude、Cursor、Codex、Grok Build は、公開元のリポジトリから追加した SKILL.md を読み込めます。Grok Bot は、チャットでスキルの GitHub フォルダーのリンクを送るとインストールします。
INTERCEPTOR_SESSION_IDinterceptor open <url>warning:--any-tab--shared-groupINTERCEPTOR_GROUP=--group lane-<n>INTERCEPTOR_SESSION_ID--group <label>INTERCEPTOR_GROUP--any-tabinterceptor group list"own": trues-interceptor group close (no label closes your own) when the job is done. The extension auto-closes groups after 10 minutes without tab activity by default; metadata polls such as status and group list do not keep a group alive. The timeout is configurable in the extension popup and is crash safety, not a substitute for cleanup.open navigates the group's most-recent tab by default (address-bar semantics; the reused tab stays in the background unless you add --activate). Pass --no-reuse when you need to keep the current page and open another, for example before comparing two pages or fanning out. tab new creates by default; explicit --reuse navigates the group's most-recent tab. Shared-default open creates by default.interceptor open <url>, interceptor tab new <url>, and interceptor window new [url] create background tabs and windows by default. Only open --activate, tab new --activate, window new --activate, tab switch <id>, and window focus <id> intentionally move browser focus. New tabs are created in the window that already holds Interceptor groups (the caller's own group's window first), not the window the user is focused on; the tab new/open result carries windowId.interceptor window new [url] gives your tab group its own background window: the new tab is the one showing there, and the group's other tabs move with it, so later open calls land in that window too. A groupWarning in the result means you are on the shared default group, which does not move; pass --group <label>.document.hidden): run interceptor tab keepalive <id>, then read again. The page reads as visible and its animation frames run; the user's view is untouched. Limits: IntersectionObserver and ResizeObserver callbacks still wait for a real paint, and background timers stay at Chromium's rate (about once per second after 10 s). When keepalive is not enough (a video that stays stalled, a virtualized grid with zero rows), put the page in your own window with interceptor window new <url>; do not tab switch in the user's window. Measured: a YouTube video stalled in a hidden tab even with keepalive and played within 3 s in its own background window; a virtualized options grid rendered 0 rows hidden and 16 in its own window; a Google Doc painted with keepalive alone.document.hidden): run interceptor tab keepalive <id>, then read again. The page reads as visible and its animation frames run; the user's view is untouched. Limits: IntersectionObserver and ResizeObserver callbacks still wait for a real paint, and background timers stay at Chromium's rate (about once per second after 10 s). When keepalive is not enough (a video that stays stalled, a virtualized grid with zero rows), put the page in your own window with interceptor window new <url>; do not tab switch in the user's window. Check that it rendered with read; the measurements behind this are from the Mac.interceptor click <ref> --trusted is delivered to the tab's window in the background, and a tab that is not showing is moved to a background window of its own and back. The result ends the page received it, or fails with the page reported none of it: read the page before sending anything again, because Interceptor never sends input twice for you. If it did not change, the usual cause is that the person is using the browser right then, so fall back to synthetic click or try again later. A tab navigated or switched to in a covered window can also miss input: run interceptor window new --tab <id>, then send it again. A ref inside an iframe (e<frame>_<n>) works the same way. If a tab switch in the user's window ever was the only way, tab switch <prior> back to the tab that was showing is allowed even though it is unmanaged.interceptor contexts and pass --context <id>. The person can save a default once with interceptor contexts default <name>; it is used only when a command names no context and several are connected.safari; route with interceptor --context safari <verb>. If it is absent, verify the notarized Interceptor Safari extension is enabled before attempting page commands. Safari's enable switch is a protected user-present action; never try to bypass its Touch ID/password gate.read, tree, text, inspect, scene) before screenshots. Open references/screenshot-policy.md before screenshot-heavy work.interceptor type <ref> --secret <name>. The daemon checks the tab's host against the secret's allowlist (browser:<host>) and the monitor and tree/forms reads use ***SECURE***. Password fields are masked regardless of their source. A marked element stays sensitive until the document is replaced; a new plain-text DOM node does not inherit that marker. Never put a credential in a literal type call or ask the user to paste one into chat; ask them to run interceptor macos secret register <name> --target browser:<host>.interceptor type <ref> --secret <name>. The daemon checks the tab's host against the secret's allowlist (browser:<host>) and the monitor and tree/forms reads use ***SECURE***. Password fields are masked regardless of their source. A marked element stays sensitive until the document is replaced; a new plain-text DOM node does not inherit that marker. Never put a credential in a literal type call or ask the user to paste one into chat; ask them to run interceptor desktop secret register <name> --target browser:<host>.interceptor type <ref> --browser-login <host> [--user] [--browser <key>] (password by default, username with --user; --browser restricts to one browser, default searches all installed). The daemon reads and decrypts the saved login; the requested host must match the live tab, so a page only ever fills its own credential. interceptor browser creds list [--host <host>] [--browser <key>] shows which hosts have a saved login (host + username + browser only, no passwords). macOS only; the value is kept off argv and delivery logs, and tree, forms, and scene reads mask it. This does not redact arbitrary eval, screenshots, network/storage capture, or credentials copied elsewhere by page code.--json only when piping into scripts or when a downstream tool needs a machine-readable contract.screenshot --out <path> writes that file (--save writes an auto-named one in the current directory). Fix the flag instead of setting INTERCEPTOR_LAX_FLAGS=1.error: … and exits non-zero (every browser verb, including back/forward with no history). Check $? in scripts; do not grep stdout for error: to detect failure.eval --main can recover from strict CSP by stripping the blocking header and reloading the tab. The result discloses that reload and the CLI prints a warning: line for it, on success and on failure; save shares the same recovery. Treat it as state-changing because unsaved page state is lost. Pass --no-reload on a page whose state matters to get the CSP error instead; task verification always refuses the reload.query, exists, count, click --selector, wait, table, attr, style, rect, screenshot --selector) search open and closed shadow roots after the light DOM, so a control inside a web component is reachable by selector; light-DOM matches keep their order and --nth its meaning.interceptor reload --context <id>: an unpacked copy picks up the installed files; a Chrome Web Store copy only asks the store for an update and keeps its version until the store publishes the new one. interceptor contexts --verbose shows which copy (store or unpacked) and version each context runs.--context safari can briefly report "context 'safari' not found" between commands and then self-heal. Re-issue the command rather than treating one transient drop as failure. Note two Safari capability limits: headers add only modifies recognized standard headers (arbitrary X-… names are refused — use override instead), and passive net capture reflects genuine page traffic, not requests you originate from eval (its world is separate from the page's).workflows/cook-on-top-of-pages.md| "Cook" a live page in-place — banners, HUDs, overlays that track real DOM, full-screen takeovers, over the real session |
workflows/override-xhr.md | Mutate a request before it hits the server — change params, force a status, throttle |
workflows/capture-page-communication.md | Capture WebSocket, Beacon, and BroadcastChannel activity without CDP |
workflows/record-and-replay.md | Learn a real user flow, export a replay plan, run it back |
workflows/screenshot-for-vlm.md | Take a screenshot the model will actually understand — VLM-budgeted, WebP, on-disk |
workflows/multi-page-compare.md | Compare facts across multiple pages (e.g. "who designed Python vs JavaScript") — sequential open --text-only per page |
| Monitor session behavior, replay-plan generation, cross-tab/focus-follow notes |
references/command-catalog.md | Full browser command surface with flags and examples |
references/screenshot-policy.md | VLM-aware screenshot budget table; agent-default recipe |