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.
This is a high-quality operational skill: every rule is backed by concrete error messages, the code is executable, the multi-step workflow has explicit validation and error-recovery feedback loops, and detailed material is properly offloaded to a well-organized reference bundle. The only notable weakness is mild redundancy in the layout-sizing rules (12/12b/12c) and the inline selector-syntax documentation, which could be tightened or moved to a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and tool-specific with no filler or explanation of concepts Claude already knows — every rule carries a concrete consequence or exact error string ('Expected 'FIXED' | 'AUTO', received 'FILL'', 'Cannot write to node with unloaded font'). It is not a 5 because Rules 12/12b/12c repeat substantially the same sizing-enum material, Section 2 re-elaborates Rule 9, and Section 5's full selector-syntax table plus six examples is API surface that could be trimmed or moved to a reference file. Not a 3 because the over-explanation is minor relative to the volume of non-obvious, high-signal content. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready JavaScript throughout: query/set examples ('figma.currentPage.query('FRAME[name^=Card] TEXT').set({...})'), createAutoLayout scaffolds, worked inspection scripts, and the canonical font-load recipe, with exact error messages and specific fixes in the recovery table. This matches the anchor-5 example of executable code covering the common cases. | 5 / 5 |
Workflow Clarity | Section 6 gives a numbered incremental workflow (inspect → skeleton → retry-safe batches → return IDs → validation evidence → fix before moving on) with a step-by-step validation table, Section 7 defines explicit error-recovery feedback loops (safeToRetryWithoutCanvasRead contract, re-discover on repeat failure), and Section 8 provides a pre-flight checklist — all three elements of the anchor-5 example are present. Not a 4 because validation checkpoints are explicit at every step, not merely 'most'. | 5 / 5 |
Progressive Disclosure | The body is an operating contract with a well-signaled reference table (Section 10) giving load-conditions and coverage for each of the 12 real bundle files; bulk detail (gotchas.md, pattern files, the 403KB .d.ts) is correctly split out, and the .d.ts is explicitly grep-only rather than loaded. The working-with-design-systems drill-down (wwds.md → specific files) is clearly signaled as progressive loading, and all referenced paths and anchors in the body resolve to real files. Not a 4 because navigation is easy and content is appropriately split with only negligible inline API surface. | 5 / 5 |
Total | 19 / 20 Passed |