web-design-guidelines

web-design-guidelines is a skill for Claude Code from smicolon/ai-kit. It costs 30 tokens per session (460 once invoked), scanned A, original, MIT.

A checklist for reviewing web interfaces for readable typography, clear interactive states, responsive layouts, touch-friendly controls, contrast, and accessibility. It is aimed at React, Next.js, and other web frontend code.

In plain words
What is it for?
Use it to audit buttons, links, forms, headings, mobile layouts, focus states, loading states, and other interface details.
Why use it?
It helps catch usability and accessibility problems that may be missed when code works but is difficult to read or operate.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin.

Part of the react-review plugin — 2 skills shipped together

Good fit Use it to audit buttons, links, forms, headings, mobile layouts, focus states, loading states, and other interface details.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/smicolon/ai-kit/web-design-guidelines
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add smicolon/ai-kit --skill web-design-guidelines
Clone the repo
git clone --depth 1 https://github.com/smicolon/ai-kit

Made for: Claude Code.

Or install react-review, the plugin that ships this one along with the rest of its 2 skills.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for web-design-guidelines

README.md
[![agentmods](https://agentmods.dev/badge/skills/smicolon/ai-kit/web-design-guidelines/github.svg)](https://agentmods.dev/skills/smicolon/ai-kit/web-design-guidelines)
Your own site
<a href="https://agentmods.dev/skills/smicolon/ai-kit/web-design-guidelines"><img src="https://agentmods.dev/badge/skills/smicolon/ai-kit/web-design-guidelines/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for web-design-guidelines

Your own site · 80×15
<a href="https://agentmods.dev/skills/smicolon/ai-kit/web-design-guidelines"><img src="https://agentmods.dev/badge/skills/smicolon/ai-kit/web-design-guidelines.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 30 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 460 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00030 $0.00460
Opus 5.5 $0.00012 $0.00184
Sonnet 5.5 $0.00006 $0.00092
Haiku 4.5 $0.00003 $0.00046

Measured 1mo ago against content hash 5653a4388b29, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

web-design-guidelines scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 1mo ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

packs/react-review/skills/web-design-guidelines/SKILL.md · 37 lines

What it actually says

Web Interface Guidelines

Auditing rules for React, Next.js, and web frontend UI reviews.

Core Review Checkpoints

1. Typography & Hierarchy

  • Headings use semantic tags (<h1> to <h6>) in logical order without skipping levels.
  • Line heights and letter spacing maintain readable proportions (leading-relaxed or leading-normal for body text).
  • Avoid fixed pixel font sizes; use responsive Tailwind classes (text-sm, text-base, text-lg).

2. Interactive States & Affordances

  • Hover, Focus, and Active states: Every interactive element (<button>, <a>, <input>) must have discernible hover, focus-visible, and active states.
  • Focus Rings: Never use outline-none without providing an accessible focus-visible:ring-2 focus-visible:ring-offset-2 replacement.
  • Loading & Disabled States: Interactive buttons triggering async actions must indicate loading and be disabled to prevent duplicate submissions.

3. Touch Targets & Mobile Usability

  • Minimum touch target size for mobile/tablet is 44x44px (or min-h-[44px] min-w-[44px]).
  • Adequate padding between adjacent interactive elements to prevent mis-taps.

4. Color & Contrast

  • Text meets WCAG 2.1 AA minimum contrast ratio:
    • Normal text: 4.5:1
    • Large text (18pt / 24px+ or 14pt bold): 3:1
  • Colors are not the sole indicator of state (always pair color changes with icons, underline, or text labels).

5. Layout & Responsive Behavior

  • No horizontal scrollbars on viewport widths from 320px up to 4K.
  • Use CSS grid or flexbox with wrapping (flex-wrap).
  • Modals and popovers lock body scroll when open and dismiss on Escape key or backdrop click.
Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 1mo ago First seen · 37 lines · 30 tokens per session scan A 5653a4388b29

Subscribe to this mod's changes

web-design-guidelines is a skill published in the GitHub repository smicolon/ai-kit (6 stars, last pushed 1mo ago), licensed MIT. It adds 30 tokens to every session and 460 once invoked, about $0.0001 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-09-04.

Related

Other skills, from other repositories

ui-html-renderer

Use this specialist for unusually complex stateful HTML, blank/runtime-risk repair, strict source-to-HTML fidelity, reusable component galleries, brand boards, or detailed implementation handoff. Ordinary single-page HTML uses ui-design-executor, which already preserves HTML-default delivery and baseline…

Orkas-AI/Orkas · 4 tokens

product-ui

Use this skill when UI design and UI implementation should happen together. It turns product context into usable frontend screens, components, layout decisions, design-system choices, accessibility rules, and visual polish.

Orkas-AI/Orkas · 2 tokens

impeccable

Use when the user wants distinctive, production-grade frontend design, anti-generic AI aesthetics, UX critique, technical UI audits, or final polish through bundled Impeccable references and an optional upstream detector CLI.

Peiiii/nextclaw · 47 tokens

brand-tokens

A reference library of visual design rules for well-known brands, including colors, fonts, corner shapes, and explanations of each brand's visual style. Design tokens are reusable values that keep an interface's appearance consistent.

tianemon/EasyMint · 104 tokens

component-design

Apply a coherent visual system, responsive behavior, interaction states, and accessibility to Kun components.

KunAgent/Kun · 21 tokens

ui-aesthetic

A set of visual design rules for making web pages and components look consistent and readable. It covers icons, colors, typography, spacing, text, accessibility contrast, layout, and restrained animation.

tianemon/EasyMint · 118 tokens