web-design-guidelines

Audits UI code against Vercel Web Interface Guidelines with file:line findings.

15|3|Updated Jul 9, 2026
One-click install
npx skills add https://github.com/thefear078/cursor-kit-for-ai --skill web-design-guidelines-thefear078
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: web-design-guidelines
Source: https://github.com/thefear078/cursor-kit-for-ai/tree/main/plugins/frontend/skills/web-design-guidelines
Command: npx skills add https://github.com/thefear078/cursor-kit-for-ai --skill web-design-guidelines-thefear078

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Reviewing UI code for accessibility, forms, animation, typography, and performance issues is slow and inconsistent when done manually. This Skill audits components, pages, or PR diffs against the Vercel Web Interface Guidelines and returns terse, VS Code-clickable file:line findings with severity levels. ## Core Features & Use Cases - Rule-based UI audit: Checks 15 rule categories including accessibility, focus states, forms, animation, typography, images, performance, navigation, touch interaction, dark mode, i18n, and hydration safety. - Severity model: Classifies findings as Critical, Major, Minor, or Pass so teams know what blocks merge versus what can wait. - Fresh rules every run: Fetches the canonical rule set from the vercel-labs/web-interface-guidelines repository before each review instead of relying on cached text. - Use Case: Before merging a PR that touches React components, run the audit on the changed files to catch missing aria-labels, transition: all usage, and images without dimensions, then fix Critical items before merge. ## Quick Start Audit the UI files changed in my current PR against the Vercel Web Interface Guidelines and list findings by file and line.

Frequently Asked Questions about web-design-guidelines

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

FAQPage Schema
How do I audit React components for accessibility issues?▼

Run the audit on your component files or PR diff to check rules like aria-label on icon buttons, labels on form controls, keyboard handlers, and semantic HTML. Findings are reported in file:line format with a severity level so you can fix Critical items first.

What are the Vercel Web Interface Guidelines?▼

They are a public rule set from vercel-labs covering accessibility, focus states, forms, animation, typography, performance, and interaction patterns for web UIs. This Skill fetches the latest version from the GitHub repository before every review.

Can I audit only the files changed in a PR?▼

Yes. If no scope is specified, the audit runs git diff --name-only and checks only the changed UI files. You can also scope it to specific files, a directory, or the whole src tree.

Does this replace a full WCAG accessibility audit?▼

No. It catches code-level accessibility violations like missing labels and focus states, but deep WCAG testing with keyboard navigation and screen readers is deferred to a dedicated accessibility audit skill.

What happens if the guidelines fetch fails?▼

The fetch is retried once. If still unavailable, the audit proceeds using the embedded rule summary and warns that results may be stale.