# chrome-automation

Controls an active Chrome window via the agent-browser CLI. Useful for extracting web data, filling forms, and replaying DevTools recordings while keeping active login sessions intact.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 4000 installs
- Author: zc277584121
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/chrome-automation/SKILL.md
- Updated: 2026-08-28
- HTML: https://affpapa.org/en/nevibecode/skills/chrome-automation

## What it does

This skill hooks into your main running browser process instead of launching a blank automated window. It inspects existing tabs before navigating anywhere. That approach preserves cookies, authentication states, and open dashboards without forcing you to log in again.

Actions rely on interactive snapshots. The CLI assigns references like `@e1` or `@e2` to clickable targets and input fields. The agent then clicks elements, inputs text, evaluates JavaScript, or captures screenshots. It can also parse and execute step-by-step recordings exported from Chrome DevTools Recorder in JSON or Puppeteer format.

Chrome must run with remote debugging enabled. Without it, the CLI cannot locate the browser process. On Chrome 144 and newer, remote debugging can switch to WebSocket mode, requiring a direct connection string like `ws://127.0.0.1:9222/devtools/browser` alongside Node 24 or newer.

## Requirements
- Works with: Chrome

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill chrome-automation -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/chrome-automation/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/chrome-automation/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill chrome-automation -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/chrome-automation/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill chrome-automation -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/chrome-automation/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install zc277584121/marketing-skills chrome-automation
```

2. **Manually: put the files in place**
- File: `.github/skills/chrome-automation/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill chrome-automation -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/zc277584121/marketing-skills --path skills/chrome-automation
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/chrome-automation/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add zc277584121/marketing-skills --skill chrome-automation -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/zc277584121/marketing-skills/tree/HEAD/skills/chrome-automation/SKILL.md

## When to use it
- Interact with web applications while preserving existing user logins
- Extract text and table counts directly from rendered pages
- Replay browser action recordings exported from Chrome DevTools
- Capture targeted screenshots to inspect page layout changes

## Example prompts
- Find the open tab with the analytics dashboard and take a screenshot.
- Fill out the contact form on the active page and submit it.
- Replay the steps from recording.json in the current Chrome tab.

## Similar
- [chrome-devtools](https://affpapa.org/en/nevibecode/skills/chrome-devtools.md) — skill · 15258 installs
- [chrome-devtools-axi](https://affpapa.org/en/nevibecode/skills/chrome-devtools-axi.md) — skill · 6900 installs
- [chrome-devtools-cli](https://affpapa.org/en/nevibecode/skills/chrome-devtools-cli.md) — skill · 6800 installs
- [chrome-cdp](https://affpapa.org/en/nevibecode/skills/chrome-cdp.md) — skill · 2100 installs
- [chrome-cdp-live-browser](https://affpapa.org/en/nevibecode/skills/chrome-cdp-live-browser.md) — skill · 1500 installs
- [puppeteer-automation](https://affpapa.org/en/nevibecode/skills/puppeteer-automation.md) — skill · 1800 installs

From the same set: [zc277584121/marketing-skills](https://affpapa.org/en/nevibecode/by/zc277584121/marketing-skills.md) — 10 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md