Content
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A thorough, highly actionable skill body with excellent workflow sequencing, validation checkpoints, and well-structured progressive disclosure into two real reference files. The main weakness is repetition of the icon/instance-swap example and some duplication between inline guidance and the quick-reference table.
Suggestions
Consolidate the repeated getInstanceSwap/findInstance + executeTemplate icon pattern into a single canonical example and reference it from Steps 5, the nested sections, and Rules #4/#7 rather than restating it each time.
Remove or trim the Inline Quick Reference signature tables that duplicate the method signatures already demonstrated inline, or conversely drop the inline examples and keep only the tables.
The conditional-props example (variant + disabled Button) appears in both 'Conditional props' and the worked example; keep one and cross-reference to reduce token cost.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and Figma-specific, but the icon getInstanceSwap/findInstance pattern is repeated across Step 5, 'Nested configurable instances', 'Nested component example', Rules #4/#7, and the worked example, and the Inline Quick Reference restates signatures already shown inline. | 2 / 3 |
Actionability | Provides fully executable code, concrete MCP tool calls with named parameters, method-signature tables, and a complete end-to-end worked example that is copy-paste ready. | 3 / 3 |
Workflow Clarity | A clearly sequenced 6-step process with explicit response-state handling (empty/already-mapped/multiple), a user-confirmation checkpoint in Step 4, and a Step 6 read-back validation checklist covering property coverage, typing, and hardcoded-child checks. | 3 / 3 |
Progressive Disclosure | SKILL.md is an overview+workflow that points one level deep to real, clearly-signaled files — references/api.md and references/advanced-patterns.md (both present on disk) — keeping the API reference and advanced nesting out of the main body. | 3 / 3 |
Total | 11 / 12 Passed |