# ux-principles

Gives your coding agent usability heuristics, user research methods and accessibility checks, so interface work follows known rules instead of guesswork.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 836 installs · ★ 62
- Author: manutej
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-design-toolkit/skills/ux-principles/SKILL.md
- Updated: 2026-06-13
- HTML: https://affpapa.org/en/nevibecode/skills/ux-principles

## What it does

The skill hands the agent a reference set: the four principles of user-centered design, the five stages of design thinking, and Nielsen's ten usability heuristics with notes on each. Ask it to rework a form or review a screen and it argues from those definitions rather than improvising.

Inside are written sections with principles and examples — visibility of system status, match with the real world, user control and freedom, consistency, error prevention, recognition over recall. Flexibility, aesthetics, error recovery and documentation follow. The material stops partway through the seventh heuristic.

Worth installing if you build interfaces and want the agent to cite specific principles. On a purely backend task it just adds context weight, so check the work is actually about user experience first.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a codex
```

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

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install manutej/luxor-claude-marketplace ux-principles
```

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

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-design-toolkit/skills/ux-principles
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -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/manutej/luxor-claude-marketplace/tree/HEAD/plugins/luxor-design-toolkit/skills/ux-principles/SKILL.md

## When to use it
- review a screen against usability heuristics
- plan user research for a new feature
- spot accessibility barriers in a form
- write personas and a user journey map
- cut friction from a checkout flow

## Example prompts
- run this screen through Nielsen's heuristics and list what breaks
- help me plan a usability test for the signup form
- check our checkout for accessibility issues and suggest fixes

## Similar
- [design-everyday-things](https://affpapa.org/en/nevibecode/skills/design-everyday-things.md) — skill · 5600 installs
- [mobile-principles](https://affpapa.org/en/nevibecode/skills/mobile-principles.md) — skill · 974 installs
- [ux-heuristics](https://affpapa.org/en/nevibecode/skills/ux-heuristics.md) — skill · 9400 installs
- [nielsen-heuristics-audit](https://affpapa.org/en/nevibecode/skills/nielsen-heuristics-audit.md) — skill · 739 installs
- [design-principles](https://affpapa.org/en/nevibecode/skills/design-principles.md) — skill · 2100 installs

From the same set: [manutej/luxor-claude-marketplace](https://affpapa.org/en/nevibecode/by/manutej/luxor-claude-marketplace.md) — 31 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