Designs and documents UI component libraries, design token systems, color palettes, typography scales, spacing systems, and responsive layout frameworks. Produces design specifications, style guides, and developer-ready handoff documentation. Use when a user needs to create a design system, build a component library, define a color palette or typography scale, design UI mockups or wireframes, establish a visual style guide, set up CSS tokens or theming (including dark mode), specify accessible interface components (WCAG AA), or produce layout compositions for web or mobile interfaces.
93
92%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Quality
Discovery
100%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong, well-crafted skill description that excels across all dimensions. It provides specific concrete actions, comprehensive trigger terms that users would naturally use, a clear 'Use when...' clause with extensive trigger scenarios, and occupies a distinct niche in design systems and UI component documentation. The description uses proper third-person voice throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'designs and documents UI component libraries, design token systems, color palettes, typography scales, spacing systems, and responsive layout frameworks' plus 'produces design specifications, style guides, and developer-ready handoff documentation.' | 3 / 3 |
Completeness | Clearly answers both 'what' (designs component libraries, token systems, produces specifications and handoff docs) and 'when' with an explicit 'Use when...' clause listing numerous specific trigger scenarios like creating design systems, building component libraries, defining palettes, etc. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural terms users would say: 'design system', 'component library', 'color palette', 'typography scale', 'UI mockups', 'wireframes', 'style guide', 'CSS tokens', 'theming', 'dark mode', 'WCAG AA', 'accessible interface components', 'web or mobile interfaces'. These are terms users would naturally use when requesting this type of work. | 3 / 3 |
Distinctiveness Conflict Risk | Occupies a clear niche around design systems and UI component documentation. The specific triggers like 'design token systems', 'typography scales', 'WCAG AA', and 'developer-ready handoff documentation' are distinct enough to avoid conflicts with general coding or generic design skills. | 3 / 3 |
Total | 12 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with clear workflows, explicit validation checkpoints, and concrete executable examples. The progressive disclosure is handled well with inline excerpts plus references to detailed templates. The main area for improvement is trimming some verbosity in the token excerpt (which is partially redundant with the referenced file) and removing a few unnecessary explanatory phrases.
Suggestions
Shorten the token file excerpt since it references design-tokens-reference.md — show only 2-3 representative token categories instead of the full set to save tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is mostly efficient but includes some content that could be tightened. The token file excerpt is lengthy and somewhat redundant given the reference to design-tokens-reference.md. The component output format section and example section add useful but slightly verbose guidance. Some explanatory phrases like 'build this in from the start, not as a retrofit' are unnecessary for Claude. | 2 / 3 |
Actionability | The skill provides concrete, executable CSS code for tokens, specific breakpoint values in a table, exact pixel/rem values for spacing and typography scales, and a clear example of what output should include for a button component request. The token file excerpt is copy-paste ready and the component spec template structure is specific enough to follow directly. | 3 / 3 |
Workflow Clarity | The 5-step workflow is clearly sequenced with explicit validation checkpoints at Steps 2 and 3 (contrast ratio verification, focus-visible and touch target checks). The deliverable checklist at the end serves as a final validation gate. The dependency ordering is explicit ('Establish tokens before designing any individual components'). | 3 / 3 |
Progressive Disclosure | The skill provides a clear overview with well-signaled one-level-deep references to design-tokens-reference.md and component-spec-template.md. The main content includes representative excerpts so the skill is self-contained for quick reference, while pointing to detailed templates for full specifications. Content is well-organized into logical sections. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
010799b
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.