Build production-ready frontend components with accessible markup, sensible props, defined states, and tested behavior. Use this skill whenever the user wants to build a component from scratch, refactor an existing one, design a component API, or implement a UI element with proper states and accessibility. Triggers on build a component, create a button, create a modal, create a form input, component API, props design, component states, refactor component, accessible component. Also triggers when implementing UI from a design that needs to be reusable.
63
74%
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/frontend-component-build/SKILL.mdQuality
Discovery
92%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 strong skill description that clearly articulates what it does (build production-ready frontend components with specific qualities) and when to use it (with explicit trigger terms and use-case guidance). The description is well-structured with concrete actions and natural language triggers. The only minor weakness is potential overlap with other frontend/UI-related skills, though the focus on component architecture, accessibility, and props design provides reasonable differentiation.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple specific concrete actions: 'Build production-ready frontend components with accessible markup, sensible props, defined states, and tested behavior.' It also specifies building from scratch, refactoring, designing component APIs, and implementing UI elements with proper states and accessibility. | 3 / 3 |
Completeness | Clearly answers both 'what' (build production-ready frontend components with accessible markup, sensible props, defined states, tested behavior) and 'when' (explicit 'Use this skill whenever...' clause plus a detailed 'Triggers on' list). | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'build a component', 'create a button', 'create a modal', 'create a form input', 'component API', 'props design', 'component states', 'refactor component', 'accessible component'. These are highly natural phrases a developer would use. | 3 / 3 |
Distinctiveness Conflict Risk | While it targets frontend component building specifically, terms like 'build a component' and 'create a button' could overlap with general frontend/UI skills or design system skills. The focus on props, states, and accessibility helps distinguish it, but 'frontend components' is still a broad domain that could conflict with styling, layout, or framework-specific skills. | 2 / 3 |
Total | 11 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured, comprehensive component-building guide with strong progressive disclosure and clear organization across six dimensions. Its main weaknesses are the lack of any executable code examples (unusual for a frontend component skill) and missing validation checkpoints in the workflow. The content could be tightened by removing explanations of concepts Claude already understands (semantic HTML basics, what ARIA is) and adding concrete, copy-paste-ready code snippets.
Suggestions
Add at least 2-3 executable code examples showing a minimal accessible component implementation (e.g., an accessible button in React/vanilla JS) to improve actionability from descriptive to concrete.
Insert explicit validation checkpoints in the workflow, such as 'Run automated accessibility checks (axe) after adding interaction and ARIA' before proceeding to final testing and documentation.
Trim explanatory content Claude already knows—e.g., remove 'Semantic HTML elements (<button>, <a>, <nav>, <form>, etc.) over generic <div>' phrasing and just specify the rule concisely.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is generally well-organized but includes some material Claude already knows (e.g., explaining what semantic HTML is, listing common anatomies like Button: container + label + icon). The 'When to use' / 'When NOT to use' / 'Required inputs' sections add moderate overhead. Some sections like failure patterns repeat accessibility guidance already covered in the accessibility section. | 2 / 3 |
Actionability | The skill provides concrete guidance on API design principles, accessibility patterns, and testing priorities, but lacks any executable code examples. For a component-building skill, the absence of even one concrete code snippet (e.g., a minimal accessible button implementation) is a significant gap. The guidance is specific but descriptive rather than executable. | 2 / 3 |
Workflow Clarity | The 10-step workflow is clearly sequenced and logical, but lacks explicit validation checkpoints or feedback loops. For component building—which involves markup correctness, accessibility compliance, and visual verification—there should be explicit 'validate before proceeding' gates (e.g., run axe checks after step 7 before moving to step 8). The testing step comes only at the end. | 2 / 3 |
Progressive Disclosure | The skill has a clear overview structure with well-signaled one-level-deep references to three specific reference files (component-spec-template.md, component-api-patterns.md, accessibility-patterns.md). It also clearly delineates when to use other skills (design-system, design-standards, etc.). The content is appropriately split between overview and detailed references. | 3 / 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.