Index of every page on this site: llms.txt
All skills
vercel-labs avatar

/web-design-guidelines

@5a37a63 official
by Vercel Labsvercel-labs/agent-skills35k stars
3,011
Run it yourself

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

Use this Skill: https://skilld.dev/gh/vercel-labs/agent-skills/web-design-guidelines

Nothing lands on disk. Nothing to clean up.

Fork this Skill

Edit a local copy. It keeps the author and licence.

SKILL.md

≈52 tokens for metadata: the name and description. ≈440 when used: this file. ≈2k more on demand in 1 file.

Description uses 2.6% of example budget

Before choosing a Skill, your Agent reads its name and description. All available Skills share that space.

  • A shorter description leaves more room for other Skills. This entry exceeds our 1% size suggestion.

In our Claude Code example, all Skill names and descriptions share 8,000 characters. This Skill uses ≈208 characters, or 2.6%.

The 1% threshold is a size suggestion. Longer descriptions can still fit.

Your model, settings, and other Skills decide how much text your Agent can read.

Example settings and source

The example uses a 200k-token context and default Claude Code settings. The count includes the name, description, separators, and when_to_use when present. Codex also counts local file paths.

Skit's source and limits: Codex 0.160.1, Claude Code 2.1.292.

Web Interface Guidelines

Review files for compliance with Web Interface Guidelines.

How It Works

  1. Read the bundled guidelines at references/command.md
  2. Read the specified files (or prompt user for files/pattern)
  3. Check against all rules in the guidelines
  4. Output findings in the terse file:line format

Guidelines Source

The rules are bundled with this skill in the references/command.md file. Read that file before each review. Do not fetch rules from the network.

The snapshot is pinned to a specific upstream commit:

Source: https://github.com/vercel-labs/web-interface-guidelines/blob/434b7f91364665f2f733b310ec54809bf8f37937/command.md

SHA-256: d246b026f4f29b5823a9cc857f9edf3d2507002e055e32040cadeaf3b38e0234

The file contains all the rules and output format instructions. Where it says $ARGUMENTS, use the files or pattern the user asked to review.

Updating the Guidelines

To update the snapshot to a newer upstream version:

  1. Get the latest commit SHA: gh api repos/vercel-labs/web-interface-guidelines/commits/main --jq .sha
  2. Download it: curl -fsSL https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/<SHA>/command.md -o references/command.md
  3. Review the changes, then update the Source URL and SHA-256 above (shasum -a 256 references/command.md)
  4. Regenerate skills/web-design-guidelines.zip so it matches the updated folder

Usage

When a user provides a file or pattern argument:

  1. Read references/command.md
  2. Read the specified files
  3. Apply all rules from the guidelines
  4. Output findings using the format specified in the guidelines

If no files specified, ask the user which files to review.

Source: SKILL.md on GitHub

skilld matched fixed text patterns in SKILL.md and file names. Patterns miss obfuscated code.

skilld run checks every file with the same patterns. It asks for approval before it loads a Skill with a behavior marked Needs approval.

No alertstoday5 checks · Risk SAFE
  • Gen Agent Trust Hubtoday

    This skill provides a utility for auditing UI code against accessibility and best-practice guidelines. It includes security considerations related to processing user-provided files, which is an expected part of its functionality. The skill follows safe patterns by using bundled references and providing clear maintenance instructions.

  • Sockettoday

    No alerts

  • Snyktoday

    Risk: LOW · No issues

  • Runlayer8mo

    1 file scanned · No issues

  • ZeroLeaks7mo

    Score: 93/100 · 2 sections analyzed

Signed by skilld at 5a37a63. This ties the file your Agent reads to that commit on GitHub. It does not review the instructions.

Last checked against GitHub 10 hours ago.

Activeupdated 3 weeks ago
Other metadata
metadata
{
  "author": "vercel",
  "version": "1.1.0",
  "argument-hint": "<file-or-pattern>"
}
  • web-design
  • accessibility
  • ui-review
  • guidelines
  • compliance
  • ux-audit
  • code-review

README badge

README badge for vercel-labs/agent-skills/web-design-guidelines

Audits UI code against Vercel's Web Interface Guidelines by fetching the latest ruleset and reporting compliance issues in a terse format. Use this to review HTML, CSS, or component files for accessibility, design system adherence, and UX best practices.

Generated from the current SKILL.md.

What design guidelines does this skill check against?
It fetches the latest Web Interface Guidelines from the Vercel Labs repository and checks code compliance against all rules in that document.
Can I use this to audit my entire site or just specific files?
You can specify individual files or patterns to review. If you don't provide a file argument, the skill will prompt you to specify which files to audit.
What output format does this skill use?
It reports findings in terse `file:line` format as specified in the fetched guidelines document.
Does this skill check accessibility?
Yes. Accessibility checks are included as part of the Web Interface Guidelines compliance review.

Generated from the current SKILL.md. These answers refresh after source changes.