CtrlK
BlogDocsLog inGet started
Tessl Logo

frontend-ui-engineering

Builds production-quality UIs. Use when building or modifying user-facing interfaces. Use when creating components, implementing layouts, managing state, or when the output needs to look and feel production-quality rather than AI-generated.

58

Quality

66%

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/frontend-ui-engineering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

64%

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, actionable skill with excellent concrete code examples and a particularly valuable 'AI Aesthetic' avoidance table that provides genuinely novel guidance. Its main weaknesses are verbosity (some sections explain things Claude already knows) and the lack of a clear sequential workflow for building components, reading more as a comprehensive reference than a guided process. The referenced accessibility checklist file doesn't exist in the bundle.

Suggestions

Trim sections covering concepts Claude already knows well (basic ARIA patterns, typography hierarchy, what prop drilling is) to brief reminders or remove them entirely, saving ~30-40% of tokens.

Add a brief sequential workflow section (e.g., '1. Define types → 2. Build presentation component → 3. Add container/data layer → 4. Verify with checklist') to give clearer step-by-step guidance.

Either include the referenced `references/accessibility-checklist.md` in the bundle or remove the reference to avoid a dead link.

DimensionReasoningScore

Conciseness

The skill is generally well-structured but includes some content Claude already knows (e.g., explaining what prop drilling is, basic accessibility concepts, the 'Common Rationalizations' table which is motivational rather than instructional). The 'AI Aesthetic' table is valuable and novel, but sections like typography hierarchy and basic ARIA patterns are largely redundant for Claude.

2 / 3

Actionability

The skill provides fully executable, copy-paste-ready code examples throughout — component patterns, state management, accessibility implementations, skeleton loading, optimistic updates with React Query. Every section includes concrete TSX/CSS examples rather than abstract descriptions.

3 / 3

Workflow Clarity

The verification checklist at the end provides clear validation steps, and the state management decision table is a useful workflow guide. However, there's no explicit sequenced workflow for building a component end-to-end (e.g., 'start with types, then presentation, then container, then test, then verify'). The skill reads more as a reference than a step-by-step process, and the verification checklist lacks feedback loops for fixing issues found.

2 / 3

Progressive Disclosure

The skill references `references/accessibility-checklist.md` in a 'See Also' section, but this file doesn't exist in the bundle. The content is quite long (~250 lines) and some sections (like the full optimistic update example or the Common Rationalizations table) could be split into referenced files. The structure within the file is well-organized with clear headers, but it's borderline monolithic.

2 / 3

Total

9

/

12

Passed

Description

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 explicit 'Use when' clauses that clearly communicate both purpose and trigger conditions. However, it lacks specificity in the concrete actions it performs and misses many natural trigger terms users would use when requesting UI work. The broad scope creates moderate conflict risk with other frontend or design-related skills.

Suggestions

Add more specific concrete actions such as 'building forms, modals, navigation bars, dashboards, responsive layouts' to increase specificity.

Include natural trigger terms users would say, such as 'frontend', 'React', 'CSS', 'HTML', 'web app', 'responsive design', or relevant framework names to improve discoverability.

DimensionReasoningScore

Specificity

Names the domain (UI development) and some actions ('creating components, implementing layouts, managing state'), but the actions are somewhat general and not deeply specific — e.g., it doesn't mention specific frameworks, styling approaches, or concrete deliverables like forms, modals, or navigation bars.

2 / 3

Completeness

Clearly answers both 'what' (builds production-quality UIs) and 'when' (use when building/modifying user-facing interfaces, creating components, implementing layouts, managing state, or when output needs to look production-quality). The explicit 'Use when...' clause with multiple trigger scenarios is well-structured.

3 / 3

Trigger Term Quality

Includes some relevant terms like 'components', 'layouts', 'state', 'interfaces', and 'UI', but misses many natural user terms such as 'frontend', 'React', 'CSS', 'HTML', 'web app', 'dashboard', 'form', 'button', 'responsive design', or specific framework names that users would commonly mention.

2 / 3

Distinctiveness Conflict Risk

While 'production-quality UIs' provides some differentiation, the description is broad enough to overlap with general frontend coding skills, component library skills, or design system skills. The phrase 'building or modifying user-facing interfaces' is quite wide and could conflict with more specialized UI-related skills.

2 / 3

Total

9

/

12

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation11 / 11 Passed

Validation for skill structure

No warnings or errors.

Repository
addyosmani/agent-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.