web-interface-guidelines

Reviews UI code for compliance with Vercel Web Interface Guidelines.

Updated May 5, 2026
One-click install
npx skills add https://github.com/josippapez/ai-setup --skill web-interface-guidelines-josippapez
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-interface-guidelines
Source: https://github.com/josippapez/ai-setup/tree/main/claude/plugins/better-design/skills/web-interface-guidelines
Command: npx skills add https://github.com/josippapez/ai-setup --skill web-interface-guidelines-josippapez

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? UI code often ships with accessibility gaps, missing focus states, hydration bugs, and performance anti-patterns that are tedious to catch manually. This Skill audits your frontend code against the Vercel Web Interface Guidelines and reports concrete violations with file and line references. ## Core Features & Use Cases - Comprehensive Rule Coverage: Checks accessibility, focus states, forms, animation, typography, images, performance, navigation, touch interaction, dark mode, i18n, and hydration safety. - Anti-Pattern Detection: Flags common mistakes like transition: all, outline-none without focus replacement, icon buttons without aria-label, and unvirtualized large lists. - Actionable Output: Reports findings grouped by file in file:line format so you can jump directly to each issue in your editor. - Use Case: Before merging a pull request that adds a new settings page, run this review to catch missing labels on form inputs, hardcoded date formats, and images without explicit dimensions. ## Quick Start Review the UI code in my current branch for compliance with the web interface guidelines and list all violations by file and line.

Frequently Asked Questions about web-interface-guidelines

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

FAQPage Schema
How do I check my React code for accessibility issues?

Run this review over your component files to detect missing aria-labels on icon buttons, form inputs without labels, non-semantic click handlers on divs, and missing keyboard handlers. Findings are reported per file with exact line numbers.

What UI anti-patterns does this review detect?

It flags transition: all, outline-none without a focus-visible replacement, images without width and height, large lists rendered without virtualization, paste-blocking handlers, disabled zoom via user-scalable=no, and gesture-only interactions without keyboard alternatives.

Does it check animation and reduced motion support?

Yes. It verifies that animations honor prefers-reduced-motion, animate only transform and opacity, set correct transform-origin, and remain interruptible. Autoplaying motion longer than five seconds must provide pause, stop, or hide controls.

Can it catch hydration mismatches in server-rendered apps?

Yes. It checks that inputs with value have onChange handlers, that date and time rendering is guarded against server-client mismatch, and that suppressHydrationWarning is used only where truly necessary.

What output format does the review produce?

Findings are grouped by file using file:line references that are clickable in VS Code. Each line states the issue tersely without lengthy explanation, and files with no violations are marked as passing.