MCPInstall

form-labelling

Design form labels, instructions, and grouping that work for screen readers and cognitive accessibility. Use when designing or reviewing forms, input fields, checkboxes, radio buttons, select menus, or any data entry interface. Triggers on: form label, label, input label, fieldset, legend, placeholder, form instructions, form group, radio group, checkbox group, required field, form accessibility.

Installs
76
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/owl-listener/inclusive-design-skills --skill form-labelling
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads form-labelling automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

Form Labelling

Every form field needs a visible, persistent label that is programmatically associated with the input. This is the single most common accessibility failure on the web — and the easiest to fix.

Core Rules

Every Input Has a Visible Label

  • Use <label> element with for/id association
  • The label must be visible at all times — not just as placeholder text that disappears on focus
  • Labels go above the input (most accessible and most scannable)
  • Never use placeholder text as the only label — it disappears when the user starts typing

Labels Describe What to Enter

  • Good: "Email address"
  • Bad: "Enter your info here"
  • Good: "Date of birth (DD/MM/YYYY)"
  • Bad: "Date"
  • Include format hints in the label or help text, not just in placeholder

Required Fields Are Clear

  • Mark required fields with visible text: "required" or *
  • If using , explain it at the top of the form: " = required"
  • Use aria-required="true" for programmatic indication
  • Better: make most fields required by design and mark the optional ones instead — "Company name (optional)"

Grouping Patterns

Related Fields Need Fieldsets

  • Group related fields with <fieldset> and <legend>
  • Radio buttons: always group with fieldset
    • Legend: "Preferred contact method"
    • Options: Email, Phone, Text
  • Checkboxes: group when they share a question
    • Legend: "Which topics interest you?"
    • Options: Design, Engineering, Product
  • Address fields: group under "Delivery address" or "Billing address"

When You Have Multiple Forms

  • Each form section should have a heading or legend
  • Sections should be visually and structurally separated
  • Progress indicators help users understand where they are

Instruction Patterns

Help Text

  • Place help text between the label and the input
  • Associate with aria-describedby so screen readers announce it
  • Good: "Must be at least 8 characters with one number"
  • Keep instructions concise — one sentence

Error Association

  • Error messages must be programmatically linked to the field (aria-describedby or aria-errormessage)
  • Place error text directly below the field, not in a remote banner
  • Include the field label in the error: "Email address: please enter a valid email"

Common Mistakes

  • Placeholder as label — disappears on input, invisible to many screen readers
  • Icon-only labels — a magnifying glass without text "Search" label
  • Labels far from inputs — spatial separation breaks the visual association
  • Labels that change — don't change label text based on input state
  • Unlabelled buttons — every button needs visible text or aria-label

Assessment Checklist

  • Every input has a visible <label> associated with for/id
  • No placeholder-only labels
  • Required fields are indicated visually and programmatically
  • Related fields are grouped with fieldset/legend
  • Help text is associated with aria-describedby
  • Error messages are linked to their field
  • All buttons have visible text labels

FAQ

What does the form-labelling skill do?

Design form labels, instructions, and grouping that work for screen readers and cognitive accessibility. Use when designing or reviewing forms, input fields, checkboxes, radio buttons, select menus, or any data entry interface. Triggers on: form label, label, input label, fieldset, legend, placeholder, form instructions, form group, radio group, checkbox group, required field, form accessibility.

How do I install form-labelling?

Run npx skills add https://github.com/owl-listener/inclusive-design-skills --skill form-labelling in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/form-labelling/ (personal) or .claude/skills/form-labelling/ (project).

Which AI agents can use form-labelling?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is form-labelling safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains form-labelling?

It is published by owl-listener in owl-listener/inclusive-design-skills. It has 76 recorded installs.

More from owl-listener/inclusive-design-skills

View all →

plain-language-design

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

97 installs

keyboard-navigation

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

97 installs

cognitive-load-assessment

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

88 installs

responsive-review

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

user-preference-respect

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

82 installs

error-prevention-recovery

owl-listener/inclusive-design-skills

Open the skill to read its SKILL.md instructions.

81 installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs