Content
92%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 exemplary instruction-only skill body: terse environment-specific rules, exact executable details (paths, naming, tag, forbidden APIs), a fully sequenced workflow with a hard completion gate and review checklist, and a clean router-to-references structure where every cited file exists. The only flaw is mild redundancy — the smallest-result and tag-verification rules each appear two or three times across sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, imperative, and teaches only environment-specific facts Claude cannot know ("The sandbox has no network access of any kind", "sandbox=\"allow-scripts\" without allow-same-origin", the store-dir convention). It is not anchor 5 because of repeated statements of the same rule: "smallest truthful result" (Mission), "Choose the smallest composition" (invariant 2), "Did you choose the smallest format" (Review), and the tag-verification rule appears in both Publish and the Completion gate. No filler or explanations of known concepts, so well above anchor 3. | 4 / 5 |
Actionability | Guidance is fully concrete and copy-paste ready for an instruction-only skill: the exact tag `<cursor-content kind="visualization" src="visualizations/<slug>.html"></cursor-content>`, the exact environment variable `CURSOR_AGENT_STORE_FILES_DIR`, a precise slug pattern with a worked example (`revenue-by-quarter`), specific forbidden APIs ("fetch, XMLHttpRequest, WebSocket, navigator.sendBeacon"), and exact file paths. Routing conditions and the HTML lifecycle leave no step abstract. | 5 / 5 |
Workflow Clarity | A clear five-step sequence (Route → Identify → Plan → Complete → Review) is expanded into an HTML lifecycle (Allocate → Author → Validate → Publish) with explicit checkpoints: the "Completion gate" ("do not finish until the final response contains exactly one content-reference tag... Verify that the tag's src uses the same file name"), a final review checklist, an explicit stop condition, and recovery paths for error cases ("If neither store location is available... tell the user", name collisions handled by appending -2). This matches the anchor-5 pattern of explicit validation, checklists, and error recovery; file writes are additionally protected by the never-overwrite rule. | 5 / 5 |
Progressive Disclosure | The entry file is a pure router with one-level-deep, well-signaled references: all seven paths cited (foundations, charts, components, mockups, diagrams, art, catalog) exist in references/, each guarded by an unambiguous condition ("Every chart, plot, part-to-whole view... MUST read references/charts.md"), plus the explicit discipline "Read every applicable file. Read no unrelated file." Cross-links between reference files (e.g., foundations → charts for the D3 marker) are sibling pointers that SKILL.md already routes to, not buried 2+-level content deferral, so navigation stays flat and easy. | 5 / 5 |
Total | 19 / 20 Passed |