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

chromium-debug-use

GitHub

用于在用户明确授权后，连接本地已运行的 Chromium 系列浏览器进行实时页面检查与轻量交互。支持快照、HTML获取及DOM操作，旨在替代重型自动化工具，并在理解流程后移交至 Playwright 等专业工具。

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

触发场景

需要检查本地 Chromium 浏览器中的当前页面状态需要在不启动新自动化实例的情况下与现有浏览器标签页进行轻量交互

安装

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

更多选项

非标准路径

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

不安装直接使用

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.