Content
85%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.
The body is a well-structured, repo-first workflow with a clearly sequenced procedure, explicit correction/verification checkpoints, and clean progressive disclosure into verified reference files. It is actionable for an instruction-only skill, with only minor conciseness and redundancy room for improvement.
Suggestions
Consolidate the Commands table and Skill Boundaries table, which partially overlap, to remove redundant routing prose and tighten conciseness.
Move the repeated Figma-plan/seat prerequisites for Code Connect (currently restated in both the boundaries table and the code-connect command section) into a single reference location.
Trim explanatory sentences that restate MCP behavior already covered by the Figma MCP Tool Use table to further reduce token overhead.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely efficient with each section earning its place, though some boundary prose and the Skill Boundaries table partially restate the Commands table, leaving minor trimmable redundancy. | 4 / 5 |
Actionability | Concrete, specific guidance such as "Call the design-context tool with clientLanguages and clientFrameworks matched to the inspected repository", named server strings, and `create_design_system_rules`; executable code is absent but justified because MCP tool schemas vary by host. | 4 / 5 |
Workflow Clarity | A 10-step Operating Procedure is clearly sequenced with explicit validation and correction checkpoints (per-unit and assembly correction, "Do not mark complete after a single pass"), plus a Failure Handling playbook and Verification Checklist providing feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | SKILL.md is a genuine overview that splits bulk detail across five real, one-level-deep reference files, each clearly signaled by a Reference Files table with load-conditions and verified inline anchor links, making navigation easy. | 5 / 5 |
Total | 18 / 20 Passed |