CtrlK
BlogDocsLog inGet started
Tessl Logo

tdg-personal/frontend-design

Create distinctive, production-grade frontend interfaces with high design quality. Use when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality.

60

Quality

60%

Does it follow best practices?

Impact

Pending

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

Quality

Discovery

67%

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

The description has a solid structure with an explicit 'Use when' clause and attempts to differentiate itself through design quality emphasis. However, it relies on vague qualifiers ('distinctive', 'production-grade', 'high design quality') rather than listing specific concrete capabilities, and its trigger terms miss many natural phrases users would employ when requesting frontend design work. The distinctiveness hinge on 'visual direction matters' is subjective and could cause confusion in skill selection.

Suggestions

Add specific concrete actions such as 'build responsive layouts, style components with CSS, implement design systems, create landing pages' to improve specificity.

Expand trigger terms to include natural user language like 'UI', 'CSS', 'HTML', 'styling', 'responsive design', 'landing page', 'website design', '.html', '.css'.

Sharpen the distinctiveness by clarifying what differentiates this from a general frontend coding skill—e.g., mention specific design frameworks, pixel-perfect implementation, or aesthetic-focused deliverables.

DimensionReasoningScore

Specificity

Names the domain ('frontend interfaces') and some general actions ('build web components, pages, or applications'), but lacks specific concrete actions like 'create responsive layouts, style forms, implement animations, build navigation menus'. 'Distinctive, production-grade' and 'high design quality' are somewhat vague qualifiers rather than concrete capabilities.

2 / 3

Completeness

Clearly answers both 'what' (create distinctive, production-grade frontend interfaces) and 'when' (when the user asks to build web components, pages, or applications and the visual direction matters as much as the code quality). The 'Use when' clause is explicit with a qualifying condition.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'web components', 'pages', 'applications', and 'visual direction', but misses many natural user terms such as 'UI', 'CSS', 'HTML', 'styling', 'layout', 'responsive', 'design system', 'landing page', 'website', or 'frontend design'. Users asking for beautiful UIs might not use the phrase 'visual direction matters'.

2 / 3

Distinctiveness Conflict Risk

The qualifier 'visual direction matters as much as the code quality' attempts to carve out a niche from generic frontend/coding skills, but the boundary is subjective and could easily overlap with general web development or UI component skills. It's not entirely clear when this skill should be chosen over a standard frontend coding skill.

2 / 3

Total

9

/

12

Passed

Implementation

35%

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

This skill reads more like a design philosophy manifesto than an actionable technical skill. While it establishes a clear aesthetic point of view and has decent structural organization, it critically lacks any concrete code examples, CSS patterns, component templates, or executable guidance that would make it useful for actually building frontends. The content would benefit enormously from specific implementation examples that demonstrate the principles it describes.

Suggestions

Add concrete, executable code examples: CSS variable templates for design tokens, example animation keyframes, a sample component structure that demonstrates the principles (e.g., a hero section that avoids the anti-patterns listed).

Include at least one complete before/after example showing a 'generic AI UI' component transformed into a 'designed' component with actual HTML/CSS code.

Add a feedback loop to the quality gate: specify how to evaluate the output (e.g., 'screenshot at 3 breakpoints and verify visual hierarchy holds') and what to do when it fails.

Extract detailed guidance (typography pairing strategies, color palette construction, animation patterns) into referenced files to keep the main skill lean while providing depth when needed.

DimensionReasoningScore

Conciseness

The content is reasonably efficient and avoids explaining basic concepts, but some sections are verbose for what they convey. Lists like 'possible directions' and the anti-patterns section could be tightened. The skill also explains design principles Claude likely already understands (e.g., 'use animation to reveal hierarchy').

2 / 3

Actionability

The skill is almost entirely abstract guidance with no concrete code, commands, CSS snippets, or executable examples. For a frontend design skill, there are no actual implementation patterns—no CSS variable templates, no animation code, no component structures. It describes rather than instructs.

1 / 3

Workflow Clarity

There is a clear 4-step workflow sequence (Frame → Build visual system → Compose → Motion), and a quality gate checklist at the end. However, the quality gate is a subjective checklist without concrete validation steps, and there's no feedback loop for iterating on designs that don't meet the gate criteria.

2 / 3

Progressive Disclosure

The content is well-structured with clear headers and logical sections, but it's a monolithic document with no references to external files for deeper topics. Sections like 'Strong Defaults' contain substantial inline content that could benefit from being split into referenced files for typography systems, color palettes, or animation patterns.

2 / 3

Total

7

/

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

Reviewed

Table of Contents