ux-interaction-taste

# ux-interaction-taste

[中文文档](README.zh.md)

A structured UX interaction review skill focused on **how things work**, not how they look. Evaluates interaction completeness, feedback quality, and user experience robustness of web applications — especially those built with AI coding tools.

Complements visual design skills (like [design-taste-frontend](https://github.com/leonxlnx/taste-skill)) — this skill handles interaction/UX, that skill handles visual aesthetics.

## What It Reviews

Three-tier evaluation framework:

| Tier | Focus | Examples |
|------|-------|---------|
| **Foundation** | Does it work? | Loading/empty/error states, hover/focus feedback, keyboard accessibility |
| **Craft** | Is it well-designed? | Feedback timing, form UX, focus management, responsive behavior, animation quality |
| **Polish** | Does it feel right? | Micro-interactions, error recovery, flow intentionality |

Plus detection of common AI-generated interaction anti-patterns (missing states, swallowed errors, broken keyboard nav, etc.)

## Installation

### Via skills.sh (recommended)

```bash
npx skills add psylch/ux-interaction-taste-skill -g -y
```

### Manual Install

```bash
git clone https://github.com/psylch/ux-interaction-taste-skill.git ~/.claude/skills/ux-interaction-taste
```

Restart your agent after installation.

## Prerequisites

- Any AI coding agent that supports [skills.sh](https://skills.sh/) (Claude Code, Cursor, Windsurf, etc.)

## Usage

```
review the UX of this project
check interaction quality of src/components/
走查交互
检查用户体验
```

The skill accepts a path, URL, or reviews the current project. Output is a structured report with prioritized fixes.

## License

MIT