Content
88%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.
A well-structured, highly actionable skill body with an explicit sequenced workflow and a validation checkpoint, plus correctly split one-level-deep references. The main weakness is deliberate but repeated reinforcement of the same anti-drift warnings, which inflates token usage.
Suggestions
Consolidate the .figma.ts-vs-.figma.tsx and INSTANCE_SWAP/SLOT warnings into a single authoritative callout, then reference it from other steps instead of restating them verbatim in Overview, Step 5, Step 6, and Rules.
Trim the inline Quick Reference method table to only the methods used in the core workflow, deferring the full signature table to api.md to reduce overlap with the referenced file.
In Rules and Pitfalls, two items are both numbered 7; renumber so the list is unambiguous.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Largely lean with executable code and direct instruction assuming Claude's competence, but the .figma.ts-vs-.figma.tsx warning and the INSTANCE_SWAP/SLOT distinction are restated several times across Overview, Step 5, Step 6, and Rules, adding repeat tokens. | 4 / 5 |
Actionability | Provides copy-paste-ready templates with concrete instance API calls, property-mapping tables, and a complete worked example from URL to finished file, covering the common cases fully. | 5 / 5 |
Workflow Clarity | A clearly sequenced six-step process culminating in an explicit Step 6 Validate checklist with feedback loops (discard and rewrite wrong format, flag missing properties and ask the user), satisfying the validation requirement for an artifact-producing skill. | 5 / 5 |
Progressive Disclosure | Core workflow lives in SKILL.md while bulk API detail and advanced nesting are split one level deep into real, clearly signaled reference files (api.md, advanced-patterns.md); however a sizable inline Quick Reference table and API method detail overlap content that also lives in the referenced files, leaving minor organization redundancy. | 4 / 5 |
Total | 18 / 20 Passed |