Content
81%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, workflow-driven skill body: exact error messages, executable scripts, explicit validation checkpoints, and error-recovery feedback loops. Its main cost is token weight — deliberate rule repetition and inlined reference-grade tables make the 380-line body tighter than ideal for an overview that already ships a rich references/ bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with genuinely non-obvious operational rules (little explanation of things Claude already knows), but it carries noticeable repetition and inlined reference-grade material: Rule 9 is restated across Section 2, Rule 5 across Sections 5–6, Section 3 restates Rules 4/15, the Pre-Flight Checklist (Section 8) re-enumerates Rules 1–18, and the full `node.query` selector grammar plus QueryResult method table plus editor-mode node-type lists would fit better in a reference file. This matches the 3 anchor ('mostly efficient but… could be tightened') better than 2 ('several unnecessary explanations or padded sections') since nearly all content is novel, not padding — and better than 4 given the 380-line body in a bundle that already ships 12+ reference files. | 3 / 5 |
Actionability | Guidance is fully executable: copy-paste inspection scripts (e.g. `figma.root.children.map(p => ({ id: p.id, name: p.name }))`), exact error strings to expect ('"Setting figma.currentPage is not supported"', 'Expected \'FIXED\' | \'AUTO\', received \'FILL\''), WRONG/CORRECT code contrasts, and precise API recipes with argument shapes. This matches the 5 anchor: 'copy-paste ready code or commands; specific examples cover the common cases'. | 5 / 5 |
Workflow Clarity | Section 6 gives a numbered step order with a per-step validation table ('What to validate at each step'), Section 7 defines an explicit feedback loop (obey `safeToRetryWithoutCanvasRead`, targeted fix scripts, root-cause rule on repeated errors), and Section 8 provides a pre-flight checklist. This is the 5 anchor: 'clear sequence with explicit validation steps; feedback loops for error recovery; checklists for complex processes'. | 5 / 5 |
Progressive Disclosure | The reference docs table in Section 10 is a model of clear signaling (per-file 'When to load' and 'What it covers' columns) and all referenced paths resolve to real files in references/. However, the `working-with-design-systems/` chain nests three levels deep (SKILL.md → wwds.md → wwds-components.md → wwds-components--creating.md), and some reference-grade content (selector grammar, QueryResult method table, editor-mode node-type lists) is inlined in the overview. This fits the 4 anchor ('good structure; most content appropriately placed; references mostly clear; minor organization gaps') rather than 5, and is well above 3 since the primary navigation is explicit and easy to use. | 4 / 5 |
Total | 17 / 20 Passed |