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.

scripts/lib/readiness-envelope.zsh

View on GitHub
#!/bin/zsh

# Classify one readiness `list_pages` call. Prints OK or one error class.
# A UXC envelope with ok=true proves transport only; the wrapped MCP tool
# reports its own failure in data.isError (for example "Could not connect to
# Chrome"), so both must pass before readiness is claimed.
chrome_dev_mcp_classify_readiness() {
  local stdout_file="$1" stderr_file="$2" exit_code="$3" combined

  if ! /usr/bin/jq -e . "$stdout_file" >/dev/null 2>&1; then
    print -- "parse_error"
    return 0
  fi

  if [[ "$exit_code" -eq 0 ]] && /usr/bin/jq -e \
    '.ok == true and .protocol == "mcp" and .operation == "list_pages" and (.data.isError != true)' \
    "$stdout_file" >/dev/null 2>&1; then
    print -- "OK"
    return 0
  fi

  combined="$(<"$stdout_file")$(<"$stderr_file")"

  # Checked before the wrapper match: a tool-level error envelope still names
  # the wrapper as its endpoint.
  if /usr/bin/jq -e '.ok == true and .data.isError == true' "$stdout_file" >/dev/null 2>&1; then
    if [[ "$combined" == *"Could not connect to Chrome"* ]]; then
      print -- "chrome_unreachable"
    else
      print -- "tool_error"
    fi
    return 0
  fi

  if [[ "$combined" == *"currently using daemon exclusive key"* ]]; then
    print -- "exclusive_key_busy"
  elif [[ "$combined" == *"chrome-devtools-mcp-safe"* ]]; then
    print -- "wrapper_fail_closed"
  elif [[ "$combined" == *"timed out"* || "$combined" == *"timeout"* ]]; then
    print -- "timeout"
  else
    print -- "uxc_envelope"
  fi
}
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