manual-testing

Solid

Load this skill whenever you are planning, executing, or reviewing manual accessibility testing. Manual testing with real assistive technologies is essential — automated tools catch only ~30–40 % of WCAG issues. Absolutely always include keyboard-only testing and at least one screen reader test before marking a feature accessible. Under no circumstances skip forced colors mode testing for UI components.

Testing & QA 44 stars 2 forks Updated 2 days ago AGPL-3.0

Install

View on GitHub

Quality Score: 81/100

Stars 20%
55
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Manual Accessibility Testing Skill > **Canonical source**: `examples/MANUAL_ACCESSIBILITY_TESTING_GUIDE.md` in `mgifford/ACCESSIBILITY.md` > This skill is derived from that file. When in doubt, the example is authoritative. Apply these rules when planning or reviewing manual accessibility testing. --- ## Severity Scale (this skill) | Level | Meaning | |---|---| | **Critical** | Issue completely blocks a core task for one or more disability groups | | **Serious** | Significantly impairs access; workaround unreasonable to expect | | **Moderate** | Creates friction; workaround exists and is not too burdensome | | **Minor** | Best-practice gap; marginal impact on access | --- ## Core Principle **Manual testing reveals issues that automated tools cannot detect**, including: * Screen reader announcement quality and user experience * Keyboard navigation flow and logical sequence * Focus management in dynamic interfaces * Context and orientation for assistive technology users * Forced colors mode (Windows High Contrast) — automated tools cannot simulate OS-level color overrides * Real-world usability barriers --- ## Critical: When Manual Testing Is Required Perform manual testing: * **Before each release** — test critical user flows end to end * **After UI changes** — test all affected components * **For new features** — test complete user workflows * **When automated tests pass** — validate actual user experience * **When accessibility bugs are reported** — reproduce ...

Details

Author
mgifford
Repository
mgifford/accessibility-skills
Created
5 months ago
Last Updated
2 days ago
Language
JavaScript
License
AGPL-3.0

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

behavioral-a11y

Load this skill when writing, reviewing, or interpreting behavioral accessibility automation — tests that manipulate a rendered page (resizing the viewport, pressing real keys, capturing and comparing screenshots) rather than only inspecting static markup or a single computed accessibility tree. Covers Reflow risk (SC 1.4.10) and Focus Visible risk (SC 2.4.7) checks. Absolutely always report indicator results separately from confirmed failures. Under no circumstances treat a clean behavioral scan as WCAG conformance, or collapse `cantTell`/test-error/indicator outcomes into a single pass/fail signal.

44 Updated 2 days ago
mgifford
DevOps & Infrastructure Solid

ci-cd

Load this skill when configuring or reviewing CI/CD pipelines, GitHub Actions workflows, or automated testing setups. Ensures accessibility regressions are caught before code reaches production by enforcing quality gates, structured reporting, and layered automated + manual testing across all pages and user preferences.

44 Updated 2 days ago
mgifford
Web & Frontend Listed

accessibility

This skill should be used when building or reviewing UI for accessibility — keyboard navigation, screen readers, ARIA, color contrast, focus states, accessible forms, or WCAG compliance. Trigger phrases include "make it accessible", "a11y", "accessibility", "WCAG", "ARIA", "keyboard navigation", "screen reader", "color contrast", "focus states", "accessible form", "is this compliant", "EAA", "ADA". It targets WCAG 2.2 AA with concrete component rules and an axe-core test step.

2 Updated 3 weeks ago
MartinOlivero