agentleFS
karim-bhalwanikarim-bhalwani/agent-skills-collection/skills/web-design-guidelines/SKILL.md

web-design-guidelines

Skill0 starsChanged 10 months agoMITView on GitHub

Review UI code for Web Interface Guidelines compliance. Use when reviewing UI code, checking accessibility standards, auditing design consistency, or validating sites against best practices.

176 other projects use a version of this, 162 of them edited.

Adopted by

Most recently taken up by

Used with

Projects with it also use canvas-procedural-animation, intelligent-routing and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • LinHao-citySkill

    canvas-procedural-animation

    Use p5.js/canvas for local procedural character effects: particles, weather, squash/stretch, walk cycles, and environmental motion.

    Also in 5 projects that use this

  • SKB3002Skill

    intelligent-routing

    Automatic agent selection and intelligent task routing. Analyzes user requests and automatically selects the best specialist agent(s) without requiring explicit user mentions.

    Also in 5 projects that use this

  • VercelSkill

    vercel-optimize

    Use for Vercel cost and performance optimization on deployed projects, especially Next.js, SvelteKit, Nuxt, and limited Astro apps. Collect Vercel metrics, usage, project config, and code scan results first; investigate only metric-backed candidates; produce ranked recommendations grounded in verified files and version-aware Vercel/framework docs. Trigger for Vercel bill reduction, slow or expensive routes, caching opportunities, Function Invocations, Build Minutes, Fast Data Transfer, Core Web Vitals, Bot Management, Fluid compute, or cost breakdown requests.

    Also in 15 projects that use this

  • thongdn-itSkill

    nuqs

    nuqs (type-safe URL query state) best practices for Next.js applications. This skill should be used when writing, reviewing, or refactoring code that uses nuqs for URL state management. Triggers on tasks involving useQueryState, useQueryStates, search params, URL state, query parameters, nuqs parsers, or Next.js routing with state.

    Also in 4 projects that use this

  • LinHao-citySkill

    pose-library-design

    Design reusable 2D character pose libraries, action cycles, and expression states for data-driven animation.

    Also in 4 projects that use this

  • stophobiaSkill

    surprise-me

    Create a delightful, unexpected "wow" experience for the user by dynamically discovering and creatively combining other enabled skills. Triggers when the user says "surprise me" or any request expressing a desire for an unexpected creative showcase. Also triggers when the user is bored, wants inspiration, or asks for "something interesting".

    Also in 4 projects that use this

  • +2 more from LinHao-city

The file

We split this skill into the rules it gives an agent

9 rules. 6 are common, 3 are distinctive, and 0 are very specific to this project.

  • 6

    Common

    Most of the 173 edited versions we read keep these.

  • 3

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Common:

    Read the specified files (or prompt user for files/pattern)

    line 20
  2. Common:

    Check against all rules in the fetched guidelines

    line 21
  3. Common:

    Use WebFetch to retrieve the latest rules.

    line 32
  4. Common:

    When a user provides a file or pattern argument:

    line 36
  5. Common:

    Read the specified files

    line 39
  6. Common:

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

    line 43
  7. Distinctive:

    Success Criteria: No critical accessibility failures and clear remediation steps for others

    line 49
  8. Distinctive:

    Technical Constraints: Do not modify source files automatically.

    line 54
  9. Distinctive:

    Governance Constraints: Use latest guidelines from the canonical source before each review

    line 56

“Common” is measured: kept by at least 6 in 10 of the 173 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Web Interface Guidelines

Review files for compliance with Web Interface Guidelines.

How It Works

  1. Fetch the latest guidelines from the source URL below
  2. Read the specified files (or prompt user for files/pattern)
  3. Check against all rules in the fetched guidelines
  4. Output findings in the terse file:line format

Guidelines Source

Fetch fresh guidelines before each review:

https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md

Use WebFetch to retrieve the latest rules. The fetched content contains all the rules and output format instructions.

Usage

When a user provides a file or pattern argument:

  1. Fetch guidelines from the source URL above
  2. Read the specified files
  3. Apply all rules from the fetched guidelines
  4. Output findings using the format specified in the guidelines

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

Outputs & Deliverables

  • Primary Output: Accessibility and design review findings in file:line format and a short remediation list
  • Secondary Output: Suggested code snippets or CSS fixes for small violations
  • Success Criteria: No critical accessibility failures and clear remediation steps for others
  • Quality Gate: implementer review for fixes prior to merge

Constraints

  • Technical Constraints: Do not modify source files automatically; produce recommended fixes only
  • Scope Constraints: Focus on UI guidelines and accessibility; visual design approvals are separate
  • Governance Constraints: Use latest guidelines from the canonical source before each review

Common Pitfalls

  • Stale Guidelines: Using local cached guidelines instead of fetching fresh ones. Always fetch from the canonical source before each review.
  • Skipping Accessibility: Checking only visual design, not keyboard navigation or screen reader support. Accessibility is mandatory, not optional.
  • Ignoring Contrast Ratios: Visual text looks fine but fails WCAG contrast requirements. Always validate color contrasts programmatically.
  • Missing Responsive Testing: UI looks good on desktop but breaks on mobile. Test at multiple breakpoints.
  • Not Suggesting Fixes: Reporting problems without showing how to fix them. Always provide remediation code snippets.
  • Vague Findings: "Design looks off" instead of specific violations. Reference exact lines and rules.

Integration Points

PhaseInput FromOutput ToContext
Review RequestUI code filesGuidelines fetchRetrieve canonical guidelines from source
AnalysisCode patterns and stylesFindings reportIdentify violations against guidelines
RemediationViolations foundimplementerProvide code examples for fixes
Merge GateUI changes completeQA approvalNo critical accessibility issues before merge

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.