web-design-guidelines

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

1|Updated May 6, 2026
One-click install
npx skills add https://github.com/surfingalien/FinSurfing --skill web-design-guidelines-surfingalien
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: web-design-guidelines
Source: https://github.com/surfingalien/FinSurfing/tree/main/.claude/skills/web-design-guidelines
Command: npx skills add https://github.com/surfingalien/FinSurfing --skill web-design-guidelines-surfingalien

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 stay current. - File or Pattern Targeting: Accepts a specific file or glob pattern argument to scope the review to the code you care about. - Terse Actionable Output: Reports findings in a compact file:line format so issues can be located and fixed quickly. - Use Case: Before shipping a new React page, ask for a UI review to catch accessibility violations and design inconsistencies against industry best practices. ## Quick Start Ask the assistant to review my UI files in src/components against 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 or pattern argument and the Skill fetches the latest Web Interface Guidelines, then checks your files against every rule. Findings are reported in a terse file:line format so you can jump directly to each issue.

What guidelines does this UI review check against?

It checks against 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 use the latest version.

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

Yes, you can pass a file pattern as the argument to scope the review across multiple files. If no files are specified, the Skill asks which files you want reviewed.

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 GitHub raw URL before each review. Without connectivity, the rules cannot be retrieved and the audit cannot proceed.

What output format does the design audit produce?

The audit outputs findings in a terse file:line format as specified by the fetched guidelines. This makes each violation easy to locate in your editor without reading lengthy reports.