Content
85%Reviews 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 actionable reference for a custom tool Claude would not already know, with clear workflows and a feedback loop. Its main weakness is a few unnecessary implementation-detail asides that pad the token budget without aiding execution.
Suggestions
Remove implementation trivia that does not aid execution, e.g. "renders pages via Electron's `WebContentsView`" and the "CDP `Page.getLayoutMetrics`" detail in the Tips section — describe what the tools do, not how the host renders them.
Tighten the React `_debugSource` paragraph to the actionable condition (available in React dev mode; automatic fallback to heuristic search) rather than enumerating which bundlers enable the Babel plugin by default.
Make the Figma workflow example fully executable by including the required `workspaceId` parameter in the sample `stave_lens_*` calls, since the body itself states all tools require it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and well-structured, but includes unnecessary implementation trivia Claude does not need to act — "renders pages via Electron's `WebContentsView`" and "Full-page screenshots use CDP `Page.getLayoutMetrics`" — fitting the 'mostly efficient but includes some unnecessary explanation or could be tightened' anchor rather than the fully-lean score 3. | 2 / 3 |
Actionability | Provides concrete executable guidance: a table of 10 named MCP tools with purposes, specific UI steps for opening Lens and the picker, and a numbered Figma comparison workflow with actual tool calls, matching the 'fully executable ... specific examples' anchor; it stays at 3 because the bulk is copy-paste ready despite the example calls omitting the required workspaceId. | 3 / 3 |
Workflow Clarity | The Figma comparison workflow is a clear numbered sequence with an explicit feedback loop ("Repeat from step 2"), and the opening/picker procedures are unambiguously sequenced, matching the 'clear sequence with ... feedback loops for error recovery' anchor; there are no destructive/batch operations requiring validation caps. | 3 / 3 |
Progressive Disclosure | No bundle files exist and the skill is self-contained, but the body is organized into clearly signaled sections (MCP Tools, Element Picker, Source Code Mapping, Figma Workflow, Tips, Avoid) with no nested references, matching the well-organized self-contained case the rubric permits to score 3. | 3 / 3 |
Total | 11 / 12 Passed |