Content
77%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.
An exceptionally actionable and well-validated skill body with copy-paste commands, payloads, and strong feedback loops for every risky operation. Its weaknesses are length and structure: duplicated warnings inflate the token budget, and host-specific, security-model, and writeback details that belong in one-level-deep reference files are all inlined with no bundle files at all.
Suggestions
Split the body into reference files (e.g. references/browser-webmcp.md for per-host browser instructions, references/react-writeback.md for provenance and anchor rules, references/security-model.md for the account/sharing capability model) and keep SKILL.md as a concise overview with clearly signaled one-level-deep links.
De-duplicate repeated guidance: the frame-count limits in "Useful Canvas Sets", the AUTH_DISABLED/sign-in warnings, and the never-hand-build-URL/token warnings each appear in multiple sections — state each once in the most relevant section.
Tighten dense run-on paragraphs (Core Model, Account And Sharing Model) into short bullet constraints; much of the trust-boundary reasoning can be compressed to the operative rules without losing safety.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is information-dense with little explanation of concepts Claude already knows, but at ~600 lines it carries noticeable redundancy that could be tightened: the frame-count guidance is stated twice in "Useful Canvas Sets" ("Do not expand beyond 7 frames..." and "Do not expand every discovered route..."), the sign-in/AUTH_DISABLED and never-hand-build-URL warnings recur across sections, and long run-on security paragraphs (e.g. the Core Model trust discussion) repeat constraints already made elsewhere. Not a 2 because almost every sentence carries skill-specific operational content rather than padding; not a 4 because the duplication and dense multi-clause paragraphs are more than minor. | 3 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste bash for token generation and the durable bridge (AGENT_NATIVE_BRIDGE_TOKEN=... npx @agent-native/core@latest design connect --daemon), complete JSON payloads for open-visual-edit including viewports and resume cases, concrete JS for both the page helper and standard WebMCP, exact tool names (get-visual-edit-pending, propose-node-rewrite, write-local-file), ports, and health-check commands. Examples cover the common cases (fresh signed-out flow, hosted MCP flow, adding frames later, responsive viewports); the only placeholders (routeManifest, rootPath, NAME/ARGS) are appropriately parameterized. | 5 / 5 |
Workflow Clarity | Multi-step flows are explicitly sequenced with validation checkpoints and feedback loops: verify the target URL responds and probe routes before opening Design; numbered bridge steps 1-3 with the mint-then-adopt ordering explained; the /health and manifest probe to distinguish a live bridge from a broken one; the pull -> apply -> acknowledge-revision -> pull-again loop with "Never acknowledge before applying"; version-hash conflict handling ("on conflict, re-read and re-plan"); and explicit failure diagnosis ("If frames do not refresh, the write did not land; say so"). This matches the anchor with explicit validation steps and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Section headers are clear and the one external reference (the GitHub Visual Edit guide) is well signaled, but there are no bundle files at all — no references/, scripts/, or assets/ — so a large amount of specialized content that clearly belongs one level deep is inlined in SKILL.md: per-host browser/WebMCP instructions, the React source-writeback provenance rules, the account/sharing security model, and manual screen-management details. This sits between 'content that should be separate is inline' (3) and 'most content appropriately placed' (4) — the structure is good, but a 600-line body with this much peripheral depth should split most of it into reference files. | 3 / 5 |
Total | 16 / 20 Passed |