web-design-guidelines

Review UI code files against fetched Web Interface Guidelines and report findings.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually auditing UI code for accessibility, design, and UX best practices is slow 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. - File or Pattern 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 shipping a new landing page, run the review on your React components to catch accessibility and UX issues like missing labels or poor interaction patterns. ## Quick Start Ask the assistant to review my UI files in src/components 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 files, 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 guidelines does the web design review use?

It fetches the rules from the vercel-labs web-interface-guidelines repository on GitHub before each review. This ensures the audit always uses the most current version of the guidelines rather than a stale cached copy.

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 review produce?

Findings are output in a terse file:line format as specified by the fetched guidelines. Each finding points to the exact location in your code where a rule is violated.

Does the design review work offline?

No, it 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.