user-personalizationlisted
Install: claude install-skill mgifford/accessibility-skills
# User Personalization Accessibility Skill
> **Canonical source**: `examples/USER_PERSONALIZATION_ACCESSIBILITY_BEST_PRACTICES.md` in `mgifford/ACCESSIBILITY.md`
> This skill is derived from that file. When in doubt, the example is authoritative.
Apply these rules when implementing user preference controls or reviewing
existing personalization features.
**Only load this skill if the project has personalization features.**
---
## Core Mandate
Personalization is an enhancement to an accessible foundation — not a repair
layer and not a substitute for WCAG conformance. Start by respecting OS,
browser, and AT settings; add site-specific controls only when they provide a
meaningful choice users cannot reliably get from those existing tools. The
page must still satisfy browser zoom, text resizing, text-spacing overrides,
forced colors, and keyboard operation whether or not it offers a preference
editor.
**Preference precedence model:** (1) start with an accessible default; (2)
follow a recognized system/browser preference when the site setting is
"System"/"Default"; (3) let an explicit site choice override only the
corresponding presentation dimension; (4) let "Reset to defaults" remove site
overrides and resume following the system. Do not interpret a media-query
match as a diagnosis — people choose dark mode, reduced motion, or increased
contrast for many reasons.
---
## Severity Scale (this skill)
| Level | Meaning |
|---|---|
| **Critical** | Overlay used as compliance