Agent skill

Web Design Guidelines

by CloudAI-X in CloudAI-X/claude-workflow-v2

Review UI code for Web Interface Guidelines compliance. An agent skill from CloudAI-X/claude-workflow-v2.

MITAuto-check passedFrontend & Design

Install Web Design Guidelines

skills CLI
$ npx skills add CloudAI-X/claude-workflow-v2 --skill web-design-guidelines -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install CloudAI-X/claude-workflow-v2 web-design-guidelines --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/CloudAI-X/claude-workflow-v2.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/web-design-guidelines .claude/skills/web-design-guidelines && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
web-design-guidelines
GitHub stars
1.4k
Token cost
~1.7k tokens
SKILL.md length
815 words
Files
1
Skills in repo
13
Repo updated
First seen
Licence
MIT

At a glance

Review UI code for Web Interface Guidelines compliance. An agent skill from CloudAI-X/claude-workflow-v2.

  • Works in 7 steps: Accessibility (A11Y) → Performance (PERF) → Responsive Design (RD) → …
  • Asked to review my UI
  • SKILL.md covers Output Format, 1. Accessibility (A11Y), 2. Performance (PERF) and 3. Responsive Design (RD), plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Web Design Guidelines is an agent skill from CloudAI-X/claude-workflow-v2. Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", "check my site against best practices", or "web interface guidelines".

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Frontend & Design, covering Accessibility, Frontend development and Responsive design. The repository describes itself as: Universal Claude Code workflow plugin with agents, skills, hooks, and commands. The licence is MIT.

When your agent uses it

  • Asked to review my UI
  • Check accessibility
  • Check my site against best practices
  • Web interface guidelines

Example prompts

  • “review my UI”
  • “check accessibility”
  • “audit design”
  • “/web-design-guidelines”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Accessibility (A11Y)
  2. Performance (PERF)
  3. Responsive Design (RD)
  4. Component Patterns (CP)
  5. CSS Practices (CSS)
  6. Security (SEC)
  7. Internationalization (I18N)

What it can do on your machine

Read from SKILL.md and the folder at commit 3b5a89e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Web Design Guidelines loads about 1.7k tokens when it runs. Until then it costs about 59 tokens; SKILL.md has 815 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~59
When it runs · the whole SKILL.md, loaded when a task matches
~1.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from CloudAI-X/claude-workflow-v2 at commit 3b5a89e, republished under its MIT licence (© CloudAI-X). 815 words, ~1,654 tokens.

Download SKILL.mdSave it as .claude/skills/web-design-guidelines/SKILL.md (or your agent's skills folder).
name
web-design-guidelines
description
Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", "check my site against best practices", or "web interface guidelines".

Web Interface Guidelines

When to Load
  • Trigger: UI audit, accessibility checks, responsive design review, UX best practices evaluation
  • Skip: Backend-only work with no UI components

Self-contained guidelines for reviewing web interfaces. Apply these rules when auditing UI code.

Output Format

Report findings as: file:line — [RULE_ID] description

Example: src/Button.tsx:12 — [A11Y-01] Missing aria-label on icon button

1. Accessibility (A11Y)

A11Y-01: Semantic HTML
  • Use <button> for actions, <a> for navigation, <input> for data entry
  • Never use <div onClick> or <span onClick> for interactive elements
  • Use <nav>, <main>, <aside>, <header>, <footer> for landmarks
A11Y-02: ARIA Labels
  • All interactive elements need accessible names
  • Icon-only buttons MUST have aria-label
  • Form inputs MUST have associated <label> or aria-label
  • Images need alt text (decorative images: alt="")
A11Y-03: Keyboard Navigation
  • All interactive elements must be reachable via Tab
  • Custom components need proper role, tabIndex, and key handlers
  • Focus must be visible (never outline: none without replacement)
  • Modal/dialog must trap focus and return focus on close
A11Y-04: Color & Contrast
  • Text contrast ratio: 4.5:1 minimum (3:1 for large text)
  • Never use color alone to convey meaning (add icons, text, patterns)
  • Ensure UI is usable at 200% zoom
A11Y-05: Screen Readers
  • Dynamic content changes need aria-live regions
  • Loading states need aria-busy="true"
  • Error messages linked to inputs via aria-describedby

2. Performance (PERF)

PERF-01: Image Optimization
  • Use next/image or responsive images with srcset
  • Specify width and height to prevent layout shift
  • Lazy load below-fold images: loading="lazy"
  • Use WebP/AVIF with fallback
PERF-02: Bundle Size
  • No barrel imports: import Button from 'lib/Button' not import { Button } from 'lib' (or enable optimizePackageImports)
  • Tree-shake CSS: use CSS modules or Tailwind content config (v3) / automatic detection (v4)
  • Lazy load routes and heavy components: React.lazy() or dynamic imports
PERF-03: Rendering
  • Avoid layout thrashing: don't read then write DOM in loops
  • Use will-change sparingly (only for known animations)
  • Prefer CSS animations over JS animations
  • Use transform and opacity for 60fps animations (compositor-only)
PERF-04: Core Web Vitals
  • LCP < 2.5s: Optimize largest image/text, preload critical resources
  • INP < 200ms: No long tasks on main thread, defer non-critical JS
  • CLS < 0.1: Set dimensions on images/embeds, no injected content above fold

3. Responsive Design (RD)

RD-01: Mobile First
  • Base styles for mobile, then @media (min-width) for larger screens
  • Touch targets minimum 44x44px
  • No horizontal scroll on any viewport
RD-02: Fluid Layout
  • Use rem/em for typography, not px
  • Use clamp() for fluid typography: font-size: clamp(1rem, 2.5vw, 2rem)
  • Flex/Grid over fixed widths
  • Max content width: max-width: 65ch for readability
RD-03: Breakpoints
  • Don't target devices, target content breakpoints
  • Common: 640px (sm), 768px (md), 1024px (lg), 1280px (xl)
  • Test at 320px, 375px, 768px, 1024px, 1440px, 1920px

4. Component Patterns (CP)

CP-01: Forms
  • Show validation errors inline, next to the field
  • Use type="email", type="tel", inputmode="numeric" for mobile keyboards
  • Disable submit button during submission (prevent double-submit)
  • Preserve form state on error (don't clear fields)
CP-02: Loading States
  • Show skeleton screens over spinners for content areas
  • Indicate progress for long operations (progress bar > spinner)
  • Disable interactive elements during loading
  • Set aria-busy="true" on loading containers
Show full SKILL.md (325 more words)Show less
CP-03: Error States
  • Always show actionable error messages ("Try again" button, not just "Error")
  • Don't show technical errors to users (log internally, show friendly message)
  • Error boundaries for React component trees
  • Retry logic for network failures
CP-04: Empty States
  • Never show blank pages — provide helpful empty states
  • Include call-to-action: "No items yet. Create your first item."
  • Use illustrations sparingly (they add bundle weight)
CP-05: Modals & Dialogs
  • Use <dialog> element or proper role="dialog"
  • Trap focus within modal
  • Close on Escape key and backdrop click
  • Return focus to trigger element on close
  • Prevent body scroll while open

5. CSS Practices (CSS)

CSS-01: Specificity
  • Prefer class selectors over ID or element selectors
  • Avoid !important (use specificity or cascade layers)
  • Use CSS custom properties for theming
  • One direction for spacing: prefer margin-bottom over margin-top
CSS-02: Layout
  • Use Flexbox for 1D layout, Grid for 2D layout
  • Avoid position: absolute for layout (use for overlays only)
  • Use gap over margins between flex/grid children
  • Use min-height: 100dvh (not 100vh) for full-height layouts
CSS-03: Dark Mode
  • Use prefers-color-scheme media query
  • Define all colors as CSS custom properties
  • Test both modes — check contrast in both
  • Don't just invert colors — design intentionally for dark mode

6. Security (SEC)

SEC-01: Content Security
  • Never use dangerouslySetInnerHTML without sanitization
  • Sanitize user-generated content before rendering
  • Use rel="noopener noreferrer" on external links with target="_blank"
SEC-02: Forms & Input
  • CSRF protection on all forms
  • Rate limit form submissions
  • Validate on both client AND server

7. Internationalization (I18N)

I18N-01: Text
  • Don't hardcode strings — use i18n library or constants
  • Support RTL layouts: use logical properties (margin-inline-start over margin-left)
  • Don't truncate text — designs must accommodate 40% text expansion
  • Use lang attribute on <html> tag

Review Checklist

When auditing a file, check in this order (CRITICAL first):

  1. CRITICAL: A11Y-01, A11Y-02, SEC-01 — Semantic HTML, ARIA, XSS prevention
  2. HIGH: PERF-04, A11Y-03, CP-01 — Core Web Vitals, keyboard, forms
  3. MEDIUM: RD-01, CSS-02, CP-02, CP-03 — Responsive, layout, loading/errors
  4. LOW: CSS-03, I18N-01, CP-04 — Dark mode, i18n, empty states

© CloudAI-X, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/web-design-guidelines of CloudAI-X/claude-workflow-v2.

Open the folder on GitHubat commit 3b5a89e

Compare with similar skills

Web Design Guidelines next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Web Design Guidelines compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Web Design Guidelines this skillCloudAI-X/claude-workflow-v21.4k—~1.7kAutomated safety check: PassMIT
UI CraftMemTensor/memmy-agent2.1k—~2.9kAutomated safety check: PassMIT
Web Design Guidelinesehmo/platform-design-skills606—~9.7kAutomated safety check: PassMIT
UI Guidelineshmislk/hmis236—~816Automated safety check: PassGPL-3.0
Frontend DesignRedWoodOG/Hermes-Desktop177—~1.2kAutomated safety check: PassNone
Common Web Visual TestingHoangNguyen0403/agent-skills-standard571—~760Automated safety check: PassMIT

Similar skills

  • UI Craft

    MemTensor/memmy-agent

    Design, build, redesign, or modify browser-visible web interfaces with product-quality composition, visual systems, interaction states, responsive behavior, accessibility, and browser visual QA.

    2.1k GitHub stars~2.9k tokensUpdated today
    Frontend & DesignAuto-check passed
  • Web Design Guidelines

    ehmo/platform-design-skills

    Web platform design and accessibility guidelines. An agent skill from ehmo/platform-design-skills.

    606 GitHub stars~9.7k tokensUpdated 6 mo ago
    Frontend & DesignAuto-check passed
  • UI Guidelines

    hmislk/hmis

    HMIS UI development guidelines for JSF/XHTML pages. An agent skill from hmislk/hmis.

    236 GitHub stars~816 tokensUpdated today
    Frontend & DesignAuto-check passed
  • Frontend Design

    RedWoodOG/Hermes-Desktop

    Frontend development with modern frameworks, responsive design, and accessibility best practices.

    177 GitHub stars~1.2k tokensUpdated 4 mo ago
    Frontend & DesignAuto-check passed
  • Common Web Visual Testing

    HoangNguyen0403/agent-skills-standard

    Standardizes visual audits, responsive design, and behavioral testing for web apps.

    571 GitHub stars~760 tokensUpdated today
    Frontend & DesignAuto-check passed
  • HTML Coder

    TokenRhythm/opensquilla

    Guides semantic, accessible HTML work: pages, forms, media and HTML5 APIs, plus how to deliver a runnable webpage project with a preview.

    7.1k GitHub stars~1.4k tokensUpdated 3 days ago
    Frontend & DesignAuto-check passed

More from CloudAI-X/claude-workflow-v2

All 13 skills in this repo
  • Analyzing Projects

    CloudAI-X/claude-workflow-v2

    Analyzes codebases to understand structure, tech stack, patterns, and conventions.

    1.4k GitHub starsUsed in 2 repos~937 tokens
    Auto-check passed
  • Designing APIs

    CloudAI-X/claude-workflow-v2

    Designs REST and GraphQL APIs including endpoints, error handling, versioning, and documentation.

    1.4k GitHub starsUsed in 2 repos~1.2k tokens
    Auto-check passed
  • Designing Architecture

    CloudAI-X/claude-workflow-v2

    Designs software architecture and selects appropriate patterns for projects.

    1.4k GitHub starsUsed in 1 repo~1.4k tokens
    Auto-check passed
  • Designing Tests

    CloudAI-X/claude-workflow-v2

    Designs and implements testing strategies for any codebase. An agent skill from CloudAI-X/claude-workflow-v2.

    1.4k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed
  • Managing Git

    CloudAI-X/claude-workflow-v2

    Manages Git workflows including branching, commits, and pull requests.

    1.4k GitHub starsUsed in 1 repo~1.3k tokens
    Auto-check passed
  • Optimizing Performance

    CloudAI-X/claude-workflow-v2

    Analyzes and optimizes application performance across frontend, backend, and database layers.

    1.4k GitHub starsUsed in 1 repo~1.5k tokens
    Auto-check passed

Questions about Web Design Guidelines

What does Web Design Guidelines do?

Review UI code for Web Interface Guidelines compliance. An agent skill from CloudAI-X/claude-workflow-v2. Web Design Guidelines is an agent skill from CloudAI-X/claude-workflow-v2. Review UI code for Web Interface Guidelines compliance.

When should I use Web Design Guidelines?

Web Design Guidelines fits situations like: asked to review my UI; check accessibility; check my site against best practices; web interface guidelines.

How do I install Web Design Guidelines in Claude Code?

Run `npx skills add CloudAI-X/claude-workflow-v2 --skill web-design-guidelines -a claude-code`. Or copy the skill folder (skills/web-design-guidelines in CloudAI-X/claude-workflow-v2) into .claude/skills/web-design-guidelines in your project. Claude Code loads it when a task matches its description.

How do I install Web Design Guidelines in Codex?

Run `npx skills add CloudAI-X/claude-workflow-v2 --skill web-design-guidelines -a codex`. Or copy the skill folder (skills/web-design-guidelines in CloudAI-X/claude-workflow-v2) into .agents/skills/web-design-guidelines in your project. Codex loads it when a task matches its description.

Can I use Web Design Guidelines in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add CloudAI-X/claude-workflow-v2 --skill web-design-guidelines -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/web-design-guidelines, .gemini/skills/web-design-guidelines, .github/skills/web-design-guidelines and .opencode/skills/web-design-guidelines in your project.

What does Web Design Guidelines need to run?

SKILL.md names no scripts, command-line tools or credentials: Web Design Guidelines is instructions for the agent only.

Does Web Design Guidelines access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Web Design Guidelines safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Web Design Guidelines use?

Web Design Guidelines is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Web Design Guidelines use?

About 1.7k tokens (SKILL.md is roughly 6.6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Web Design Guidelines?

Skills that share tags, products or a category with Web Design Guidelines: UI Craft (MemTensor/memmy-agent, 2.1k stars), Web Design Guidelines (ehmo/platform-design-skills, 606 stars), UI Guidelines (hmislk/hmis, 236 stars) and Frontend Design (RedWoodOG/Hermes-Desktop, 177 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Web Design Guidelines?

CloudAI-X (a GitHub user) maintains it in CloudAI-X/claude-workflow-v2, which has 1,418 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on October 6, 2026.

Source: CloudAI-X/claude-workflow-v2 on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.