CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

58

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

63%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 with exemplary progressive disclosure — a concise overview pointing to a single real reference file that carries the details. Its weaknesses are internal redundancy (the same rule rationale stated three times), no inline example or tooling to make the Check/Fix guidance immediately executable, and a grammatically broken sentence in the Code Review section.

Suggestions

Cut the "Quick Reference" bullets and "Explain" section, which merely restate the intro paragraph's rationale that Claude already knows, keeping the intro as the sole motivation.

Inline one concrete violation example (e.g., aria-checked on role="heading" from the reference) so the Check section is actionable without hopping to references/rule.md.

Name a concrete verification tool in the body (axe, Lighthouse, or the browser accessibility tree) instead of the generic "browser accessibility tooling or assistive tech", and fix the broken Code Review sentence that splices the rule title into the prose.

DimensionReasoningScore

Conciseness

The body states the same known concept three times — the intro paragraph ("Invalid ARIA attributes are ignored by screen readers..."), the three "Quick Reference" bullets, and the "Explain" section all restate that unsupported attributes break assistive-tech communication, which is knowledge Claude already has. This matches 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not 2 because the body is short and free of long padded tutorials.

3 / 5

Actionability

The Check/Fix/Code Review sections give directed guidance ("Verify that all ARIA attributes used on elements are valid for their assigned WAI-ARIA roles", "Flag exact elements, roles, labels, focus behavior, or keyboard interactions") and concrete tooling exists one hop away in references/rule.md (axe, Lighthouse, accessibility-tree inspection). It is not 4 because the body itself contains no executable example, tool name, or allowed-attribute reference — every inline instruction is a high-level directive with the key details deferred.

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review section sequence is clear for a simple single-purpose skill, and verification steps (automated and manual) exist in the reference, matching 'clear sequence with most checkpoints present; minor validation gaps'. It is not 5 because no validation checkpoint appears in the body itself and the Code Review section's sentence "Review the rendered markup and interactive states that affect Use only allowed ARIA attributes for each role" is grammatically broken, slightly muddying the final step.

4 / 5

Progressive Disclosure

The body is a short, well-sectioned overview that clearly signals exactly one one-level-deep reference — "For full implementation details, code examples, and framework-specific guidance, see references/rule.md" — and that file exists and delivers precisely what is promised (code example, exceptions, standards, verification steps). This matches the 'clear overview with well-signaled one-level-deep references; easy navigation' anchor, and the sub-50-line guideline for simple skills also supports a 5.

5 / 5

Total

15

/

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 has a solid explicit 'Use when' trigger and names several concrete accessibility-review actions, placing it above the midpoint on most dimensions. Its main weaknesses are a garbled core-capability statement (the rule title spliced into the sentence), missing common synonyms like 'accessibility'/'a11y'/'WCAG', and a broad when-clause that would conflict with sibling accessibility-rule skills.

Suggestions

Rewrite the 'what' as a proper verb phrase, e.g., "Verify that every ARIA attribute on an element is supported by its assigned WAI-ARIA role and remove unsupported ones", instead of embedding the rule title mid-sentence.

Narrow the when-clause to ARIA-specific triggers (e.g., "when the user mentions ARIA roles, aria-* attributes, or invalid accessibility markup") so it does not fire identically to sibling accessibility rules that share the 'reviewing rendered HTML, interactive components' template.

Add natural synonyms users actually say — "accessibility", "a11y", "WCAG", "screen reader" — to broaden trigger-term coverage.

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 matches the 'several specific actions; minor gaps' anchor. It is not a 5 because the core capability is never stated as a clean action (the rule title is embedded mid-sentence as "related to Use only allowed ARIA attributes for each role") and "where relevant" hedges the coverage; it is above 3 because multiple genuinely specific inspection actions are named.

4 / 5

Completeness

Both halves are present: an explicit "Use when reviewing rendered HTML, interactive components, or design-system patterns..." when-clause and a what conveyed by the ARIA-attribute checking actions. It is not a 5 because the 'what' is not clearly stated — "related to Use only allowed ARIA attributes for each role" is a grammatically broken template substitution that muddles the capability rather than concretely naming it.

4 / 5

Trigger Term Quality

Keywords like "rendered HTML", "ARIA attributes", "keyboard behavior", "focus flow", "accessible names", and "screen-reader output" give good natural-term coverage, matching the 'good keyword coverage; a few natural terms missing' anchor. It falls short of 5 because common user phrasings such as "accessibility", "a11y", "WCAG", and "aria-*" are absent, and above 3 because coverage goes well beyond a single generic keyword.

4 / 5

Distinctiveness Conflict Risk

The rule topic itself (allowed ARIA attributes per role) is a recognizable niche, but the when-clause "reviewing rendered HTML, interactive components, or design-system patterns" is a broad template that would trigger identically for many sibling accessibility rules (e.g., other ARIA or keyboard/focus rules), so overlap with closely related skills is real. It is above 2 only because the embedded rule name and ARIA-specific terms provide some differentiation.

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