Content
88%Weight 40%Scale 1-5Reviews 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.
| Dimension | Reasoning | Score |
|---|---|---|
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 |