Apply production-grade design standards when building or reviewing pages, components, or UI. Use this skill whenever the user asks to build a page, design a component, lay out a section, review the UI, fix the layout, or check design quality. Triggers on build a page, create a component, design a section, hero, card, CTA, layout, review the UI, fix the design, design system, design tokens, spacing, typography scale, button standards, mobile design. Also triggers for any production design decision where contrast, accessibility, spacing, or visual hierarchy matters.
61
72%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/design-standards/SKILL.mdQuality
Discovery
82%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 solid description with strong trigger term coverage and clear completeness, explicitly stating both what the skill does and when to use it. Its main weaknesses are that the capability description is somewhat general (focusing on 'apply standards' rather than listing specific concrete actions) and the broad scope creates moderate overlap risk with other frontend/UI skills.
Suggestions
Add more specific concrete actions to improve specificity, e.g., 'Enforces spacing scales, audits color contrast ratios, applies typography hierarchies, validates responsive breakpoints' rather than the general 'apply production-grade design standards'.
Narrow the scope or add differentiating language to reduce conflict risk with general frontend skills, e.g., 'Focuses on visual design quality and design system adherence, not on code implementation or framework-specific logic.'
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (UI/design) and mentions actions like 'building or reviewing pages, components, or UI,' but the actions are somewhat general rather than listing multiple concrete, distinct operations (e.g., it doesn't specify things like 'generate color palettes,' 'audit contrast ratios,' or 'create responsive grid layouts'). | 2 / 3 |
Completeness | Clearly answers both 'what' (apply production-grade design standards when building or reviewing pages/components/UI) and 'when' (explicit 'Use this skill whenever...' clause with detailed trigger scenarios and terms). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'build a page,' 'create a component,' 'hero,' 'card,' 'CTA,' 'fix the design,' 'design tokens,' 'spacing,' 'typography scale,' 'button standards,' 'mobile design,' 'accessibility,' 'contrast,' 'visual hierarchy.' These are terms users would naturally use. | 3 / 3 |
Distinctiveness Conflict Risk | While it carves out a niche around production-grade design standards, the broad scope covering 'pages, components, or UI' plus terms like 'build a page' or 'create a component' could easily overlap with general frontend development skills, component library skills, or accessibility-specific skills. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
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, well-organized design standards skill with a clear workflow and useful specific values (contrast ratios, spacing scales, viewport breakpoints). Its main weaknesses are moderate verbosity—some sections explain concepts Claude already understands—and a lack of executable examples or concrete code snippets. The referenced bundle files are missing, which undermines the progressive disclosure structure.
Suggestions
Add at least one concrete code example per standard (e.g., a CSS custom properties block for tokens, a contrast-check command, a sample Tailwind class composition) to improve actionability.
Trim explanatory content Claude already knows—e.g., remove the paragraph explaining what visual hierarchy is and the proximity principle definition—and keep only the specific rules and failure patterns.
Move the detailed token specification lists and failure patterns into reference files to reduce the main SKILL.md length and improve progressive disclosure.
Ensure the referenced bundle files (design-tokens-template.md, preship-checklist.md, tailwind-patterns.md) actually exist in the bundle to support the navigation structure.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is generally well-structured but includes some content Claude already knows (e.g., explaining what visual hierarchy is, proximity principle, basic contrast ratios). The 'when NOT to use' section and some failure pattern descriptions add bulk. However, the tables and token lists are useful reference material that earns its place. | 2 / 3 |
Actionability | The skill provides specific numeric values (contrast ratios, spacing scales, viewport sizes, touch targets) which are concrete and useful. However, it lacks any executable code examples—no CSS snippets, no token file examples, no contrast-checking commands. For a design standards skill this is partially justified, but the guidance remains at the 'what to do' level rather than 'here's exactly how to do it.' | 2 / 3 |
Workflow Clarity | The 7-step workflow is clearly sequenced with explicit validation checkpoints (step 5: contrast checks, step 6: viewport testing, step 7: pre-ship checklist). The sequence is logical (tokens → hierarchy → build → apply → validate → test → ship) and includes a feedback-loop-like structure with the checklist reference. | 3 / 3 |
Progressive Disclosure | The skill references three external files (design-tokens-template.md, preship-checklist.md, tailwind-patterns.md) with clear signaling, which is good structure. However, no bundle files were provided, meaning these references are broken. Additionally, the main body is quite long (~200+ lines) with detailed inline content (token lists, failure patterns, mobile rules) that could be split into reference files for better progressive disclosure. | 2 / 3 |
Total | 9 / 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 | |
8e70d03
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.