Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A high-quality, actionable skill body with excellent workflow sequencing, error-recovery feedback loops, and well-structured progressive disclosure; the only meaningful weakness is redundancy of the critical layoutSizing/page rules across multiple sections.
Suggestions
Consolidate the layoutSizingHorizontal/Vertical rules into a single authoritative location (e.g., gotchas.md) and have the rules list, error-recovery table, and pre-flight checklist link to it rather than restating the full rule each time.
Do the same for the setCurrentPageAsync guidance — state it once in the Page Rules section and reference it from the rules list and checklist to cut repeated tokens.
Section 10's reference table duplicates some "what it covers" detail already present inline; consider trimming the inline restatements once the table is the canonical map.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, assumes Claude's competence, and conveys genuinely non-obvious Figma-specific rules — but the layoutSizing and setCurrentPageAsync rules are each repeated across four locations (rules list, dedicated section, error-recovery table, pre-flight checklist), so not every token earns its place. | 2 / 3 |
Actionability | Abundant copy-paste-ready executable examples (node.query selectors, node.set batch updates, figma.createAutoLayout, node.screenshot, inspection scripts) give concrete, complete guidance rather than pseudocode. | 3 / 3 |
Workflow Clarity | Section 6 gives an explicitly sequenced incremental workflow (inspect → skeleton → fill → return IDs → validate → fix), section 7 provides a STOP-read-fix-retry feedback loop, and section 8 is a validation checklist — all with explicit checkpoints for these risky batch/mutating operations. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview with a section-10 reference table ("When to load / What it covers") pointing to one-level-deep references; all in-bundle referenced paths (gotchas.md, the pattern docs, plugin-api-standalone.*, the wwds tree) were verified to exist on disk. | 3 / 3 |
Total | 11 / 12 Passed |