Content
62%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a solid design system reference skill with clear constraints using MUST/SHOULD/NEVER language and well-structured tables for design tokens. Its main weaknesses are the lack of any executable code examples (CSS, Tailwind config, or component snippets) and some redundant granularity in the typography section that could be condensed or moved to a reference file.
Suggestions
Add at least one concrete code example - e.g., CSS custom properties setup for the semantic tokens, or a Tailwind config snippet mapping the design tokens
Consolidate the 8 body-secondary text style variants into a single entry with a note about the size range (18-20px), or move the full table to a separate TYPOGRAPHY_REFERENCE.md
Consider splitting detailed reference tables (full text styles, spacing scale, border-radius scale) into a separate reference file, keeping SKILL.md as a concise overview with the most important constraints and quick-reference values
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with well-structured tables and clear MUST/SHOULD/NEVER constraints. However, the Text Styles table contains excessive granularity (8 variants of body-secondary with slightly different pixel sizes and hex colors) that adds noise without clear actionable value. The Typography Reference section partially duplicates information already in the table. | 2 / 3 |
Actionability | The skill provides concrete design tokens, specific values, and clear constraints (MUST/SHOULD/NEVER). However, it lacks any executable code examples - no CSS snippets, no Tailwind config, no component code. For a UI design system skill, at least one concrete implementation example (e.g., a button component or CSS custom properties setup) would make it significantly more actionable. | 2 / 3 |
Workflow Clarity | This is a reference/constraint skill rather than a multi-step workflow skill. The single-purpose nature (apply these design tokens and rules when building UI) is unambiguous. The MUST/SHOULD/NEVER hierarchy provides clear priority ordering, and the 'When to Apply' section clearly scopes usage. | 3 / 3 |
Progressive Disclosure | The content is well-organized with clear sections and tables, but it's a fairly long monolithic document (~150 lines). The detailed text styles table with 10 rows of minor variations and the full border-radius/spacing scales could be split into a reference file, keeping SKILL.md as a concise overview with links to detailed specs. | 2 / 3 |
Total | 9 / 12 Passed |