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 a well-organized, largely executable reference: a complete tool table, precise session semantics, and a numbered design-comparison loop with a built-in retry. The main gaps are a handful of user-doc tokens, no example selectors/outputs for the interaction tools, and detail that could move to a reference file as the skill grows.
Suggestions
Trim user-facing lines (Globe icon / Command Palette) that describe the UI rather than agent behavior, and fold the 'What is Lens?' section into a single sentence.
Add one concrete example per interaction tool, e.g., a sample CSS selector for `stave_lens_click` and expected box-model output from `stave_lens_inspect`.
If the skill grows, move the React `_debugSource` mechanics and picker data-field lists into a `references/` file and keep SKILL.md as the overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean — tool table, dense bullets, no padding explaining concepts Claude already knows — so it is clearly above the 'mostly efficient' midpoint. A few tokens are spent on user-facing documentation ('Users can also open Lens with the Globe icon or the Command Palette action Show Lens') and the two-sentence 'What is Lens?' section could be tightened, placing it at 'minor instances of over-explanation' rather than 'every token earns its place'. | 4 / 5 |
Actionability | Concrete guidance dominates: all 14 MCP tools are listed with purposes, session rules reference exact tool names, and the Figma workflow includes a literal call ('stave_lens_navigate("http://localhost:3000/page")'). It falls short of fully copy-paste-ready 5 because click/type/inspect lack example selectors or expected output shapes. | 4 / 5 |
Workflow Clarity | The Figma comparison workflow is clearly numbered with an explicit feedback loop ('Modify code to fix discrepancies... Repeat from step 2'), and the session presentation boundary rules are precise. Other guidance (check console/network logs early) is stated as tips rather than sequenced checkpoints, so it does not reach the 'explicit validation steps' bar of 5. | 4 / 5 |
Progressive Disclosure | Sections are well-organized and appropriately scoped for a single-file skill, but at ~96 lines some detail (React _debugSource mechanics, picker captured-data fields) could be split into a reference file. With no bundle files present and content exceeding the 'under 50 lines' simple-skill exception, this lands at 'good structure; minor organization gaps' rather than a fully split 5. | 4 / 5 |
Total | 16 / 20 Passed |