# uxui-evaluator

This skill reviews interface descriptions against UX/UI principles and returns structured findings. Use it before building a screen or user flow.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 26
- Author: uxuiprinciples
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/uxuiprinciples/agent-skills/tree/HEAD/uxui-evaluator/SKILL.md
- Updated: 2026-08-31
- HTML: https://affpapa.org/en/nevibecode/skills/uxui-evaluator

## What it does

\`uxui-evaluator` examines an interface description through 195 UX/UI principles grouped into 6 framework parts. It first classifies the interface, selects relevant areas, and then produces JSON findings with severity, suggested fixes, strengths, and an overall score. The checks cover topics such as cognitive load, navigation, forms, accessibility, and AI interface behaviour.

The skill includes `curl`-based tools for a full audit, principle lookup by slug, and listing principles for a framework part. `UXUI_API_KEY` is optional, but enriched results from `uxuiprinciples.com` require API access. The Pro tier exposes all 195 principles, while the free tier returns 12. Without `UXUI_API_KEY`, the API audit cannot run and the skill uses its internal framework knowledge instead.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add uxuiprinciples/agent-skills --skill uxui-evaluator -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add uxuiprinciples/agent-skills --skill uxui-evaluator -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add uxuiprinciples/agent-skills --skill uxui-evaluator -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install uxuiprinciples/agent-skills uxui-evaluator
```

2. **Manually: put the files in place**
- File: `.github/skills/uxui-evaluator/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add uxuiprinciples/agent-skills --skill uxui-evaluator -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/uxuiprinciples/agent-skills --path uxui-evaluator
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add uxuiprinciples/agent-skills --skill uxui-evaluator -a opencode
```

### 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/uxuiprinciples/agent-skills/tree/HEAD/uxui-evaluator/SKILL.md

## When to use it
- audit a signup form before implementation
- spot UX issues in a dashboard or navigation flow
- assign severity and remediation to interface findings
- connect design findings with business impact

## Example prompts
- Review this signup form and return a structured UX/UI audit.
- Inspect this dashboard for principle violations, severity, and concrete fixes.
- Evaluate the `checkout` flow and include business impact when API access is available.

## Similar
- [frontend-design](https://affpapa.org/en/nevibecode/skills/frontend-design.md) — skill · 1025790 installs
- [grill-me](https://affpapa.org/en/nevibecode/skills/grill-me.md) — skill · 1424476 installs
- [design-taste-frontend](https://affpapa.org/en/nevibecode/skills/design-taste-frontend.md) — skill · 678700 installs
- [prototype](https://affpapa.org/en/nevibecode/skills/prototype.md) — skill · 986201 installs
- [grilling](https://affpapa.org/en/nevibecode/skills/grilling.md) — skill · 979543 installs
- [codebase-design](https://affpapa.org/en/nevibecode/skills/codebase-design.md) — skill · 850344 installs

From the same set: [uxuiprinciples/agent-skills](https://affpapa.org/en/nevibecode/by/uxuiprinciples/agent-skills.md) — 5 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