web-design-guidelines

Reviews UI code files against Vercel's Web Interface Guidelines and reports findings.

Updated Jul 17, 2026
One-click install
npx skills add https://github.com/usmangurowa/socialmocks --skill web-design-guidelines-usmangurowa
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-design-guidelines
Source: https://github.com/usmangurowa/socialmocks/tree/main/.agents/skills/web-design-guidelines
Command: npx skills add https://github.com/usmangurowa/socialmocks --skill web-design-guidelines-usmangurowa

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually auditing UI code for accessibility, UX, and design best practices is time-consuming and inconsistent. This Skill automates the review by fetching the latest Web Interface Guidelines and checking your files against every rule. ## Core Features & Use Cases - Guideline-Based Review: Fetches the latest rules from the vercel-labs web-interface-guidelines repository before each audit, so checks always reflect current best practices. - Flexible File Targeting: Accepts a specific file or glob pattern as an argument, or prompts you to specify which files to review. - Terse Findings Output: Reports violations in a compact file:line format for quick triage and fixing. - Use Case: Before merging a pull request that touches React components, run the review on your changed files to catch accessibility and UX issues early. ## Quick Start Ask the assistant to review my UI components in the apps/web directory against the web interface guidelines.

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 a file path or glob pattern for your UI components, and the Skill fetches the latest Web Interface Guidelines and checks your code against every rule. Findings are reported in a compact file:line format so you can jump directly to each issue.

What design guidelines does this UI review use?

It uses the Web Interface Guidelines maintained in the vercel-labs/web-interface-guidelines repository. The rules are fetched fresh from the source URL before each review, so audits always reflect the current version rather than a stale snapshot.

Can I review multiple files or a whole directory at once?

Yes, you can pass a file pattern as the argument to review multiple matching files in one run. If you provide no argument, the Skill asks which files you want reviewed.

What output format does the UI audit produce?

Findings are output in a terse file:line format as specified by the fetched guidelines. This makes it easy to scan violations quickly and navigate directly to the offending lines in your editor.

Does the UI review work offline or without network access?

No, the Skill requires network access because it fetches the latest guidelines from a remote URL before each review. Without connectivity, the rules cannot be retrieved and the audit cannot proceed.