agentleFS
WilliamEbongWilliamEbong/CourseForge/.claude/skills/accessibility-review/SKILL.md

accessibility-review

Skill0 starsChanged 57 days agoMITView on GitHub

WCAG 2.2 AA review essentials for e-learning (keyboard-operable interactions including matching and sequencing, focus management, announcements, text equivalents, no colour-only meaning, reduced motion, reflow). Use when planning or reviewing accessibility of course content, visuals or built HTML.

17 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use frontend-design.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • BlockSkill

    frontend-design

    Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

    Also in 4 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 4 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 15 edited versions we read keep these.

  • 4

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Every control reachable with Tab and Shift+Tab in reading order.

    line 12
  2. Distinctive:

    No keyboard traps, except a modal dialog that deliberately contains focus while open and releases it on close (Escape closes).

    line 13
  3. Distinctive:

    After submitting an answer, focus stays near the question and the feedback is announced.

    line 28
  4. Very specific:

    Never put aria-live on the screen container.

    line 33
  5. Distinctive:

    No time limits on reading or answering.

    line 64

“Common” is measured: kept by at least 6 in 10 of the 15 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Accessibility review for e-learning

Target: WCAG 2.2 level AA, applied to a single-page course with interactions and assessments.

Keyboard

  • Every control reachable with Tab and Shift+Tab in reading order; activated with Enter or Space; composite widgets (radio groups, listboxes) use arrow keys as conventional.
  • No keyboard traps, except a modal dialog that deliberately contains focus while open and releases it on close (Escape closes).
  • Interaction modes:
    • single choice: native radio group;
    • multiple response: native checkboxes;
    • matching: a select (or listbox) per prompt, choosing its match;
    • categorisation: a select per item, or category buttons per item;
    • sequencing: move-up and move-down buttons per step (or a select for position), with the new position announced;
    • reveal: a real button with aria-expanded.
  • Drag and drop may exist only as an enhancement over one of the above.

Focus

  • Visible focus indicator on every interactive element, with sufficient contrast, not hidden under sticky headers or clipped (WCAG 2.2 focus not obscured).
  • On screen change, move focus to the new screen's heading (h1 with tabindex="-1").
  • Opening a dialog moves focus into it; closing restores focus to the control that opened it.
  • After submitting an answer, focus stays near the question and the feedback is announced.

Announcements

  • One persistent polite status region for feedback and screen-change messages; announce the message, not the whole screen.
  • Never put aria-live on the screen container.
  • Errors and validation messages are associated with their controls.

Semantics and structure

  • One h1 per screen; heading levels in order; landmarks for header, navigation and main.
  • Native elements first (button, a, input, select, dialog, table); ARIA only to fill gaps, never to override correct native semantics.
  • Form controls have visible labels; groups have legends (the question stem as a fieldset legend).
  • Tables have header cells; lists are lists; link text makes sense out of context.
  • lang set on the document and on passages in another language.

Non-text content

  • Figures: role="img" with an accessible name and a linked long description conveying the full meaning; decorative images hidden from assistive technology.
  • Text equivalents describe content, never authoring instructions or appearance.
  • Essential information is never only in an image, only in colour, only on hover, or only in position ("the box on the right").

Colour, contrast and motion

  • Text contrast at least 4.5:1 (3:1 for large text); UI component and focus indicator contrast at least 3:1. (CourseForge computes token contrast; reviewers check real screens.)
  • Correct, incorrect and selected states use text and icon as well as colour.
  • Respect prefers-reduced-motion; no information carried by animation; nothing flashes more than three times a second.

Reflow, zoom and targets

  • Content reflows at 320 CSS pixels wide without horizontal page scrolling (tables and figures may scroll within their own container with a visible cue).
  • Text resizes to 200% without loss.
  • Target size at least 24 by 24 CSS pixels (44 recommended for touch).

Time and cognition

  • No time limits on reading or answering.
  • Clear instructions before interactions; consistent navigation; ability to review and change answers before submitting a graded assessment.
  • Plain language, defined terms and expanded acronyms support cognitive accessibility.

Reporting

Report each root cause once, listing affected screens or blocks. Map severity: cannot complete by keyboard → blocker; an interaction mode or dialog inoperable, axe serious or critical, missing text equivalent for an essential figure → critical; focus management, whole-screen live regions, colour-only states → major; minor semantic issues → minor.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.