Adonis0123/adonis-skills / skills/chrome-dev-mcp
chrome-dev-mcp
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.4 KB |
| evals/evals.json | config | 14.7 KB |
| evals/trigger-eval.json | config | 3.3 KB |
| references/host-verification.md | markdown | 5.9 KB |
| references/maintenance.md | markdown | 4.5 KB |
| references/profile-identity.md | markdown | 1.6 KB |
| references/uxc-facade.md | markdown | 7.5 KB |
| scripts/configure-local.zshexecutable | script | 1.8 KB |
| scripts/ensure-connection.zshexecutable | script | 2.6 KB |
| scripts/host-acceptance.zshexecutable | script | 6.9 KB |
| scripts/install-uxc.zshexecutable | script | 4.0 KB |
| scripts/lib/load-config.zshexecutable | script | 438 B |
| scripts/lib/readiness-envelope.zsh | script | 1.5 KB |
| scripts/lib/uxc-link-contract.zsh | script | 1.5 KB |
| scripts/lib/uxc-owned-binary.zsh | script | 2.8 KB |
| scripts/lib/uxc-release.zshexecutable | script | 642 B |
| scripts/setup-uxc-link.zshexecutable | script | 3.1 KB |
| scripts/test/host-acceptance.test.mjs | script | 5.3 KB |
| scripts/test/readiness-envelope.test.mjs | script | 2.7 KB |
| scripts/test/ui-acceptance.test.mjs | script | 5.2 KB |
| scripts/uxc-readiness.zshexecutable | script | 2.7 KB |
references/maintenance.md
View on GitHub# Runtime and skill maintenance
Use this runbook for a requested Chrome DevTools MCP upgrade or a detected update that the user has authorized you to apply. Maintain instructions and helpers in `adonis-skills/skills/chrome-dev-mcp/`; installed copies are distribution targets. A version check alone is not an upgrade request. Within an authorized upgrade, complete routine reversible steps without repeated approval.
## Check and preserve
1. Record the installed exact runtime version, wrapper options, owned UXC pin, skill revision, and active shared child. Inspect the current upstream release notes and package requirements. Upgrade UXC only when its changes help this workflow or resolve an observed defect; evaluate its ownership hashes and session contract separately.
2. Preserve the current runtime, wrapper, skill files and focused working-tree diff. Use a task-specific evidence directory outside published skill source. Record rule hashes, host, model when known, commands, results and unverified boundaries; omit page payloads and credentials.
3. Install a candidate at an exact version in a separate staging directory. Verify package integrity through the package manager, required flags, page routing schema and filesystem restrictions before replacing the active runtime. Never switch the wrapper to a moving `@latest`, auto-connect, unrestricted paths or a different browser profile.
## Activate and verify
1. Replace the owned runtime using a recoverable swap. Update only flags required by the new version. Inspect the corresponding UXC session before replacing that child; allow active work to finish where feasible and report any interrupted calls. Keep browser windows and unrelated sessions running. Refresh only this endpoint's schema cache.
2. Run installed `zsh scripts/uxc-readiness.zsh` twice. Require shared transport success and reuse on the second call. Read live schemas; confirm explicit `pageId` is required for page-scoped operations. Do not accept stale cached help as new-version proof.
3. Run at least three concurrent read-only calls from different working directories through `chrome-dev-mcp-cli`. Compare OS MCP processes with UXC sessions before and after: the shared child PID must remain stable and calls must reuse it. Inspect extra native children by parent host; follow [host-verification.md](host-verification.md), never a broad process-name kill.
4. On disposable background pages, verify explicit-page reads return the correct page, then verify a snapshot or another requested DevTools capability. Close only test pages you created. Keep real-pointer tests serialized across the desktop.
5. Compare equivalent workloads before claiming a speed improvement. Record warm versus cold calls separately. A few elapsed times are observations, not a benchmark. If required acceptance fails, retain evidence and restore the prior compatible runtime/wrapper rather than weakening identity or permissions.
## Deliver the reusable change
Run the focused repository regression tests and `pnpm skills:finalize -- skills/chrome-dev-mcp` from the source repository. Synchronize intended installed copies and verify content equality and host discovery. Keep current-session loading and actual per-host model calls separate; mark untested hosts `UNVERIFIED`.
Preserve the existing scheduler's role rather than creating another one. A scheduled run only checks Chrome DevTools MCP versions and never installs. Where the local updater offers a single-item upgrade (for example `skills-update.sh --only chrome-devtools-mcp` behind the Skills Manager row's Update button), it covers the scriptable part of this runbook: a release cooldown, an exact-version staged install, flag and `pageId` schema checks, a release of this endpoint's own UXC session once it has no call in flight (`uxc daemon session kill <session_key>`, postponing instead when calls keep running or a server outside UXC is alive), the switch, two readiness calls, and an automatic restore of the previous runtime on failure. It never stops the UXC daemon, Chrome or any other session, and never signals a process. After it reports an update, still do the steps it cannot judge: read the release notes, run the concurrent multi-directory calls, and verify the requested DevTools capability on a disposable page. Turning the scheduled check into an unattended upgrader remains a separate scope decision. Report installed version, runtime acceptance, process count, distribution, rollback location and remaining limits. Commit or push only when requested.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |
| 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: 198k | Updated | Claude CodeCodex | Verified | Install |