Agent Skills › marcusquinn/aidevops › chromium-debug-use

chromium-debug-use

GitHub

用于在用户明确授权后，连接并检查已运行的 Chromium 系列浏览器实例。支持快照、HTML获取、JS执行及页面交互，旨在进行轻量级实时调试，随后可移交至 Playwright 等工具进行自动化。

.agents/tools/browser/chromium-debug-use/SKILL.md marcusquinn/aidevops

Trigger Scenarios

需要检查已打开的 Chrome/Edge 等浏览器页面内容需要对现有浏览器会话进行轻量级交互或截图准备将手动调试任务移交至自动化测试工具前

Install

npx skills add marcusquinn/aidevops --skill chromium-debug-use -g -y

More Options

Non-standard path

npx skills add https://github.com/marcusquinn/aidevops/tree/main/.agents/tools/browser/chromium-debug-use -g -y

Use without installing

npx skills use marcusquinn/aidevops@chromium-debug-use

指定 Agent (Claude Code)

npx skills add marcusquinn/aidevops --skill chromium-debug-use -a claude-code -g -y

安装 repo 全部 skill

npx skills add marcusquinn/aidevops --all -g -y

预览 repo 内 skill

npx skills add marcusquinn/aidevops --list

SKILL.md

Frontmatter

{
    "mode": "subagent",
    "name": "chromium-debug-use",
    "description": "Attach to a user's already-open Chromium-family browser for live inspection and light interaction after explicit local approval"
}

Chromium Debug Use

Read tools/browser/chromium-debug-use.md first.

Use This Skill When

The user wants to inspect or lightly interact with something already open in a Chromium-family browser (Chrome, Brave, Edge, Vivaldi, Chromium) before committing to a heavier automation tool.

Workflow

Confirm explicit, user-approved live-session investigation.
If the debug port is not yet open, have the user launch with the flag from tools/browser/chromium-debug-use.md.
Use .agents/scripts/chromium-debug-use-helper.sh version and list to confirm access.
Prefer snapshot, html, and eval to understand the page before using click, type, navigate, or screenshot.
Once the flow is understood, hand off to the best-fit longer-term tool:
- tools/browser/playwright.md — repeatable isolated automation
- tools/browser/dev-browser.md — aidevops-managed persistent profile
- tools/browser/playwright.md — official extension mode for selected tabs in the user's normal browser
- tools/browser/chrome-devtools.md — performance, network, and console inspection

Safety

Local-only and temporary; the user must have enabled the debug path for this investigation.
Prefer loopback endpoints and temporary profiles.
Do not use this path for unrelated tabs or long-lived background control.

Commands

.agents/scripts/chromium-debug-use-helper.sh version
.agents/scripts/chromium-debug-use-helper.sh list
.agents/scripts/chromium-debug-use-helper.sh snapshot <target>
.agents/scripts/chromium-debug-use-helper.sh html <target> [selector]
.agents/scripts/chromium-debug-use-helper.sh eval <target> "document.title"
.agents/scripts/chromium-debug-use-helper.sh click <target> "button.submit"
.agents/scripts/chromium-debug-use-helper.sh type <target> "hello world"
.agents/scripts/chromium-debug-use-helper.sh screenshot <target> /tmp/page.png

Use --browser-url http://127.0.0.1:9222 when the session is not on the default endpoint.