web-interface-guidelines

Review web interfaces against accessibility, interaction, layout, and performance standards.

41|4|Updated May 6, 2026
One-click install
npx skills add https://github.com/markerikson/opencode-config-example --skill web-interface-guidelines-markerikson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-interface-guidelines
Source: https://github.com/markerikson/opencode-config-example/tree/main/config/skill/web-interface-guidelines
Command: npx skills add https://github.com/markerikson/opencode-config-example --skill web-interface-guidelines-markerikson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents web UI quality gaps by giving a comprehensive, framework-agnostic checklist for interaction, layout, content, forms, performance, and design decisions.

Core Features & Use Cases

  • Accessibility-first interaction standards: Keyboard operability, focus management, correct ARIA usage when needed, and reliable announcements for async updates.
  • Consistent UI behavior across devices: Mobile input sizing, hydration-safe inputs, scroll/URL state persistence, and forgiving interaction design.
  • Quality across UI lifecycle: Animation best practices (reduced motion, compositor-friendly styles), layout/typography/content rules, and form UX/error-handling requirements.
  • Use case: When preparing a production-ready feature (e.g., a settings page with tabs, filters, forms, and loading states), use this checklist to review correctness, accessibility, and perceived polish before shipping.

Quick Start

Ask an AI to review your UI implementation against the Vercel Web Interface Guidelines and list the highest-impact changes to improve accessibility, interaction reliability, and polish.

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 web UI for accessibility and keyboard operability issues?

To check web UI accessibility, review keyboard operability, visible focus states, correct ARIA usage, and reliable announcements for async updates. A framework-agnostic checklist ensures forms, layouts, and interactions meet production standards before shipping.

What is the best way to handle form UX and error states in a web application?

The best way to handle form UX is enforcing correct submission behavior, hydration-safe inputs, and clear error-handling requirements. Reviewing complex forms against interaction design standards prevents input sizing issues and ensures consistent behavior across mobile devices.

How do I make web animations compliant with reduced-motion preferences?

To make web animations compliant, use compositor-friendly styles and respect reduced-motion user preferences. Animation best practices require checking that transitions do not trigger layout thrashing while remaining accessible to users who disable motion.

Do I need semantic-first markup to build a polished production web feature?

Yes, semantic-first markup is required to build polished production web features. It ensures correct document structure, enabling screen reader navigation, visible focus management, and reliable keyboard operability for complex interfaces like tabbed settings pages.

How do I ensure consistent UI behavior across mobile and desktop devices?

Ensure consistent UI behavior by applying mobile input sizing, hydration-safe inputs, and scroll or URL state persistence. Forgiving interaction design standards prevent layout shifts and maintain state during navigation across different viewport sizes.

Why does my web interface lose focus state during deep-linked navigation?

Web interfaces lose focus state during deep-linked navigation when keyboard support and focus management are not implemented. Applying interaction design standards ensures visible focus, scroll persistence, and correct ARIA usage for reliable keyboard operability.