New to Claude Skills? Learn how to install them →

tech-leads-club on GitHub

Web Design Guidelines

Free

Ensure your UI complies with best design practices.

Get this skill

Free · Opens the source repo

What Web Design Guidelines does

The Web Design Guidelines skill is designed to assist developers and designers in reviewing their user interface code for compliance with established web interface standards. This skill specifically focuses on visual design and interaction patterns, ensuring that your web applications are not only functional but also user-friendly and accessible. By leveraging this skill, you can streamline your design review process and catch potential issues early in the development cycle.

To use the skill, you simply provide the files you want to review, and the skill will check them against a comprehensive set of guidelines outlined in the included reference document. These guidelines cover a wide range of topics, including accessibility standards (such as ARIA and semantic HTML), proper form handling, and best practices for animations and typography. The skill outputs findings in a concise format that makes it easy to identify and address issues directly in your codebase.

This skill is particularly useful for teams focused on improving user experience and ensuring compliance with design best practices. It helps maintain a high standard of quality across your web applications, making them more accessible to a wider audience. Whether you are an individual developer or part of a larger design team, this skill can enhance your workflow by providing a structured approach to UI code reviews.

However, it is important to note that this skill is not intended for performance audits or SEO checks. For those specific needs, you should consider using other specialized tools. The Web Design Guidelines skill is best utilized when you are looking to enhance the visual and interactive aspects of your web applications without delving into performance metrics or search engine optimization.

When to use it

Use this skill when you need to review your UI code for compliance with web interface guidelines, especially during the development phase.

When not to use it

Avoid using this skill for performance audits, SEO checks, or comprehensive site audits, as it does not cover those areas.

What you can build with it

Reviewing a New UI Component

Before deploying a new UI component, use this skill to ensure it meets accessibility and design standards.

Conducting a Design Audit

Run a design audit on your existing web application to identify areas that need improvement in terms of compliance with best practices.

Ensuring Accessibility Compliance

Use this skill to verify that your web application adheres to accessibility guidelines, making it usable for all users.

How to install Web Design Guidelines

View source

1. Install with the skills CLI

npx skills add tech-leads-club/agent-skills/web-design-guidelines --agent claude-code

2. Or install it manually

Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.

Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs

Inside SKILL.md

Written by tech-leads-club

Web Interface Guidelines

Review files for compliance with Web Interface Guidelines.

How It Works

  1. Read the guidelines from #[[file:references/guideline.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 Reference

All rules and output format instructions are in:

#[[file:references/guideline.md]]

The guidelines cover:

  • Accessibility (ARIA, semantic HTML, keyboard navigation)
  • Focus states and keyboard interaction
  • Forms (autocomplete, validation, labels)
  • Animation (reduced motion, performance)
  • Typography (proper characters, number formatting)
  • Content handling (overflow, empty states)
  • Images (dimensions, lazy loading)
  • Performance (virtualization, DOM reads)
  • Navigation & state (URL sync, deep linking)
  • Touch & interaction (tap delays, safe areas)
  • Dark mode & theming
  • Locale & i18n
  • Hydration safety
  • Common anti-patterns to flag

Usage

When a user provides a file or pattern argument:

  1. Read the guidelines from references/guideline.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.

Output Format

Follow the format in the guidelines:

  • Group findings by file
  • Use file:line format (VS Code clickable)
  • Terse, high signal-to-noise
  • State issue + location
  • Skip explanation unless fix is non-obvious

Frequently asked questions about Web Design Guidelines

Similar skills