CDP Extension Pilot

What it does

When your agent uses it

• Testing a Chrome extension's sidepanel, popup or options page in a real browser
• Loading an unpacked extension build and checking it against a target page
• Automating clicks and typing inside an extension interface
• Debugging an extension that fails to load or whose React inputs ignore typed text

Example prompts

• “Load the extension in dist/ and open its sidepanel, then take a screenshot.”
• “Test the options page of my extension and fill in the API URL field.”
• “The popup input does not update my React state when you type, so find a way around it.”

Requirements

• Node 22 or newer
• The cdp-connect skill installed alongside
• Chrome, or network access so Chrome for Testing can be installed
• Compatibility (from SKILL.md): Requires Node 22+. Depends on the cdp-connect skill as a sibling skill.

Workflow steps

3 steps, taken from the step headings in SKILL.md.

1. 1Setup
2. 2Open UI
3. 3Interact

What it can do on your machine

Read from SKILL.md and the folder at commit cbc9952. It shows what the files ask for, not the result of running them.

• Tool permissions

  Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

  From allowed-tools in the SKILL.md frontmatter.

• Runs code

  Ships 1 file in scripts/ (JavaScript), which the agent can run.

  Shell commands in SKILL.md call:

  • node

  From the folder's file list and the shell code blocks in SKILL.md.

• Network

  No URLs in SKILL.md.

  From URLs in SKILL.md, links to its own repository left out.

• Credentials

  Names no API keys, tokens, secrets or passwords.

  From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

• Compatibility

  Requires Node 22+. Depends on the cdp-connect skill as a sibling skill.

  From compatibility in the SKILL.md frontmatter.

Context cost

CDP Extension Pilot loads about 952 tokens when it runs, and up to ~1.5k if it reads all its reference files. Until then it costs about 188 tokens; SKILL.md has 191 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it

~188

When it runs · the whole SKILL.md, loaded when a task matches

~952

With references · SKILL.md plus every file in references/, read only if the agent opens them

~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from adobe/skills at commit cbc9952, republished under its Apache-2.0 licence (© adobe). 191 words, ~952 tokens.

name

cdp-ext-pilot

description

Launch Chrome with an unpacked extension and test its UI via CDP. Auto-installs Chrome for Testing if needed. Loads the extension, opens sidepanel/popup/options page, and hands off to cdp-connect for interaction (click, type, screenshot, ax-tree). Handles Chrome 137+ branded build restrictions (Extensions.loadUnpacked via pipe), sidepanel user gesture requirements, and React input quirks. Use when you need to test a Chrome extension's UI, automate extension interactions, or validate extension behavior on a target page. Triggers on: chrome extension test, test extension, load unpacked extension, extension sidepanel, extension popup, test chrome extension, extension testing, chrome extension automation, ext pilot, cdp extension.

compatibility

Requires Node 22+. Depends on the cdp-connect skill as a sibling skill.

license

Apache-2.0

# Locate cdp-ext-pilot.mjs
if [[ -n "${CLAUDE_SKILL_DIR:-}" ]]; then
  EXT_PILOT="${CLAUDE_SKILL_DIR}/scripts/cdp-ext-pilot.mjs"
else
  EXT_PILOT="$(command -v cdp-ext-pilot.mjs 2>/dev/null || \
    find ~/.claude -path "*/cdp-ext-pilot/scripts/cdp-ext-pilot.mjs" -type f 2>/dev/null | head -1)"
fi

# Locate cdp.js (from cdp-connect skill)
if [[ -n "${CLAUDE_SKILL_DIR:-}" ]]; then
  CDP_JS="$(find "$(dirname "${CLAUDE_SKILL_DIR}")" -path "*/cdp-connect/scripts/cdp.js" -type f 2>/dev/null | head -1)"
fi
CDP_JS="${CDP_JS:-$(command -v cdp.js 2>/dev/null || \
  find ~/.claude -path "*/cdp-connect/scripts/cdp.js" -type f 2>/dev/null | head -1)}"

node "$EXT_PILOT" launch <path-to-extension-dist> [--port 9222]

node "$EXT_PILOT" open sidepanel [--port 9222]   # Opens sidepanel, returns target ID
node "$EXT_PILOT" open popup [--port 9222]        # Opens popup as tab
node "$EXT_PILOT" open options [--port 9222]      # Opens options page as tab

node "$CDP_JS" ax-tree --id <target-id>           # Understand the UI
node "$CDP_JS" screenshot /tmp/ext.png --id <tid>  # Visual check
node "$CDP_JS" click "button" --id <tid>           # Click elements
node "$CDP_JS" type "input" "text" --id <tid>      # Type into fields
node "$CDP_JS" eval "expression" --id <tid>        # Run JS

node "$EXT_PILOT" status [--port 9222]   # Check session state
node "$EXT_PILOT" close [--port 9222]    # Kill Chrome, remove profile

© adobe, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in plugins/web/skills/cdp-ext-pilot of adobe/skills.

• SKILL.md
• .releaserc.json
• evals/evals.json
• package.json
• references/troubleshooting.md
• scripts/cdp-ext-pilot.mjs

Open the folder on GitHubat commit cbc9952