
Web Design Guidelines
FreeEnsure your UI complies with best design practices.
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 source1. Install with the skills CLI
npx skills add tech-leads-club/agent-skills/web-design-guidelines --agent claude-code2. 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-clubWeb Interface Guidelines
Review files for compliance with Web Interface Guidelines.
How It Works
- Read the guidelines from
#[[file:references/guideline.md]] - Read the specified files (or prompt user for files/pattern)
- Check against all rules in the guidelines
- Output findings in the terse
file:lineformat
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:
- Read the guidelines from
references/guideline.md - Read the specified files
- Apply all rules from the guidelines
- 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:lineformat (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
Penpot UI/UX Design
Create professional UI/UX designs in Penpot with ease.
UX Theming
Streamline your VS Code theming process with best practices.
Wireframe
Create low-fidelity UI wireframes in SVG format.
Waitlist Page
Create a clean, focused pre-launch landing page.
Hallmark
Design skill for creating unique, structured UIs.
UI Styling
Create beautiful, accessible user interfaces effortlessly.
