web-design-guidelines

Reviews UI code against Vercel Web Interface Guidelines and reports violations in file:line format.

3|3|Updated Apr 23, 2026
One-click install
npx skills add https://github.com/joaoguirunas/team-os --skill web-design-guidelines-joaoguirunas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-design-guidelines
Source: https://github.com/joaoguirunas/team-os/tree/main/.claude/skills/web-design-guidelines
Command: npx skills add https://github.com/joaoguirunas/team-os --skill web-design-guidelines-joaoguirunas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually auditing UI code for accessibility, performance, typography, and interaction best practices is slow and error-prone. This Skill automates the review of frontend files against the Vercel Web Interface Guidelines, producing concise, actionable findings. ## Core Features & Use Cases - Guideline-Based Code Review: Checks files against rules covering accessibility, focus states, forms, animation, typography, images, performance, dark mode, i18n, and hydration safety. - Remote-First with Local Fallback: Fetches the latest guidelines from the vercel-labs GitHub repository, falling back to a local cache (guidelines-cache.md) when the network is unavailable. - Terse file:line Output: Reports violations grouped by file in VS Code-clickable format, flagging anti-patterns like transition: all, missing aria-label, and unvirtualized large lists. - Use Case: Before shipping a React feature, run the review on your changed components to catch missing focus-visible styles, unlabeled icon buttons, and images without dimensions. ## Quick Start Ask the assistant to review src/components/Button.tsx against the web interface guidelines and list all violations.

Frequently Asked Questions about web-design-guidelines

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review my UI code against the Vercel Web Interface Guidelines?▼

Provide a file path or glob pattern as the argument, and the skill loads the guidelines then checks each file against all rules. Findings are reported in terse file:line format grouped by file, ready to click open in VS Code.

What rules does the Vercel web interface guidelines review check?▼

It checks accessibility (aria-labels, semantic HTML), focus states, forms, animation (prefers-reduced-motion, transition: all), typography, images (dimensions, lazy loading), performance (list virtualization), dark mode, i18n (Intl APIs), and hydration safety.

Does the guidelines review work offline or without GitHub access?▼

Yes. The skill first tries to fetch guidelines from the vercel-labs GitHub repository, then falls back to a local cache file (guidelines-cache.md). If both fail, it continues using the assistant's internal knowledge of the guidelines.

Should I use this skill or an accessibility skill for WCAG audits?▼

Use this skill for general UI quality review against Vercel's guidelines, which include some accessibility rules. For dedicated accessibility and WCAG compliance audits, the documentation directs you to the separate accessibility skill instead.

What output format does the UI guidelines review produce?▼

Output is grouped by file using file:line references, with one terse finding per line stating the issue and location. Files with no violations are marked with a pass check, and explanations are omitted unless a fix is non-obvious.