CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

troubleshooting

Uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues. Trigger this skill when list_pages, new_page, or navigate_page fail, or when the server initialization fails.

87

1.01x
Quality

85%

Does it follow best practices?

Impact

99%

1.01x

Average score across 3 eval scenarios

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.

A strong diagnostic workflow body: every step is concrete and executable, the triage sequence includes explicit validation via list_pages with a defined escalation path, and detail is deferred to upstream documentation. The only meaningful gaps are minor trimmable narration and an inline error catalog that could move to a reference file as the skill grows.

DimensionReasoningScore

Conciseness

The body is efficient and assumes Claude's competence — no space is spent explaining what MCP or Chrome DevTools is, and error triage entries are stated as terse directives. Minor instances of over-explanation ("You are acting as a troubleshooting wizard to help the user configure and fix…", "This is not a generic connection failure") could be trimmed, keeping it just below the lean anchor-5 example.

4 / 5

Actionability

Guidance is fully executable and copy-paste ready throughout: exact config file paths (`.mcp.json`, `.vscode/mcp.json`, `~/.claude.json`), the exact URL `chrome://inspect/#remote-debugging`, runnable commands (`npx chrome-devtools-mcp@latest --help`, `NODE_DEBUG=* npx chrome-devtools-mcp@latest --logFile=/tmp/cdm-test.log`, `gh issue list --repo ChromeDevTools/chrome-devtools-mcp --search "<error snippet>" --state all`), and concrete flag values (`--browser-url=http://127.0.0.1:9222`, `startup_timeout_ms` 20000). This matches the anchor for fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

Six clearly sequenced steps with explicit validation and a feedback loop: "your only next action should be to call the `list_pages` tool… If `list_pages` succeeds, the problem is resolved. If it still fails… proceed to the more advanced steps," plus a documented fallback in Step 1 (ask the user only if no config file is found) and diagnostic verification in Step 5. This matches the anchor for a clear sequence with explicit validation steps and error-recovery loops; the operation is diagnostic, not destructive or batch, so no cap applies.

5 / 5

Progressive Disclosure

Sections are well organized and the skill appropriately defers known-issue detail to the upstream troubleshooting doc (https://github.com/ChromeDevTools/chrome-devtools-mcp/blob/main/docs/troubleshooting.md) and GitHub issues/discussions rather than inlining it, and no bundle files exist to score against. It falls short of 5 because at ~95 lines the inline error catalog ("Other Common Errors") and Step 3 summary could be split into a clearly signaled reference file, which would keep SKILL.md a tighter overview.

4 / 5

Total

18

/

20

Passed

Description

73%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 well-targeted description with an explicit and concrete trigger clause tied to specific tool names, in correct third-person voice with no fluff. Its main weakness is a thin "what" — it says the skill troubleshoots connection and target issues but does not enumerate the concrete capabilities (config diagnosis, error triage, GitHub issue search) that the body actually delivers.

Suggestions

List 2-3 concrete capabilities in the description to raise specificity, e.g., "Diagnoses MCP configuration files, triages common connection errors (DevToolsActivePort, Target closed, missing pageId), and searches known GitHub issues."

Add natural-language trigger synonyms users might say, such as "MCP server won't start" or "can't connect to Chrome", so the skill fires even when the user describes the symptom without naming the failing tool.

DimensionReasoningScore

Specificity

"Uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues" names the domain plus one action area, matching the anchor for 1-2 concrete actions without comprehensive coverage. It stays at 3 because it does not enumerate several specific actions (e.g., diagnosing config files, triaging specific errors, searching GitHub issues), and above 2 because it is more than a bare domain mention.

3 / 5

Completeness

Both halves are explicit: the "what" ("Uses Chrome DevTools MCP and documentation to troubleshoot connection and target issues") and a concrete "when" ("Trigger this skill when list_pages, new_page, or navigate_page fail, or when the server initialization fails"). The trigger clause is anchor-5 quality, but the "what" is a single generic action phrase rather than the multiple concrete capabilities of the anchor-5 example, placing it between 4 and 5 with the weakness on the "what" side.

4 / 5

Trigger Term Quality

"list_pages, new_page, or navigate_page fail" and "server initialization fails" are exactly the phrases a user or transcript would surface when this skill is needed, giving good keyword coverage. It falls short of 5 because common natural variations like "MCP server won't start" or "can't connect to Chrome" are absent.

4 / 5

Distinctiveness Conflict Risk

The description is tightly scoped to Chrome DevTools MCP with named tools (list_pages, new_page, navigate_page), forming a clear niche with distinct triggers and minimal risk of firing for unrelated skills.

5 / 5

Total

16

/

20

Passed

Validation

100%

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

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

ChromeDevTools/chrome-devtools-mcp

Path

skills/troubleshooting/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.