CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

frontend-ui-engineering

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

Quality

78%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/frontend-ui-engineering/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

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

The body is well-structured and unusually strong on actionable, opinionated frontend guidance (composition patterns, design-system adherence, the AI-aesthetic table, verification checklist), though it leans long at ~335 lines. Its main weaknesses are re-explaining accessibility and React fundamentals Claude already knows, and a broken bundle-external reference with inlined accessibility detail that progressive disclosure should have moved to a real one-level-deep reference file.

Suggestions

Trim the sections that re-teach fundamentals Claude already knows (basic aria-label/htmlFor syntax, heading-level rules, the useState→Context→Redux ladder, and the div-vs-button focusability example) down to only the project-specific rules, cutting roughly 80–100 lines.

Fix the broken reference: replace '../../references/accessibility-checklist.md' (which escapes the skill bundle two levels up and does not exist) with a one-level-deep path inside the bundle such as 'references/accessibility-checklist.md', and create that file.

Move the detailed accessibility code examples (keyboard navigation, ARIA labels, focus management) into the referenced checklist file and keep only a short summary plus the link in SKILL.md.

DimensionReasoningScore

Conciseness

Much of the body is high-value opinionated guidance Claude would not generate on its own (the AI-aesthetic table, spacing-scale rules, rationalizations table), but several sections re-teach things Claude already knows: basic aria-label/htmlFor syntax, 'Don't skip heading levels', the useState→Context→Redux ladder, and that a div with onClick is not focusable. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; not 2 because there is no tutorial-style padding or library intro prose.

3 / 5

Actionability

Concrete TSX examples appear throughout (composition over configuration, container/presentation split, optimistic updates with React Query, skeleton loaders, focus management) plus a specific breakpoint test list (320/768/1024/1440px). Mostly executable with minor gaps — snippets depend on undefined project components (Button, Checkbox, useTasks) so they are illustrative rather than copy-paste ready, keeping it below the 5 anchor.

4 / 5

Workflow Clarity

The 'Reference-led UI quality' section gives a clear numbered 1-4 sequence, and the closing Verification section is an explicit checklist (keyboard tab-through, screen reader, breakpoints, axe-core) acting as validation checkpoints. Not 5 because the overall build workflow is implicit — the skill is reference-style guidance rather than a sequenced process with feedback loops between steps.

4 / 5

Progressive Disclosure

Section structure is clear, but the only reference ('../../references/accessibility-checklist.md') points two levels outside the skill bundle, no references/ directory exists in the bundle, and the target file cannot be found anywhere — the link is effectively broken. Additionally, ~80 lines of detailed accessibility patterns that supposedly live in that checklist are inlined in the body, fitting 'some structure but could be better organized; content that should be separate is inline'.

3 / 5

Total

14

/

20

Passed

Description

83%Weight 40%Scale 1-5

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

A strong description that clearly states what the skill does and gives an explicit, trigger-rich 'Use when' clause covering components, layouts, state, accessibility, and responsive work. Keyword coverage is good but misses a few natural synonyms ('frontend', 'React', 'CSS'), and the broad 'building or modifying interfaces' scope leaves minor overlap risk with adjacent skills.

DimensionReasoningScore

Specificity

The description names the domain ('user-facing UIs') and enumerates several concrete actions ('creating components, implementing layouts... managing state' and 'meeting WCAG accessibility requirements'), matching the 'several specific actions; minor gaps' anchor. Not 5 because the core 'what' is a single generic verb ('Builds') and coverage gaps exist (e.g., no verification/testing actions); not 3 because more than 1-2 concrete actions are explicitly listed.

4 / 5

Completeness

Explicitly answers both: what ('Builds production-quality, accessible, responsive user-facing UIs') and when ('Use when building or modifying interfaces and pages, creating components, implementing layouts, meeting WCAG accessibility requirements, managing state, or when the output needs to look and feel production-quality'). Concrete trigger phrases are present, matching the top anchor exactly.

5 / 5

Trigger Term Quality

Includes natural phrases users would say: 'interfaces and pages', 'components', 'layouts', 'WCAG accessibility', 'managing state', 'responsive'. A few common natural terms are missing (e.g., 'frontend', 'React', 'CSS', 'design system'), fitting the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

A clear frontend-UI niche with distinct triggers (WCAG, 'production-quality rather than AI-generated') keeps conflict risk low, but 'building or modifying interfaces and pages' is broad enough to overlap with closely related skills (generic web development or design-system skills). Mostly distinct with minor overlap risk; not a fully unique niche like the 5 anchor.

4 / 5

Total

17

/

20

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

addyosmani/agent-skills

Path

skills/frontend-ui-engineering/SKILL.md

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.