CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

browser-cdp

Use this skill when you need to control a Chrome browser via CDP (Chrome DevTools Protocol) to reuse existing login sessions. Covers: launching Chrome in debug mode, opening URLs, waiting for page load, evaluating JavaScript, taking snapshots, and extracting auth tokens. Trigger phrases: browser automation, CDP, agent-browser, 浏览器操作, 操作浏览器, Chrome CDP, 复用登录态, extract token from browser.

Quality

85%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

88%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An excellent operational skill body: fully executable commands, a well-sequenced detection-then-branch startup flow, and a rigorous consent/validation protocol for destructive Chrome process operations with documented feedback loops. The only deductions are minor — some repetition of the consent procedure across sections and an inline-manual density that could offload troubleshooting tables to a reference file.

DimensionReasoningScore

Conciseness

The body is dense and operational — no padding, no explanations of concepts Claude already knows (CDP gets only a parenthetical expansion), and every section carries commands, tables, or exit codes. It falls short of anchor 5's "every token earns its place" because the Chrome-termination consent procedure is restated across the 启动流程, 停止/清理, and 常见问题 sections ("按同意流程先 dry-run、征得同意再加 --yes" appears in near-identical form at least four times), matching anchor 4's "minor instances... that could be trimmed".

4 / 5

Actionability

Every workflow is copy-paste ready: exact commands with flags ("agent-browser --cdp 9222 open", "eval -b" base64 wrapping, heredoc + --stdin for complex JS), a PowerShell job timeout snippet, documented exit codes (0/1/2/3), and structured KEY=value detection output. Referenced script options (--detect-only, --yes, --reset, --profile, --dry-run) were verified to exist in the actual bundle script, and the {SKILL_DIR} and <URL> placeholders are explicitly defined. Specific examples cover the common cases, matching anchor 5.

5 / 5

Workflow Clarity

The startup flow is a clearly sequenced decision procedure: a side-effect-free detection step, then explicit branches on CDP_STATUS/CHROME_RUNNING/CHROME_INSTALLED. Destructive operations (killing Chrome) have a full validation protocol — dry-run first, report the affected process count, obtain user consent, then re-run with --yes — plus a non-TTY NEEDS_CONSENT exit-code-3 guard, and the 常见问题 table provides error→remedy feedback loops. This satisfies anchor 5's "explicit validation steps; feedback loops for error recovery" and avoids the destructive-operation cap at 3 because validation is thoroughly present.

5 / 5

Progressive Disclosure

The single bundle reference ({SKILL_DIR}/scripts/setup-cdp-chrome.js, 1002 lines) is one level deep, clearly signaled, and verified real, with the script's behavior surfaced in SKILL.md via structured output and exit codes so the agent never needs to read the full script. Navigation is easy with well-organized section headers. It is not a 5 because the 187-line body is a full inline operational manual rather than an overview with content split out — the 常见问题 and 已知限制 tables partially restate earlier sections and could live in a reference file — matching anchor 4's "most content is appropriately placed... minor organization gaps".

4 / 5

Total

18

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description with explicit what/when structure, six concrete capability actions, and a dedicated bilingual trigger-phrase list. The main deductions are the second-person voice ("you need to"), which the rubric penalizes on specificity, and minor keyword/coverage gaps.

Suggestions

Rewrite the opening in third person (e.g., "Controls a Chrome browser via CDP (Chrome DevTools Protocol) to reuse existing login sessions") to remove the second-person "you need to" phrasing that costs a specificity point under the rubric.

Add the page-interaction actions (clicking elements, typing text) that the body documents under 常用操作 but the description's capability list omits.

Round out the trigger-phrase list with natural English synonyms such as "remote debugging", "reuse login session", and "DevTools Protocol" to complement the existing CDP/agent-browser terms.

DimensionReasoningScore

Specificity

The description lists six concrete actions ("launching Chrome in debug mode, opening URLs, waiting for page load, evaluating JavaScript, taking snapshots, and extracting auth tokens") plus the core capability ("control a Chrome browser via CDP... to reuse existing login sessions"), which on its own sits between anchors 4 and 5 — coverage has minor gaps (page interaction such as click/type and cleanup are documented in the body but unmentioned). However, the second-person phrasing "Use this skill when you need to control..." triggers the rubric's explicit third-person voice penalty of −1, bringing the score from 4 down to 3. It is not a 2 because the action list is far more concrete than "Names the domain but actions are minimal".

3 / 5

Completeness

Both what ("control a Chrome browser via CDP... to reuse existing login sessions" plus the six covered actions) and when ("Use this skill when you need to..." plus a dedicated concrete "Trigger phrases:" list) are explicitly and clearly answered, exactly matching anchor 5's requirement of "concrete trigger phrases" alongside the what.

5 / 5

Trigger Term Quality

"Trigger phrases: browser automation, CDP, agent-browser, 浏览器操作, 操作浏览器, Chrome CDP, 复用登录态, extract token from browser" provides good bilingual keyword coverage including the tool name and protocol name. It falls short of anchor 5 because natural synonyms like "remote debugging", "reuse login session" (English), or "DevTools" are missing, matching "Good keyword coverage; a few natural terms missing".

4 / 5

Distinctiveness Conflict Risk

The CDP/agent-browser/login-session-reuse niche is mostly distinct, with specific triggers like "agent-browser", "Chrome CDP", and "复用登录态". It is not a 5 because the fairly generic trigger "browser automation" creates minor overlap risk with closely related browser-automation skills (e.g., a Playwright or Puppeteer skill), matching anchor 4's "minor overlap risk with closely related skills".

4 / 5

Total

16

/

20

Passed

Validation

87%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

metadata_field

'metadata' should map string keys to string values

Warning

Total

14

/

16

Passed

Repository

zenstory-ai/oh-story-claudecode

Path

skills/browser-cdp/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.