CtrlK
BlogDocsLog inGet started
Tessl Logo

aria-required-attr

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

57

Quality

66%

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-required-attr/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

57%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 a well-structured, appropriately short overview that correctly delegates detailed code examples to references/rule.md, but its own guidance is vague and redundant (Quick Reference duplicates Check, Explain teaches known basics), and no concrete role→required-attribute details or sequenced verification steps appear in the body itself.

Suggestions

Delete or merge the redundant "Quick Reference" section into "Check", and cut the generic "Explain" rationale that Claude already knows.

Inline a compact role → required-attributes table (slider → aria-valuenow/min/max, scrollbar → aria-controls/orientation/valuenow, etc.) so the core guidance is executable without opening the reference file.

Turn Check/Fix into an ordered review workflow with an explicit verification step (e.g., re-inspect the accessibility tree or re-run axe after adding attributes).

DimensionReasoningScore

Conciseness

The body is short, but the "Quick Reference" bullets largely duplicate the "Check" section ("Ensure attributes like aria-valuenow for sliders are present" vs "Verify that all ARIA roles have their mandatory attributes"), and the "Explain" section restates screen-reader basics Claude already knows. It is mostly efficient but includes unnecessary/redundant material that could be tightened, matching the 3 anchor.

3 / 5

Actionability

There is one concrete example ("aria-valuenow for role='slider'") and a clear pointer to references/rule.md with full code samples, but the body's own guidance is high-level — "Verify that all ARIA roles have their mandatory attributes as defined by the WAI-ARIA specification" gives no list of roles, required attributes, or commands to run. Some concrete guidance exists yet key executable details are missing, fitting the 3 anchor better than the minimal 2.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections imply a loose review sequence, and the Code Review section at least mentions verifying "the fix with browser accessibility tooling or assistive tech", but no explicit ordered steps or validation checkpoints appear in the body (those live in the referenced file). The sequence is present with implicit checkpoints, matching the 3 anchor.

3 / 5

Progressive Disclosure

The ~30-line body is a genuine overview — summary, quick reference, and check/fix/explain/review sections — with a single clearly signaled, one-level-deep pointer ("For full implementation details, code examples, and framework-specific guidance, see `references/rule.md`"), and that file exists in the bundle with no further nesting. This matches the 5 anchor: clear overview, well-signaled reference, easy navigation.

5 / 5

Total

14

/

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, but the primary capability is obscured by the awkward embedded phrase "related to Include required ARIA attributes for roles" and natural synonyms like "accessibility"/"a11y" are absent.

Suggestions

Replace the garbled clause "related to Include required ARIA attributes for roles" with a plain action phrase, e.g., "Identify ARIA roles missing their required attributes (e.g., aria-valuenow on role='slider') and add them".

Add natural trigger synonyms such as "accessibility" or "a11y" so users searching with those common terms match this skill.

State the primary fix action explicitly (flag elements with roles lacking required ARIA attributes) so the "what" is unambiguous.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" — which go beyond naming the domain. However, the core capability is buried in the garbled noun phrase "related to Include required ARIA attributes for roles" rather than stated as an action (e.g., identifying/adding missing required attributes like aria-valuenow), leaving minor gaps in coverage; it is stronger than the 3 anchor (only 1-2 concrete actions) but not the comprehensive 5.

4 / 5

Completeness

Both parts are present: an explicit "Use when reviewing rendered HTML, interactive components, or design-system patterns" trigger clause, and a what expressed through the check/inspect action verbs. The "what" is muddied by the embedded title phrase "Include required ARIA attributes for roles" and never plainly states the primary capability (flag and add missing required ARIA attributes), so it does not clearly and explicitly answer both like the 5 anchor.

4 / 5

Trigger Term Quality

Good natural-keyword coverage: "rendered HTML", "interactive components", "design-system patterns", "keyboard behavior", "screen-reader", "ARIA attributes", "roles". A few common terms a user would naturally say are missing — notably "accessibility" and "a11y" — so it falls short of the 5 anchor's comprehensive synonym coverage.

4 / 5

Distinctiveness Conflict Risk

The ARIA-required-attributes focus is a clear niche with distinct triggers (ARIA roles, attributes, screen-reader output), minimizing conflict risk. The broad opening trigger "reviewing rendered HTML, interactive components, or design-system patterns" overlaps with sibling accessibility/frontend-review skills, keeping it just below the 5 anchor.

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.