CtrlK
BlogDocsLog inGet started
Tessl Logo

design-standards

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

Quality

72%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/design-standards/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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.'

DimensionReasoningScore

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.

DimensionReasoningScore

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

10

/

11

Passed

Repository
rampstackco/claude-skills
Reviewed

Table of Contents

Is this your skill?

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.