web-design-guidelines

Reviews UI code files against Web Interface Guidelines and reports findings in file:line format.

Updated Sep 15, 2026
One-click install
npx skills add https://github.com/Peterson-Benhame/agent-skills --skill web-design-guidelines-peterson-benhame
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-design-guidelines
Source: https://github.com/Peterson-Benhame/agent-skills/tree/main/packages/skills-catalog/skills/%28design%29/web-design-guidelines
Command: npx skills add https://github.com/Peterson-Benhame/agent-skills --skill web-design-guidelines-peterson-benhame

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Manually auditing UI code for accessibility, focus states, forms, animation, typography, and performance best practices is slow and error-prone. This Skill automates the review by checking your files against a comprehensive rule set and returning terse, actionable findings. ## Core Features & Use Cases - Guideline Compliance Review: Checks UI code against rules covering accessibility, focus states, forms, animation, typography, images, performance, navigation, dark mode, i18n, and hydration safety. - Anti-Pattern Detection: Flags common mistakes such as transition: all, outline-none without focus replacement, icon buttons missing aria-label, and images without dimensions. - Actionable Output Format: Reports findings grouped by file in VS Code-clickable file:line format with high signal-to-noise. - Use Case: Before shipping a new React settings page, ask the agent to review the component files and receive a concise list of accessibility and UX violations to fix. ## Quick Start Ask the agent to review your UI files against the web interface guidelines, for example: review src/components/Settings.tsx for accessibility and UX issues.

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 for accessibility issues?

Provide the file or pattern you want reviewed, and the Skill checks it against accessibility rules including ARIA labels, semantic HTML, keyboard handlers, and focus states. Findings are reported in file:line format grouped by file.

What does a web interface guidelines audit check?

The audit covers accessibility, focus states, forms, animation, typography, content handling, images, performance, navigation state, touch interaction, dark mode, i18n, and hydration safety. It also flags anti-patterns like transition: all and icon buttons without aria-label.

Can I use this for performance or SEO audits?

No, this Skill focuses on visual design and interaction patterns only. For performance audits use a core-web-vitals skill, for SEO use a dedicated SEO skill, and for comprehensive audits use a web-quality-audit skill.

What output format does the UI review produce?

Findings are grouped by file using a terse file:line format that is clickable in VS Code. Each line states the issue and location, skipping explanations unless the fix is non-obvious, and files with no issues show a pass marker.

Which anti-patterns does the UI review flag?

It flags user-scalable=no, onPaste with preventDefault, transition: all, outline-none without focus replacement, div elements with click handlers, images without dimensions, unvirtualized large lists, and hardcoded date or number formats.