ehmo avatar

Web Design Guidelines

A comprehensive reference for building accessible web interfaces that actually covers the important stuff: semantic HTML patterns, ARIA usage, keyboard navigation, focus management, and WCAG 2.2 contrast requirements. The tables are genuinely useful, especially the semantic element guide and the contrast ratio chart. It includes code examples for common patterns like focus traps and skip links, and calls out anti-patterns like div soup and placeholder-only labels. Invoke this when you're building or auditing anything that renders in a browser and need to avoid the accessibility mistakes that ship in 90% of web apps. The guidelines are framework-agnostic, so they apply whether you're writing vanilla HTML or working in React, Vue, or whatever.

skills.sh installs
1.6K
GitHub stars
639
last updated
Aug 21, 2026

Install

$ npx -y skills add ehmo/platform-design-skills --skill web-design-guidelines --agent claude-code

Installs into .claude/skills of the current project.

Files

Web Platform Design Guidelines

Framework-agnostic rules for accessible, performant, responsive web interfaces. Based on WCAG 2.2, MDN Web Docs, and modern web platform APIs.


1. Accessibility / WCAG [CRITICAL]

Accessibility is not optional. Most rules in this section map to WCAG 2.2 success criteria at Level A or AA. A small number of best-practice rules (noted inline) target Level AAA or go beyond WCAG.

1.1 Use Semantic HTML Elements

Use elements for their intended purpose. Semantic structure provides free accessibility, SEO, and reader-mode support.

Sponsors

Details

Repository
github.com/ehmo/platform-design-skills
Categories
Frontend Development, Debugging, Design & UI/UX
First seen
May 16, 2026

More from ehmo/platform-design-skills

All 8
1capawesome-team avatarcapacitor-app-developmentcapawesome-team/skillsGuides the agent through general Capacitor app development topics. Covers core concepts (native bridge, plugins, web layer), Capacitor CLI usage, app configurat1.6Kskills.sh installs
2secondsky avataraceternity-uisecondsky/claude-skills100+ animated React components (Aceternity UI) for Next.js with Tailwind. Use for hero sections, parallax, 3D effects, or encountering animation, shadcn CLI int1.6Kskills.sh installs
3software-mansion-labs avatarradon-mcpsoftware-mansion-labs/skillsBest practices for using Radon IDE's MCP tools when developing, debugging, and inspecting React Native and Expo apps. Use when interacting with a running app th1.5Kskills.sh installs
4jezweb avatarlanding-pagejezweb/claude-skillsGenerate a complete, deployable landing page from a brief. Produces a single self-contained HTML file with Tailwind CSS (via CDN), responsive design, dark mode,1.5Kskills.sh installs
5jezweb avatardesign-reviewjezweb/claude-skillsReview a web app or page for visual design quality — layout, typography, spacing, colour, hierarchy, consistency, interaction patterns, and responsive behaviour1.5Kskills.sh installs
6antdv-next avatarantdv-nextantdv-next/skillsAntdv Next Vue 3 component library. Use when locating component API docs, props/events/slots, playground demos, or theme token definitions.1.5Kskills.sh installs