Skip to content

Adonis0123/adonis-skills / skills/chrome-dev-mcp

chrome-dev-mcp

Verified

Use this skill when the user invokes /chrome-dev-mcp or asks for Chrome DevTools MCP, CDP, list_pages/select_page, UXC packaging for Chrome DevTools, DOM snapshots, Console, Network, Performance, Lighthouse, heap analysis, browser-internal debugging, connection recovery, or correct-Chrome validation across Claude Code, Codex, Grok Build/Grok002, Cursor CLI, Hermes, or WorkBuddy. Use it when the evidence is Chrome-specific (Lighthouse, a full trace, heap data) or the caller has no page session yet; a page already open in ego-browser keeps its own Console and request diagnosis. Also use it as the verification step right after the user or this session changes a web UI or asks to accept or check a page: collect a screenshot, Console, and Network evidence before calling it done. Do not use it for ordinary navigation, form filling, scraping, or desktop UI unless browser-internal signals or UI-change acceptance are required. A passing readiness or list_pages check proves the connection only, never the change.

references/profile-identity.md

View on GitHub
# Profile identity gate

Read this reference only when the user reports the wrong Chrome, profile, or login context.

## Define identity outside the public skill

Let the configured safe wrapper own the endpoint and process contract. Require it to verify:

- one exact loopback endpoint;
- a matching loopback WebSocket address;
- the intended browser binary and listener process;
- the configured isolated user-data directory or equivalent profile identity.

Do not encode a machine-specific endpoint, executable, or profile path in the published skill. Store those values in the one-time local configuration created by `scripts/configure-local.zsh` and in the safe wrapper itself.

## Check and recover

Run `scripts/ensure-connection.zsh --check` from the installed skill. Interpret only its sanitized sentinels:

- `CHROME_DEV_MCP_CONNECTION=READY` proves the configured isolated profile owns the endpoint. It does not prove website login identity.
- `CHROME_DEV_MCP_CONNECTION=NOT_READY` reports a bounded reason such as `ENDPOINT_UNAVAILABLE`, `WRONG_BINARY`, or `WRONG_PROFILE`.
- Prefer the wrapper's stable `CHROME_DEVTOOLS_MCP_SAFE_REASON` marker over matching human-readable stderr. Keep text matching only as a compatibility fallback for older wrappers.
- `--recover` may launch only the configured isolated profile when the endpoint is absent.
- A wrong binary or profile fails closed. Do not call `list_pages`, kill the process, scan for another endpoint, or rewrite host registration.

If the user expects a default signed-in browser, ask for an explicit profile-contract decision. Never close or restart the existing browser without authorization.
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall