Associate labels with form controls
SkillMediaform-labels is a skill for AI agents that reviews rendered HTML, interactive components, and design-system patterns for form control labeling. It checks that inputs, selects, and textareas have labels connected via for/id attributes rather than placeholders alone, and flags accessibility gaps so every field works with screen readers.
Available today. Use it from your connected AI after setup.
No other account needed.
Have an AI agent that can load skills.
Then ask your AI: use the Associate labels with form controls skill
What your AI can do with it
- Checks that inputs, selects, and textareas have labels via for/id attributes
- Flags fields that rely on placeholders alone instead of proper labels
- Detects missing labels on form controls
- Identifies checkbox or radio groups lacking a fieldset and legend
- Explains fixes such as adding matching label elements
- Reviews native semantics, keyboard behavior, focus flow, and accessible names
Getting started
- Have an AI agent that can load skills.
- Add the form-labels skill to the agent's available skills.
- Ask the agent to review your rendered HTML, interactive components, or design-system patterns for form labeling.
- Apply the fixes the agent suggests, such as adding matching label elements.
What this skill tells your AI
The instructions your AI receives, as published by thedaviddias/front-end-checklist in skills/form-labels/SKILL.md and read by ahel’s review.
Properly associated labels ensure that screen readers can identify the purpose of form inputs and increase the clickable area for users with motor impairments.
Quick Reference
- Use
<label>elements for all form inputs - Connect labels using
forandidattributes - Placeholder text is not a label and must not be the only field name
- Use
<fieldset>and<legend>when multiple controls share one question - Ensure every input has a clear, accessible name
Check
Verify that all form controls (input, select, textarea) have programmatically associated labels using the 'for' and 'id' attributes. Flag placeholder-only labels and grouped controls that lack a fieldset legend.
Fix
Add a element with a 'for' attribute that matches the 'id' of the corresponding input field. Replace placeholder-only labels with real label text and wrap related checkboxes or radio buttons in a <fieldset> with a <legend>.
Explain
Explain why associated labels are critical for screen reader users and how they improve the hit area for touch and mouse users.
Code Review
Review the rendered markup and interactive states that affect Associate labels with form controls. Flag exact elements, roles, labels, focus behavior, or keyboard interactions that violate the rule, and note how to verify the fix with browser accessibility tooling or assistive tech. Specifically check for placeholder-only labels and question groups that visually share a heading but lack a semantic <fieldset> and <legend>.
For full implementation details, code examples, and framework-specific guidance,
see references/rule.md.
Rule page: https://frontendchecklist.io/en/rules/accessibility/form-labels
Signals
- GitHub stars
- 74k
- Forks
- 7k
- Last commit
- Aug 2026
Questions
- What does form-labels check for?
- It checks that form controls like inputs, selects, and textareas have labels connected via for/id attributes instead of relying on placeholders alone. It also flags missing labels and checkbox or radio groups lacking a fieldset and legend.
- When should I use it?
- Use it when reviewing rendered HTML, interactive components, or design-system patterns related to associating labels with form controls.
- Does it fix the problems for me?
- It flags issues and explains fixes, such as adding matching label elements. Applying the changes is up to you or your agent.
Advanced
- Item type
- skill
- Key
form-labels- Source
- github.com/thedaviddias/front-end-checklist