CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

building-components

Guide for building modern, accessible, and composable UI components. Use when building new components, implementing accessibility, creating composable APIs, setting up design tokens, publishing to npm/registry, or writing component documentation.

60

Quality

76%

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 ./.agents/skills/building-components/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

58%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 an exemplary lean index with excellent progressive disclosure and token efficiency, but it over-delegates: it contains no quick-start guidance, no code example, and no recommended reading order or process flow for the multi-step task of building and publishing a component. Adding a minimal getting-started sequence inline would raise actionability and workflow clarity without sacrificing conciseness.

Suggestions

Add a short quick-start section (e.g., a minimal composable component snippet showing the core pattern) so the skill instructs, not just navigates.

Order or group the references as a suggested workflow (definitions → principles → accessibility/composition → styling → publishing) so users get an implicit process sequence.

Include a validation checkpoint in the workflow (e.g., "verify keyboard navigation and ARIA roles against accessibility.mdx before publishing") to close the feedback loop for the multi-step build process.

DimensionReasoningScore

Conciseness

The body is 37 lines with zero padding: no explanations of concepts Claude already knows, just a compact "When to use this skill" bullet list and 15 one-line annotated reference links. Every token earns its place, matching anchor 5.

5 / 5

Actionability

The body contains no executable guidance at all — no quick-start example, no code, no concrete steps for building a component; it is purely an index ("[accessibility.mdx](./references/accessibility.mdx) - ARIA, keyboard navigation, WCAG compliance"). This sits between anchor 1 ("only describes rather than instructs") and anchor 3 ("some concrete guidance but incomplete") — the annotated links are high-level pointers but lack any specific steps to execute, fitting anchor 2.

2 / 5

Workflow Clarity

Building a component is inherently multi-step (define, type, style, test, document, publish), but the body provides no sequence, no indication of which reference to start with or in what order, and no validation checkpoints (e.g., accessibility testing). There is a rough topical organization but many gaps and no defined steps — anchor 2, not 3, because not even an implicit step order exists.

2 / 5

Progressive Disclosure

The body is a lean overview that delegates all detail to 15 one-level-deep reference files, all of which exist and contain substantive content, each signposted with a one-line description of its scope. This is exactly anchor 5's "clear overview with well-signaled one-level-deep references... easy navigation" — no inlined bulk content and no nested references.

5 / 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 explicitly states what the skill does and when to use it, with a solid set of natural trigger phrases. The main weaknesses are a somewhat generic 'what' clause and omission of a few body-covered topics (polymorphism, data attributes, ARIA) that would sharpen both capability coverage and trigger matching.

Suggestions

Tighten the 'what' clause with more concrete capabilities, e.g., "Guide for building, typing, styling, and publishing accessible, composable UI components".

Add the natural trigger terms already covered by the body's reference set — "ARIA", "theming", "as-child/polymorphic components", and "data attributes" — to the 'Use when' clause.

DimensionReasoningScore

Specificity

"Guide for building modern, accessible, and composable UI components" names the domain, and the trigger clause enumerates several concrete actions ("building new components, implementing accessibility, creating composable APIs, setting up design tokens, publishing to npm/registry, or writing component documentation"). It falls just below a 5 because the 'what' is a single high-level statement and body-covered topics like polymorphism/as-child and data attributes are absent — minor gaps, matching anchor 4 rather than 5.

4 / 5

Completeness

It explicitly answers both: the 'what' ("Guide for building modern, accessible, and composable UI components") and the 'when' with concrete trigger phrases ("Use when building new components, implementing accessibility, creating composable APIs, setting up design tokens, publishing to npm/registry, or writing component documentation"). This mirrors the anchor-5 example's structure (what statement + explicit 'Use when' with concrete triggers), and is above anchor 4 because the 'when' is explicit and specific, not merely present.

5 / 5

Trigger Term Quality

Natural phrases users would say are present ("building new components", "implementing accessibility", "design tokens", "publishing to npm", "component documentation"), giving good keyword coverage. A few natural terms are missing (e.g., "ARIA", "theming", "as-child", "polymorphic"), so it fits anchor 4 ("Good keyword coverage; a few natural terms missing") rather than the comprehensive synonym coverage of anchor 5.

4 / 5

Distinctiveness Conflict Risk

Triggers like "composable APIs", "design tokens", and "publishing to npm/registry" carve out a distinct component-building niche, but the broad "building new components" and "accessibility" triggers could overlap with general web-development or styling skills. Mostly distinct with minor overlap risk against closely related skills — anchor 4, not 5's 'minimal conflict risk'.

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

databricks/devhub

Path

.agents/skills/building-components/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.