CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aria-allowed-attr

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

53

Quality

67%

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

Quality

Content

50%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 as an overview with excellent progressive disclosure to a single real reference file, but it reads as a template skeleton: Check/Fix/Explain sections state what to do without any concrete method, and the Quick Reference bullets duplicate the intro. Moving one or two concrete anchors (a valid/invalid role-attribute pair, a checker command) inline and cutting the redundant bullets would materially raise actionability and conciseness.

Suggestions

Inline one concrete good/bad example in the Check or Fix section (e.g., aria-checked is valid on role="checkbox" but invalid on role="heading") so the body is actionable without opening the reference.

Delete or merge the 'Quick Reference' bullets that restate the intro paragraph, particularly 'Using unsupported attributes can confuse assistive technologies' and 'Ensures the accessibility tree remains valid and meaningful'.

Add an explicit verification checkpoint in the body's workflow (e.g., 'Confirm the fix with the browser accessibility tree or an axe/Lighthouse run') instead of only 'note how to verify the fix'.

DimensionReasoningScore

Conciseness

The body is short and doesn't explain basics Claude already knows, but the 'Quick Reference' bullets duplicate the intro ('Using unsupported attributes can confuse assistive technologies' restates 'Invalid ARIA attributes are ignored by screen readers or may cause them to misinterpret') and 'Ensures the accessibility tree remains valid and meaningful' is filler. Not 4 because real redundancy exists that could be trimmed; not 2 because there is no padded multi-paragraph over-explanation.

3 / 5

Actionability

The body states goals rather than executable steps: 'Verify that all ARIA attributes used on elements are valid for their assigned WAI-ARIA roles' and 'Remove or correct ARIA attributes that are not supported' give no method — no role/attribute pairing examples, no checker commands, no spec lookup guidance; the concrete material (code example, axe/Lighthouse verification) lives only in references/rule.md. Not 3 because even the body's core Check/Fix sections lack any concrete detail; not 1 because the sections do name the exact rule target and the reference pointer is explicit.

2 / 5

Workflow Clarity

Check → Fix → Explain → Code Review provides a recognizable sequence, but validation checkpoints are only implicit ('note how to verify the fix with browser accessibility tooling') and the actual verification steps are delegated to the reference. Not 4 because no explicit verify-then-proceed checkpoint exists in the body; not 2 because the section ordering does define a coherent rough sequence for the review task.

3 / 5

Progressive Disclosure

The body is a lean overview with well-organized sections and exactly one clearly signaled, one-level-deep reference ('For full implementation details, code examples, and framework-specific guidance, see references/rule.md'), which exists and appropriately holds the code example, exceptions, standards, and verification detail. Not 4 because there are no organization gaps: the split is clean and navigation is trivial.

5 / 5

Total

13

/

20

Passed

Description

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

The description answers both what and when with several concrete inspection actions and a genuine 'Use when' trigger, but is dragged down by template phrasing: the rule title is spliced awkwardly into the trigger clause and the shared boilerplate would fire identically for sibling accessibility rules. Tightening the when-clause and adding natural synonyms (accessibility, a11y, WAI-ARIA) would lift it.

DimensionReasoningScore

Specificity

Lists several concrete actions ('Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output') with only minor gaps. Not 5 because no flag/fix/reporting actions are named and the 'when' clause awkwardly embeds the rule title instead of crisp capabilities; not 3 because multiple specific inspection actions are explicitly stated rather than just 1-2.

4 / 5

Completeness

Explicitly answers both 'what' ('Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output') and 'when' ('Use when reviewing rendered HTML, interactive components, or design-system patterns'). Not 5 because the when-clause is convoluted ('related to Use only allowed ARIA attributes for each role') and less explicit than concrete trigger phrases; not 3 because a real 'Use when...' clause is present.

4 / 5

Trigger Term Quality

Good natural keyword coverage ('rendered HTML', 'interactive components', 'design-system patterns', 'keyboard behavior', 'focus flow', 'accessible names', 'screen-reader output', 'ARIA attributes'). Not 5 because common variations users actually say like 'accessibility', 'a11y', 'WAI-ARIA', or 'aria-*' are missing; not 3 because coverage goes well beyond a couple of generic terms.

4 / 5

Distinctiveness Conflict Risk

The trigger template ('Use when reviewing rendered HTML, interactive components, or design-system patterns related to...') would be identical across sibling frontend-checklist accessibility skills, with only the embedded rule title ('Use only allowed ARIA attributes for each role') distinguishing it. Not 4 because overlap risk with closely related ARIA/accessibility skills is real, not minor; not 2 because the rule title and ARIA-specific vocabulary do carve out a recognizable niche.

3 / 5

Total

15

/

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

Path

skills/aria-allowed-attr/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.