# web-design-guidelines

web-design-guidelines is a Claude Code skill that audits Mikka's web interface for accessibility, responsive layouts, forms, and interaction flows.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 88 repo stars
- Author: alexj11324
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/web-design-guidelines/SKILL.md
- Updated: 2026-11-17
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/alexj11324-web-design-guidelines

## What it does

The skill runs audits against an adapted Web Interface Guidelines checklist tuned for the Mikka repository. It inspects semantic controls, keyboard focus handling, state indicators, layout stability, and responsiveness down to 390px widths. External design rules remain secondary to Mikka's local Figma files and the packaged presentation of paid component packs such as BoardUI Pro, affectUI, and beUI Pro.

Execution requires project documentation files: `docs/design/README.md`, `docs/design/rules.md`, `docs/design/components.md`, and `docs/review-checklist.md`. Reports follow a strict format covering file path, line number, route, user action, evidence, severity, and fix owner. Suggested fixes must rely on existing UI components rather than new styling themes.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill web-design-guidelines -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/web-design-guidelines/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/web-design-guidelines/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill web-design-guidelines -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/web-design-guidelines/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill web-design-guidelines -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/web-design-guidelines/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alexj11324/Mikka .claude/skills/web-design-guidelines
```

2. **Manually: put the files in place**
- File: `.github/skills/web-design-guidelines/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add alexj11324/Mikka --skill web-design-guidelines -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/alexj11324/Mikka --path .claude/skills/web-design-guidelines
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/web-design-guidelines/SKILL.md` — The legacy .windsurf/skills/ path still works

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/alexj11324/Mikka/tree/HEAD/.claude/skills/web-design-guidelines/SKILL.md

## When to use it
- audit UI controls for semantic accessibility and keyboard focus
- detect layout overflows and issues under 390px mobile viewport widths
- verify form input validation, error placement, and draft preservation
- generate structured audit reports mapped to exact source code lines

## Example prompts
- Review the user settings page against web-design-guidelines
- Audit the checkout form for keyboard accessibility and error handling
- Check the mobile navigation layout at 390px width for overflows

## Similar
- [design-system](https://affpapa.org/en/nevibecode/skills/affaan-m-design-system.md) — skill · 6800 installs
- [ios-design-guidelines](https://affpapa.org/en/nevibecode/skills/ios-design-guidelines.md) — skill · 2200 installs
- [exceptional-web-design](https://affpapa.org/en/nevibecode/skills/exceptional-web-design.md) — skill · ★ 1167 repo stars
- [web-design-reviewer](https://affpapa.org/en/nevibecode/skills/web-design-reviewer.md) — skill · 13957 installs
- [modern-web-design](https://affpapa.org/en/nevibecode/skills/modern-web-design.md) — skill · 3200 installs
- [Web Design Builder](https://affpapa.org/en/nevibecode/skills/web-design-builder.md) — skill · 432 installs

## Other versions with the same name
- [web-design-guidelines · tech-leads-club](https://affpapa.org/en/nevibecode/skills/web-design-guidelines-3.md) — ★ 7191 repo stars
- [web-design-guidelines · ehmo](https://affpapa.org/en/nevibecode/skills/platform-design-skills-web-design-guidelines.md) — 1600 installs
- [web-design-guidelines · asyrafhussin](https://affpapa.org/en/nevibecode/skills/agent-skills-web-design-guidelines.md) — 970 installs

From the same set: [alexj11324/mikka](https://affpapa.org/en/nevibecode/by/alexj11324/mikka.md) — 47 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
