CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

aria-command-name

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

58

Quality

73%

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

Quality

Content

71%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, token-efficient overview with excellent progressive disclosure — a single real reference file holds the code examples and verification detail. Its main weakness is actionability: the Check step and verification tooling are described only at a general level in the body, and the how-to specifics live entirely in the reference, so the body alone leaves minor gaps in what to concretely execute.

Suggestions

Make the Check step executable in the body: state how to detect a missing accessible name (inspect the rendered accessibility tree or run axe, and flag controls whose only announcement is the role).

Inline one minimal good/bad markup example (e.g., an icon-only <button> with vs. without aria-label) so the rule is verifiable without opening the reference.

Cut the redundancy between Quick Reference and Fix, and drop the opening sentence explaining why unlabeled buttons are bad — Claude already knows this.

DimensionReasoningScore

Conciseness

The body is lean (~35 lines) with short, purposeful sections and no padding. Minor trimmable instances remain: the opening sentence explains a concept Claude already knows ("screen reader users will only hear the role (e.g., 'button') without knowing what it does"), and the Quick Reference bullet "Accessible names can be provided via text content, aria-label, or aria-labelledby" duplicates the Fix section almost verbatim. Not a 5 because of these two over-explanations.

4 / 5

Actionability

Concrete guidance exists — the Fix names specific mechanisms ("inner text, aria-label, or aria-labelledby") and Check/Fix/Explain/Code Review give a usable shape — but key executable details are deferred rather than included: the Check section says to find elements that "lack a clear accessible name" without saying how to inspect the rendered result (the accessibility tree, axe, or similar are only in references/rule.md), and no markup example appears in the body. This matches "some concrete guidance but incomplete; missing key details."

3 / 5

Workflow Clarity

The Check → Fix → Explain → Code Review sections form a clear, coherent sequence for a single-purpose review skill, and the Code Review section does mention verification ("note how to verify the fix with browser accessibility tooling or assistive tech"). It is not a 5 because validation checkpoints are only loosely implied — no explicit verify step (e.g., "confirm the accessible name appears in the accessibility tree before considering the fix done") closes the loop.

4 / 5

Progressive Disclosure

The body is a concise, well-sectioned overview that defers "full implementation details, code examples, and framework-specific guidance" to a single clearly signaled reference, references/rule.md, which actually exists and contains exactly that (code examples, why-it-matters, exceptions, standards, verification steps). The reference is one level deep with no further nesting, matching the anchor for a clear overview with well-signaled one-level-deep references.

5 / 5

Total

16

/

20

Passed

Description

63%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 is competent: it has an explicit "Use when" clause and a concrete multi-part review procedure. Its weaknesses are templated phrasing that buries the actual rule inside an awkward "related to..." clause, trigger vocabulary that misses the natural terms users say (button, icon button, a11y), and a generic trigger preamble that overlaps heavily with sibling accessibility skills.

Suggestions

Restate the core capability as a direct action instead of embedding the rule name mid-sentence, e.g., "Verify that command elements (buttons, links, menu items) have accessible names via text content, aria-label, or aria-labelledby."

Add natural trigger terms users actually say — "unlabeled button", "icon-only button", "empty button", "a11y", "screen reader" — to the "Use when" clause.

Differentiate the trigger clause from sibling accessibility skills by tying it to this rule's specific failure mode (e.g., "when a control announces only its role, such as 'button', with no name").

DimensionReasoningScore

Specificity

The description lists several concrete review actions — "Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output" — which are specific rather than vague. It falls short of a 5 because the core capability is only conveyed through the awkwardly embedded rule name ("related to Provide accessible names for ARIA command elements") rather than a cleanly stated skill-specific action, leaving minor gaps in coverage.

4 / 5

Completeness

Both parts are present: the "what" is the review procedure ("Check native semantics first, then inspect keyboard behavior, focus flow, accessible names, and screen-reader output") and the "when" is explicit ("Use when reviewing rendered HTML, interactive components, or design-system patterns..."). It is not a 5 because the "when" clause is circular — it restates the rule name instead of giving concrete user-side trigger phrases (e.g., mentions of unlabeled buttons, icon-only buttons, or screen-reader confusion).

4 / 5

Trigger Term Quality

Relevant keywords are present ("rendered HTML", "interactive components", "ARIA", "accessible names", "screen-reader"), but common natural variations users would actually say are missing — notably "button", "link", "icon button", "a11y", and "aria-label". A user complaining about an unlabeled button would not naturally phrase their need as "design-system patterns related to Provide accessible names for ARIA command elements".

3 / 5

Distinctiveness Conflict Risk

The named rule ("Provide accessible names for ARIA command elements") is a distinct niche, but the trigger preamble ("Use when reviewing rendered HTML, interactive components, or design-system patterns related to...") is a generic template that would be shared verbatim by sibling accessibility-rule skills, creating real overlap risk. It is somewhat specific but could still collide with closely related skills, matching the anchor for 3.

3 / 5

Total

14

/

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-command-name/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.