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/install-uxc.zsh

View on GitHub
#!/bin/zsh

set -euo pipefail

script_dir="${0:A:h}"
source "$script_dir/lib/load-config.zsh"
source "$script_dir/lib/uxc-release.zsh"
source "$script_dir/lib/uxc-owned-binary.zsh"

fail_closed() {
  print -u2 -- "STATUS=ERROR"
  print -u2 -- "ERROR_CLASS=$1"
  exit 69
}

if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
  print -- "usage: zsh install-uxc.zsh [--manifest]"
  print -- "  installs the pinned owned UXC binary and its manifest; --manifest prints the pins without downloading"
  exit 0
fi

if [[ "${1:-}" == "--manifest" ]]; then
  [[ $# -eq 1 ]] || fail_closed "unexpected_arguments"
  print -- "UXC_VERSION=$UXC_VERSION"
  print -- "UXC_REPOSITORY=$UXC_REPOSITORY"
  print -- "UXC_SHA256_AARCH64_APPLE_DARWIN=$UXC_SHA256_AARCH64_APPLE_DARWIN"
  print -- "UXC_SHA256_X86_64_APPLE_DARWIN=$UXC_SHA256_X86_64_APPLE_DARWIN"
  print -- "UXC_BINARY_SHA256_AARCH64_APPLE_DARWIN=$UXC_BINARY_SHA256_AARCH64_APPLE_DARWIN"
  print -- "UXC_BINARY_SHA256_X86_64_APPLE_DARWIN=$UXC_BINARY_SHA256_X86_64_APPLE_DARWIN"
  exit 0
fi

[[ $# -eq 0 ]] || fail_closed "unexpected_arguments"

if [[ -z "${UXC_INSTALL_DIR:-}" ]]; then
  chrome_dev_mcp_load_config || fail_closed "local_config_missing"
fi
target_dir="${UXC_INSTALL_DIR:-${CHROME_DEV_MCP_LINK_DIR:-}}"
[[ -n "$target_dir" ]] || fail_closed "install_dir_missing"
target="$target_dir/uxc"
manifest_path="$target.chrome-dev-mcp.manifest"

if [[ -e "$target_dir" || -L "$target_dir" ]]; then
  [[ ! -L "$target_dir" && -d "$target_dir" ]] || fail_closed "foreign_install_dir"
else
  /bin/mkdir -p "$target_dir" || fail_closed "install_dir_failed"
fi

if [[ -e "$target" || -L "$target" || -e "$manifest_path" || -L "$manifest_path" ]]; then
  chrome_dev_mcp_verify_owned_uxc "$target" || fail_closed "foreign_uxc"
  installed_version="$("$target" --version 2>/dev/null || true)"
  if [[ "$installed_version" == "uxc $UXC_VERSION" ]]; then
    print -- "UXC_INSTALL=READY"
    print -- "UXC_VERSION=$UXC_VERSION"
    print -- "INSTALL=NOT_NEEDED"
    exit 0
  fi
  fail_closed "installed_version_invalid"
fi

target_triple="$(chrome_dev_mcp_uxc_target_triple)" || fail_closed "unsupported_platform"
expected_sha256="$(chrome_dev_mcp_uxc_asset_sha256 "$target_triple")" || fail_closed "unsupported_platform"
expected_binary_sha256="$(chrome_dev_mcp_uxc_binary_sha256 "$target_triple")" || fail_closed "unsupported_platform"

asset="uxc-v$UXC_VERSION-$target_triple.tar.gz"
tmp_dir="$(mktemp -d)"
cleanup() {
  /bin/rm -rf -- "$tmp_dir"
}
trap cleanup EXIT INT TERM

if ! /usr/bin/curl \
  --fail \
  --silent \
  --show-error \
  --location \
  --proto '=https' \
  --tlsv1.2 \
  --output "$tmp_dir/$asset" \
  "$UXC_RELEASE_BASE/$asset"; then
  fail_closed "download_failed"
fi

actual_sha256="$(/usr/bin/shasum -a 256 "$tmp_dir/$asset" | /usr/bin/awk '{print $1}')"
[[ "$actual_sha256" == "$expected_sha256" ]] || fail_closed "checksum_mismatch"

/usr/bin/tar -xzf "$tmp_dir/$asset" -C "$tmp_dir" || fail_closed "extract_failed"
source_binary="$tmp_dir/uxc-v$UXC_VERSION-$target_triple/uxc"
[[ -x "$source_binary" ]] || fail_closed "archive_invalid"
source_binary_sha256="$(/usr/bin/shasum -a 256 "$source_binary" | /usr/bin/awk '{print $1}')"
[[ "$source_binary_sha256" == "$expected_binary_sha256" ]] || fail_closed "binary_checksum_mismatch"

/usr/bin/install -m 0755 "$source_binary" "$target" || fail_closed "install_failed"
{
  print -- "OWNER=$CHROME_DEV_MCP_UXC_OWNER"
  print -- "UXC_VERSION=$UXC_VERSION"
  print -- "TARGET_TRIPLE=$target_triple"
  print -- "ASSET_SHA256=$expected_sha256"
  print -- "BINARY_SHA256=$expected_binary_sha256"
} >"$tmp_dir/uxc.chrome-dev-mcp.manifest"
/usr/bin/install -m 0644 "$tmp_dir/uxc.chrome-dev-mcp.manifest" "$manifest_path" || fail_closed "manifest_install_failed"
chrome_dev_mcp_verify_owned_uxc "$target" || fail_closed "installed_ownership_invalid"
[[ "$("$target" --version 2>/dev/null || true)" == "uxc $UXC_VERSION" ]] || fail_closed "installed_version_invalid"

print -- "UXC_INSTALL=READY"
print -- "UXC_VERSION=$UXC_VERSION"
print -- "INSTALL=PERFORMED"
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