Content
86%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 well-engineered body: executable pinned commands, honest validation checkpoints (server readiness, viewport verification, final-URL checks), strong untrusted-content boundary guidance, and excellent progressive disclosure into verified bundle files. The main improvement room is closing error-recovery loops inline and removing the small redundancy between the decision matrix and the 'When NOT to Use' bullets.
Suggestions
Consolidate tool-choice guidance so the 'When NOT to Use Chrome MCP' bullets and the decision matrix rows are not redundant — keep one canonical decision point.
Close the feedback loops inline: state what to do when viewport verification fails or the server check fails (retry/re-verify steps), rather than ending at 'report the missing capability' or deferring to reference files.
Trim the 'Related Skills' section to one or two lines or move it to a reference file — it is context, not task guidance, and competes with the token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and imperative with no explanation of concepts Claude already knows, but has minor trim opportunities: the decision-matrix rows reappear as "When NOT to Use Chrome MCP" bullets, and the file:// conditions are stated in both "Golden Rules" ("no fetch/XHR to sibling files, no <script type=module>...") and "What NOT to Do". This fits 'efficient; minor instances of over-explanation that could be trimmed' better than the fully lean anchor 5 or the noticeably padded anchor 3. | 4 / 5 |
Actionability | Copy-paste-ready commands cover the common cases: pinned install ("npm install --save-dev playwright@1.62.0", "npm exec -- playwright install chromium"), serving ("npx serve _site -l 3000 --no-clipboard"), four executable JS payload snippets, a concrete output tree, specific API notes ("waitUntil: 'load'", "set before navigating"), and three runnable bundled scripts in assets/scripts/. Fully matches the executable anchor. | 5 / 5 |
Workflow Clarity | The Chrome MCP flow is a clear 5-step sequence with explicit checkpoints ("Set the requested viewport before navigation, then verify its dimensions", "check its final URL", "Verify the expected app is ready before capturing") and a capability table with a "Completion evidence" column acting as a checklist. It sits at 4 rather than 5 because feedback loops are not fully closed inline — e.g., on failure the guidance ends at "report the missing capability" or defers to reference files rather than giving validate→fix→retry steps. | 4 / 5 |
Progressive Disclosure | The body is a true overview with all 9 bundle files verified to exist, one level deep, and navigated via a "Reference Files" table with a 'Load when' column and section-anchored pointers (e.g., playwright-patterns.md § "Verifying the Server"). This matches the anchor for a clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |