CtrlK
BlogDocsLog inGet started
Tessl Logo

aria-input-field-name

Use when applies to all `<input>` (except type=hidden), `<textarea>`, `<select>`, and custom form widgets using role=textbox, role=combobox, role=spinbutton, role=searchbox, or role=listbox.

52

Quality

58%

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

Quality

Content

85%

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 overview with a concrete Check/Fix workflow, an explicit per-input validation checklist, and a well-signaled one-level reference to rule.md (verified present with full code examples). Its only notable weakness is mild redundancy between the intro and Explain sections, which re-cover screen-reader and accessible-name concepts Claude already knows.

Suggestions

Collapse the overlap between the intro and the Explain section — keep the accessible-name computation order and WCAG citations once, and trim the second restatement of screen-reader/Dragon behavior.

Optionally surface one small inline correct/incorrect snippet in the Fix section so the remediation is copy-paste ready without opening rule.md.

DimensionReasoningScore

Conciseness

The body is well-organized and avoids the verbose wall-of-basics seen in the score-1 anchor, but the intro and the Explain section overlap — both re-explain screen-reader behavior ("VoiceOver reads 'text field' and NVDA reads 'edit'") and the accessible-name/Dragon use case that Claude already knows, so it could be tightened rather than earning the 'every token earns its place' score of 3.

2 / 3

Actionability

The Check and Fix sections give concrete, specific remediation with real HTML attribute values ("<label for='input-id'>Label text</label> and matching id", "aria-label='Search'", "aria-labelledby='label-element-id'"). This is an instruction/review skill, so per the scoring notes the absence of full fenced code blocks in the body is not penalized when the guidance is this actionable, and complete executable examples are appropriately provided in references/rule.md.

3 / 3

Workflow Clarity

The workflow is clearly sequenced as Check (find inputs, then validate each against three explicit numbered conditions and flag placeholder-only labels) → Fix (three ordered remediation options plus removing placeholder) → Code Review (verify with browser accessibility tooling). The Check section's three conditions serve as an explicit validation checkpoint, which fits the score-3 anchor for a review skill.

3 / 3

Progressive Disclosure

The body is a concise overview split into clear sections (Quick Reference, Check, Fix, Explain, Code Review) with a clearly signaled one-level-deep pointer — "For full implementation details, code examples, and framework-specific guidance, see references/rule.md" — and that reference file exists and holds the complete code examples, standards, and verification steps, matching the score-3 anchor.

3 / 3

Total

11

/

12

Passed

Description

32%

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 offers a clear, explicit 'Use when' trigger with a precise enumeration of input elements and ARIA roles, but it never states what the skill does, leaving the 'what' unanswered and leaning on technical rather than natural keywords. Its strongest point is a distinctive, accessibility-flavored scope; its weakest is missing capability and completeness.

Suggestions

Lead with an explicit capability clause before the trigger, e.g., 'Ensures all form inputs have accessible names. Use when reviewing or fixing <input>, <textarea>, <select>, and custom widgets with role=textbox/combobox/spinbutton/searchbox/listbox.'

Add natural user-facing terms ('accessible names', 'labels', 'ARIA', 'screen readers', 'form fields') alongside the element/role list so the trigger matches how users actually ask.

Repair the grammatical break 'Use when applies to all...' by stating the action first, then the 'Use when...' clause, so both 'what' and 'when' are explicit.

DimensionReasoningScore

Specificity

The description concretely enumerates its domain ("<input> (except type=hidden), <textarea>, <select>, and custom form widgets using role=textbox, role=combobox, role=spinbutton, role=searchbox, or role=listbox"), but names no action verb describing what the skill actually does. It is not vague/abstract (ruling out 1), yet it stops short of listing multiple concrete capabilities, so 3 does not fit.

2 / 3

Completeness

It provides an explicit "Use when..." trigger (the "when"), but never states what the skill does — there is no capability/action verb, only an "applies to" scope statement. Per the guidelines I score only what is explicit, so the missing "what" matches the score-1 anchor rather than the score-2 anchor which requires a stated "what".

1 / 3

Trigger Term Quality

It includes relevant developer terms ("<input>", "<textarea>", "<select>") and an explicit "Use when" trigger, but leans on technical jargon ("role=spinbutton", "role=searchbox", "role=listbox") and omits natural phrasings a user would say such as "accessible names", "labels", "ARIA", or "screen readers".

2 / 3

Distinctiveness Conflict Risk

The enumerated ARIA roles and input types signal a specific accessibility niche, but because the purpose (accessible naming) is unstated, the trigger "use when working with input/textarea/select" could plausibly fire for unrelated form-input tasks, so it is somewhat specific but still risks overlap.

2 / 3

Total

7

/

12

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.

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