Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill provides a structured design system reference with clear semantic tokens, typography specs, and interaction guidelines using MUST/SHOULD/NEVER conventions. However, it contains several suspicious or erroneous values (0px input height, dark red for 'surface-raised' in a light-mode system, light gray #CFCFCF for 'text-primary'), lacks executable code examples, and could benefit from splitting detailed reference tables into separate files.
Suggestions
Review and fix apparently erroneous values: input height of 0px, surface-raised (#85292D) being dark red in a light-mode system, and text-primary (#CFCFCF) being very light gray which would fail the stated 4.5:1 contrast ratio against #F4F3F4 background.
Add executable code examples showing how to apply the design tokens (e.g., Tailwind config snippets, CSS custom properties setup, or component examples).
Move detailed reference tables (full font size list, border-radius scale, text styles table) into separate reference files and link to them from the main skill.
Remove redundant information like the border-radius scale listed twice and the 'Count' column in the text styles table that adds no value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains useful reference data but is overly verbose in places—listing every detected font size (5px through 62px), redundant border-radius scales repeated twice, and some questionable values (e.g., `surface-raised` as #85292D which is a dark red, not a typical 'raised surface' color in a light-mode design system). Some tables include a 'Count' column with all 1s, adding no value. | 2 / 3 |
Actionability | The skill provides concrete design tokens, specific hex values, and clear MUST/SHOULD/NEVER constraints, which is good. However, it lacks executable code examples (e.g., CSS/Tailwind snippets showing how to apply these tokens), and some values appear contradictory or erroneous (input height of 0px, surface-raised being a dark red), which undermines practical usability. | 2 / 3 |
Workflow Clarity | This is primarily a reference/constraint skill rather than a multi-step workflow, so explicit sequencing is less critical. However, the 'When to Apply' section is vague, and there's no guidance on how to resolve conflicts between constraints or how to validate that an implementation conforms to the design system. | 2 / 3 |
Progressive Disclosure | The content is well-structured with clear sections and tables, but it's quite long (~180 lines) with detailed reference tables that could be split into separate files (e.g., COLORS.md, TYPOGRAPHY.md). There are no references to external files for deeper detail, and everything is inlined in a single document. | 2 / 3 |
Total | 8 / 12 Passed |