Content
75%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.
The body is well-organized, mostly concise, and provides concrete tool calls and a clear multi-step workflow with numbered steps. Weakest area is conciseness, where a few explanatory passages could be tightened.
Suggestions
Tighten conciseness: trim the 'What is Lens?' framing and the Electron WebContentsView backing detail, which explain internals Claude does not need to use the skill.
Improve actionability by listing the key parameters for each MCP tool (e.g., selector, fullPage/viewport flag for screenshot) so calls are copy-paste ready rather than just naming the tool.
Add an explicit validate/retry checkpoint to the Figma comparison workflow (e.g., 'If the screenshot still mismatches the spec after a fix, re-screenshot and re-compare before moving on').
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is mostly efficient and assumes Claude's competence about browser/DOM concepts, but a few lines over-explain (e.g., the Electron WebContentsView backing detail and the 'Lens is a per-workspace embedded browser...' framing) that could be trimmed without losing actionable value. | 4 / 5 |
Actionability | Concrete tool names, parameters ('All tools require a workspaceId'), a numbered Figma workflow with actual tool calls, and specific Avoid rules make the guidance mostly executable; minor gaps are that tool arguments beyond workspaceId and selector are not enumerated, so it is not fully copy-paste ready. | 4 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced — the Figma design comparison workflow is a numbered loop, and the Element Picker is a 3-step numbered list — with most checkpoints present; it is not a 5 because there are no explicit validate/retry error-recovery steps, though the operations are non-destructive so the destructive-cap does not apply. | 4 / 5 |
Progressive Disclosure | Good structure with clearly headed sections (Session Behavior, MCP Tools table, Element Picker, Source Code Mapping, workflow, Tips, Avoid) and no bundle files to split out; it is not a 5 only because the MCP Tools table and Tips inline content that could arguably live in a one-level-deep reference file, but as a self-contained ~95-line skill the organization is strong. | 4 / 5 |
Total | 16 / 20 Passed |