CtrlK
BlogDocsLog inGet started
Tessl Logo

aria-tooltip-name

Use when reviewing rendered HTML, interactive components, or design-system patterns related to Provide accessible names for tooltips. Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output where relevant.

61

Quality

72%

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/aria-tooltip-name/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

70%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.

A clean, well-structured overview body that delegates detail correctly to references/rule.md. It loses points on duplication between the Quick Reference, Check, and Code Review sections and on fix guidance that names the goal but not the concrete mechanism (no inline markup example, no aria-label mention).

Suggestions

Merge the Quick Reference bullets with the Check section — they restate the same accessible-name/aria-describedby verification three times — and drop the generic "Code Review" boilerplate that repeats the description.

Add a short inline correct/incorrect markup example (a trigger with aria-describedby and a role="tooltip" element with aria-label) so the Fix section shows the concrete mechanism, not just the goal.

State the fix attributes explicitly in the Fix section (e.g., name via aria-label or associate via aria-describedby) instead of the abstract "Assign an accessible name... or ensure it is correctly referenced".

DimensionReasoningScore

Conciseness

The body is compact, but the Quick Reference bullets ("Tooltips must have an accessible name or be referenced by `aria-describedby`") nearly duplicate the Check section ("Verify that all elements with role="tooltip" have an accessible name or are linked... via aria-describedby"), and the "Code Review" section is generic boilerplate that largely restates the description. This is mostly efficient but could be noticeably tightened, matching anchor 3 rather than the minor-trim profile of anchor 4.

3 / 5

Actionability

The Check section is concrete (specific role="tooltip" and aria-describedby attributes to look for), but the Fix section — "Assign an accessible name to the tooltip or ensure it is correctly referenced" — never states how (e.g., aria-label) and the body includes no correct/incorrect markup example, deferring all specifics to the reference. Some concrete guidance but missing key executable details (anchor 3); anchor 4 would require concrete code or commands in the body with only minor gaps.

3 / 5

Workflow Clarity

This is a simple, single-purpose review skill under 50 lines, and the single action is unambiguous: Check states exactly what to verify (tooltip elements have an accessible name or an aria-describedby association). The Quick Reference → Check → Fix → Explain → Code Review sequence is clear and well-organized, so the simple-skill exception applies.

5 / 5

Progressive Disclosure

The body is a concise overview with a clearly signaled one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`" — and that file actually exists with exactly that class of content (code examples, why-it-matters, exceptions, verification steps). Content is appropriately split between overview and reference with easy navigation.

5 / 5

Total

16

/

20

Passed

Description

75%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 solid description with an explicit 'Use when...' trigger and several concrete inspection actions. Its main weaknesses are templated phrasing (the rule title spliced verbatim into a "related to..." clause) and missing the most natural domain keywords (accessibility, a11y, ARIA).

DimensionReasoningScore

Specificity

Quotes several concrete actions — "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" — which are specific inspection actions. Not a 5 because the capability is stated only through the awkwardly embedded clause "related to Provide accessible names for tooltips" and the actions are all inspection/review verbs with no fix-side coverage, leaving minor gaps.

4 / 5

Completeness

Both parts are explicitly present: the trigger clause "Use when reviewing rendered HTML, interactive components, or design-system patterns related to..." answers 'when', and "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" answers 'what'. Not a 5 because the core 'what' (verifying tooltip naming/association) is buried in the templated "related to Provide accessible names for tooltips" clause rather than stated as a concrete capability.

4 / 5

Trigger Term Quality

Includes natural phrases users would say — "rendered HTML", "interactive components", "tooltips", "accessible names", "screen-reader" — but omits the most common natural terms for this domain: "accessibility", "a11y", "ARIA", and "aria-describedby". This is good coverage with a few natural terms missing (anchor 4), not comprehensive synonym coverage (anchor 5).

4 / 5

Distinctiveness Conflict Risk

The tooltip-specific trigger ("Provide accessible names for tooltips") carves out a clear niche with minimal conflict risk against unrelated skills. Not a 5 because the generic review-protocol boilerplate ("Check native semantics first, then inspect keyboard behavior, focus flow, and screen-reader output") would read identically across sibling accessibility skills, creating overlap risk with closely related a11y rules.

4 / 5

Total

16

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

Total

15

/

16

Passed

Repository
thedaviddias/Front-End-Checklist
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.