Skip to main content
skill CX Codex

web-design-guidelines · tech-leads-club — Claude Code skill: review UI guidelines

web-design-guidelines reviews UI components against Web Interface Guidelines. Catches accessibility issues, missing form labels, and hydration pitfalls directly in your code.

MIT ★ 7,191 updated 2026-10-24

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a claude-code
Open on GitHub

What web-design-guidelines does

The skill evaluates component code against rules compiled in references/guideline.md. It inspects semantic HTML, ARIA attributes, keyboard navigation, and visible focus states. Checks also cover form autocompletion, hydration safety, dark mode theming, and reduced motion settings.

Feedback comes back grouped by file in a terse file:line format that works smoothly with VS Code. Claude outputs the exact location and the detected issue. Long explanations are skipped unless the underlying fix is complex.

This skill targets interface patterns exclusively. It will not benchmark Core Web Vitals or audit search engine metadata.

What it helps with

  • catch missing ARIA attributes and keyboard focus traps
  • flag hydration safety issues in UI components
  • verify input autocompletion and validation labels in forms
  • detect missing reduced-motion alternatives for animations

Example prompts for the agent

  • Review my UI in src/components/Navigation.tsx against design guidelines
  • Check accessibility and form labels in src/components/AuthModal.tsx
  • Audit design patterns across src/components/**/*.tsx

How to install web-design-guidelines

1Skills CLI (Vercel)

npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a claude-code

2Manually: put the files in place

~/.claude/skills/web-design-guidelines/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/web-design-guidelines/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about web-design-guidelines

How to install web-design-guidelines in Claude Code?

Run npx skills add tech-leads-club/agent-skills --skill web-design-guidelines -a claude-code. Alternatively, place the skill definition file at ~/.claude/skills/web-design-guidelines/SKILL.md.

What does the web-design-guidelines skill do?

It scans specified UI files against Web Interface Guidelines and reports issues covering accessibility, touch targets, dark mode, typography, and hydration safety.

Does web-design-guidelines perform SEO or performance audits?

No, it focuses strictly on visual styling and interaction design. The instructions explicitly point to dedicated tools like core-web-vitals and seo for performance and search audits.

Source text

SKILL.md · MIT
---
name: web-design-guidelines
description: Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices". Focuses on visual design and interaction patterns. Do NOT use for performance audits (use core-web-vitals), SEO (use seo), or comprehensive site audits (use web-quality-audit).
metadata:
  author: vercel
  version: '1.0.0'
  argument-hint: <file-or-pattern>
---

# Web Interface Guidelines

Review files for compliance with Web Interface Guidelines.

## How It Works

1. Read the guidelines from `#[[file:references/guideline.md]]`
2. Read the specified files (or prompt user for files/pattern)
3. Check against all rules in the guidelines
4. Output findings in the terse `file:line` format

## Guidelines Reference

All rules and output format instructions are in:

```
#[[file:references/guideline.md]]
```

The guidelines cover:

- Accessibility (ARIA, semantic HTML, keyboard navigation)
- Focus states and keyboard interaction
- Forms (autocomplete, validation, labels)
- Animation (reduced motion, performance)
- Typography (proper characters, number formatting)
- Content handling (overflow, empty states)
- Images (dimensions, lazy loading)
- Performance (virtualization, DOM reads)
- Navigation & state (URL sync, deep linking)
- Touch & interaction (tap delays, safe areas)
- Dark mode & theming
- Locale & i18n
- Hydration safety
- Common anti-patterns to flag

## Usage

When a user provides a file or pattern argument:

1. Read the guidelines from `references/guideline.md`
2. Read the specified files
3. Apply all rules from the guidelines
4. Output findings using the format specified in the guidelines

If no files specified, ask the user which files to review.

## Output Format

Follow the format in the guidelines:

- Group findings by file
- Use `file:line` format (VS Code clickable)
- Terse, high signal-to-noise
- State issue + location
- Skip explanation unless fix is non-obvious

© vercel · MIT · tech-leads-club/agent-skills

Similar skills

All skills for Frontend and UI →

web-design-guidelines by other authors comes first.

web-design-guidelines platform-design-skills web-design-guidelines is a Claude Code skill that enforces accessibility and responsive layout rules in tasks involving HTML, CSS, WCAG, web components, or performance. CX Codex +1 1,600installs web-design-guidelines agent-skills The web-design-guidelines skill checks web interfaces against accessibility and UX rules. Use it to audit UI code, forms, or keyboard navigation. CX Codex +1 970installs web-design-guidelines alexj11324 web-design-guidelines is a Claude Code skill that audits Mikka's web interface for accessibility, responsive layouts, forms, and interaction flows. CX Codex +1 ★ 88repo stars accessibility-inclusive-design hueyexe accessibility-inclusive-design — a skill that pushes your coding agent to design and critique interfaces for keyboard use, screen readers, contrast and semantics. CX Codex +1 666installs web-design pascalorg The web-design skill gives an agent a web design reference in four priority tiers. It is read before the agent works on UI. CX Codex +1 192installs premium_web_design jerrar670 premium_web_design is a Claude Code skill with rules for typography, color, motion and layout, for building landing pages or dashboards that don’t feel like templates. CX Codex +1 252installs ipollowork-design-web Devin-AXIS ipollowork-design-web edits web pages and app interfaces within an active iPolloWork Design session. Useful when updating layouts and design tokens safely. CX Codex +1 ★ 7,523repo stars tab-navigation dembrandt tab-navigation — a skill for designing tabs: when they fit, how the strip and panel are built, and how keyboard navigation should behave. CX Codex +1 842installs a11y-audit plugin87 a11y-audit — a skill for Claude Code that inspects user interfaces against WCAG 2.2 AA/AAA criteria and ARIA patterns. Runs when testing contrast, keyboard navigation, or screen-reader tags. CX Codex +1 641installs

From the same set130

The whole set →
security-best-practices Reviews code against security best practices for Python, JavaScript/TypeScript and Go, then suggests fixes. CX Codex +1 390installs figma-implement-design figma-implement-design converts Figma components and frames into production code with visual accuracy using the Figma MCP workflow. CX Codex +1 ★ 7,191repo stars gh-address-comments gh-address-comments finds the open pull request on your current branch, lists its review comments, and fixes the ones you pick. CX Codex +1 ★ 7,191repo stars cloudflare-deploy cloudflare-deploy is a Claude Code skill for deploying apps and infrastructure to Cloudflare via Workers and Pages. It activates when publishing, hosting, or configuring a Cloudflare project. CX Codex +1 ★ 7,191repo stars tlc-spec-driven tlc-spec-driven guides feature development through four adaptive phases with EARS specs, automated gates, and atomic commits. Useful when you need test-backed code execution. CX Codex +1 1,300installs subagent-creator subagent-creator walks you through writing a subagent: frontmatter, prompt, steps and a report format. Useful when a task needs its own context window. CX Codex +1 956installs technical-design-doc-creator technical-design-doc-creator generates Technical Design Documents, RFCs, and architecture specs through interactive discovery before coding. Useful for aligning migrations, schemas, and team reviews. CX Codex +1 655installs domain-analysis domain-analysis walks a codebase to find subdomains and suggest where service boundaries belong. Useful before splitting a monolith. CX Codex +1 381installs

Project sponsors

Companies that keep this analytics open