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

View on GitHub
#!/bin/zsh

set -euo pipefail

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

report_error() {
  print -- "STATUS=ERROR"
  print -- "SHARED_TRANSPORT=FAIL"
  print -- "ERROR_CLASS=$1"
  print -- "NATIVE_COMPAT=NOT_USED"
  exit 69
}

if [[ "${1:-}" == "--help" || "${1:-}" == "-h" ]]; then
  print -- "usage: zsh uxc-readiness.zsh [--private-result]"
  print -- "  default: shared list_pages proof, prints sanitized STATUS fields; --private-result: prints the JSON envelope for pageId resolution"
  exit 0
fi

output_mode="sanitized"
if [[ $# -eq 1 && "$1" == "--private-result" ]]; then
  output_mode="private-result"
elif [[ $# -ne 0 ]]; then
  report_error "unexpected_arguments"
fi
chrome_dev_mcp_load_config || report_error "local_config_missing"

link_dir="${CHROME_DEV_MCP_LINK_DIR:-}"
link_path="$link_dir/chrome-dev-mcp-cli"
wrapper="${CHROME_DEV_MCP_WRAPPER:-}"
exclusive_key="${CHROME_DEV_MCP_UXC_EXCLUSIVE_KEY:-}"
[[ -n "$link_dir" ]] || report_error "link_dir_missing"
[[ -x "$wrapper" ]] || report_error "wrapper_missing"
[[ -n "$exclusive_key" ]] || report_error "exclusive_key_missing"
[[ -x /usr/bin/jq ]] || report_error "missing_jq"
chrome_dev_mcp_uxc_link_contract_matches \
  "$link_path" "$wrapper" "$exclusive_key" "$skill_dir" || \
  report_error "link_contract_mismatch"

[[ -z "${CHROME_DEV_MCP_UXC_BIN:-}" ]] || report_error "uxc_override_forbidden"
uxc_bin="$link_dir/uxc"
chrome_dev_mcp_verify_owned_uxc "$uxc_bin" || report_error "foreign_uxc"
[[ "$("$uxc_bin" --version 2>/dev/null || true)" == "uxc $UXC_VERSION" ]] || report_error "version_mismatch"

tmp_dir="$(mktemp -d)"
cleanup() {
  /bin/rm -rf -- "$tmp_dir"
}
trap cleanup EXIT INT TERM

cd "$skill_dir" || report_error "fixed_cwd_missing"
exit_code=0
PATH="$link_dir:${PATH:-/usr/bin:/bin}" "$link_path" --timeout-ms 45000 list_pages \
  >"$tmp_dir/stdout" 2>"$tmp_dir/stderr" || exit_code=$?

result_class="$(chrome_dev_mcp_classify_readiness "$tmp_dir/stdout" "$tmp_dir/stderr" "$exit_code")"
[[ "$result_class" == "OK" ]] || report_error "$result_class"

if [[ "$output_mode" == "private-result" ]]; then
  /bin/cat "$tmp_dir/stdout"
  exit 0
fi

reuse="$(/usr/bin/jq -r 'if (.meta.daemon_session_reused | type) == "boolean" then .meta.daemon_session_reused else "unknown" end' "$tmp_dir/stdout")"
case "$reuse" in
  true) reuse_label="YES" ;;
  false) reuse_label="NO" ;;
  *) reuse_label="UNKNOWN" ;;
esac

print -- "STATUS=READY"
print -- "SHARED_TRANSPORT=OK"
print -- "DAEMON_SESSION_REUSED=$reuse_label"
print -- "NATIVE_COMPAT=NOT_USED"
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