content-designlisted

# Content Design Accessibility Skill > **Canonical source**: `examples/CONTENT_DESIGN_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 writing, editing, or reviewing any web content. --- ## Core Mandate A technically accessible page that is confusing or poorly structured still creates barriers. Design content for the widest possible audience: write clearly, structure logically, and present information in the order users need it. --- ## Severity Scale (this skill) | Level | Meaning | | --- | --- | | **Critical** | Content is completely inaccessible or incomprehensible to a disability group | | **Serious** | Significant barrier; unreasonable to expect workaround | | **Moderate** | Creates friction; workaround exists and is not too burdensome | | **Minor** | Best-practice gap; marginal impact | --- ## Critical: Images Must Have Appropriate Text Alternatives A meaningful image with no `alt` attribute or `alt=""` is **Critical** — blind users receive no information. A decorative image with descriptive `alt` is **Moderate** — it adds noise but does not block information. * Meaningful images: `alt` text that conveys purpose, not appearance * Decorative images: `alt=""` (empty string — the attribute must still be present) --- ## Serious: All Link Text Must Make Sense Out of Context "Click here", "Read more", and "Learn more" are **Serious** — scree