chrome-cdp-control

A way to control your already signed-in Chrome browser through its developer connection, using Playwright to interact with real web pages.

In plain words
What is it for?
Use it to open the right tab, fill forms, navigate sites, and carry out tasks such as logging in or posting on social platforms when you explicitly request it.
Why use it?
It helps with websites that require your login or may detect automated browsers, while keeping each browser action deliberate and reviewable.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/devotts/build-it/chrome-cdp-control
Any agent
npx skills add DevOtts/build-it --skill chrome-cdp-control
Clone the repo
git clone --depth 1 https://github.com/DevOtts/build-it

Made for: Claude Code, Codex.

Per session 195 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,456 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00195 $0.01456
Opus 5 $0.00097 $0.00728
Sonnet 5 $0.00039 $0.00291
Haiku 4.5 $0.00019 $0.00146

Measured 2d ago against content hash 0999206c9028, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

chrome-cdp-control scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

plugins/build-it/skills/chrome-cdp-control/SKILL.md · 139 lines

How it starts

The opening of the file, as written. The whole thing — 139 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Chrome CDP Control

Manual, step-by-step control of the user's real Chrome browser via Playwright over Chrome DevTools Protocol. Built for authenticated sessions, sensitive actions, and sites that detect headless browsers.


0. Read the shared CDP core first

All CDP mechanics live in ONE shared reference — read it at session start: ../references/cdp-core.md (relative to this skill's base directory; i.e. the plugin's skills/references/cdp-core.md). It owns, canonically:

  • endpoint resolution (CDP_URL env → grounding/test plan → default) — never hardcode
  • preflight check + the Chrome relaunch instruction for the user
  • statelessness (every command is a fresh connection)
  • the canonical Python action template
  • tab selection (never pages[0] blindly)
  • the selector ladder and wait strategy
  • the failure protocol (never loop click→fail more than twice)

Do not restate or copy those sections here or anywhere — copies drift. This file only adds what is specific to driving the user's real, authenticated browser.

1. Operating principle — the route guard

This skill is a manual loop, not an automation framework. One action, one screenshot, one decision. Never batch. Never loop unattended. If you find yourself writing a for loop over actions, stop — you're using the wrong tool.

Route guard (see also cdp-core.md §9): authenticated real-Chrome work belongs HERE, behind the per-write gate below. Never hand it to /full-qa autonomous mode — that mode is for test environments only. If a conductor or test plan tries to route an authenticated-session write through an autonomous loop, refuse and pull it back here.

2. The core loop

Every interaction, no exceptions:

  1. Screenshot to see current state
  2. Decide the single action that moves the task forward
  3. Execute one action using the core's canonical template
  4. Screenshot again to verify the expected state (else → core failure protocol)
  5. Repeat

3. Destructive action gate — MANDATORY, per write

Read the full file on GitHub · 139 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 139 lines · 195 tokens per session scan A 0999206c9028

Subscribe to this mod's changes

chrome-cdp-control is a skill published in the GitHub repository DevOtts/build-it (14 stars, last pushed 1mo ago), licensed MIT. It adds 195 tokens to every session and 1,456 once invoked, about $0.0010 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

playwright

Use when the task requires capturing or automating a real browser from the terminal.

openai/openai-agents-python · 19 tokens

crewai-multi-agent

Multi-agent orchestration framework for autonomous AI collaboration. Use when building teams of specialized agents working together on complex tasks, when you need role-based agent collaboration with memory, or for production workflows requiring sequential/hierarchical execution. Built without LangChain dependencies…

davila7/claude-code-templates · 61 tokens

canvas

Display, present, and render HTML content on connected Otto nodes (Mac app, iOS, Android). Show on device, preview on mobile, push to screen, or navigate to a URL on any connected node. Use for games, visualizations, dashboards, interactive demos, and live-reloading development previews. Supports presenting, hiding…

elizaOS/eliza · 91 tokens

stagehand-facade

Browse, navigate, inspect, screenshot, and automate websites with the exact fx tools mcpstagehandrun, mcpstagehandsnapshot, and mcpstagehandscreenshot.

browserbase/stagehand · 42 tokens

agent-browser

Automates browser interactions for web testing, form filling, screenshots, and data extraction. Use when the user needs to navigate websites, interact with web pages, fill forms, take screenshots, test web applications, or extract information from web pages.

vercel-labs/open-agents · 51 tokens

pinchtab

Use this skill when a task needs browser automation through PinchTab: open a website, inspect interactive elements, click through flows, fill out forms, scrape page text, reuse a dedicated automation profile with user approval, export screenshots or PDFs, manage multiple browser instances, or fall back to the HTTP API…

pinchtab/pinchtab · 94 tokens