About uxui-principles
uxui-principles is a collection of five agent skills for evaluating interfaces, finding UX antipatterns, and adding UX context to AI-assisted design and coding. It returns structured findings with severity and remediation guidance, with optional API-enriched citations.
Key features
- 01Five focused UX/UI evaluation skills
- 02Evaluation against research-backed principles
- 03Detection of UX antipatterns and smells
- 04Structured findings with severity and remedies
- 05Optional API-enriched citations
Use cases
- 01Auditing an existing interface
- 02Reviewing AI-powered interfaces
- 03Checking a user flow for UX issues
- 04Adding UX guidance before implementation
Install
Copy the command and run it in a terminal.
$
npx skills add https:/After installing, type/uxui-principlesin Claude Code to confirm it loaded.
Details
From the project READMEUX/UI Principles
A collection of 5 agent skills for evaluating interfaces against 168 research-backed UX/UI principles, detecting antipatterns, and injecting UX context into AI-assisted design and coding sessions.
Source: https://github.com/uxuiprinciples/agent-skills
Skills
| Skill | Purpose |
|---|---|
uxui-evaluator | Evaluate interface descriptions against 168 research-backed principles |
interface-auditor | Detect UX antipatterns using the uxuiprinciples smell taxonomy |
ai-interface-reviewer | Audit AI-powered interfaces against 44 AI-era UX principles |
flow-checker | Check user flows against decision, error, and feedback principles |
vibe-coding-advisor | Inject UX context into vibe coding sessions before implementation |
When to Use
- Auditing an existing interface for UX issues
- Checking if a UI follows research-backed best practices
- Detecting antipatterns and UX smells in designs
- Reviewing AI-powered interfaces for trust, transparency, and safety
- Getting UX guidance before or during implementation
How It Works
- Install any skill from the collection
- Describe the interface, screen, or flow you want to evaluate
- The skill evaluates against the relevant principles and returns structured findings with severity levels and remediation steps
- Optionally connect to the uxuiprinciples.com API for enriched output with full citations
Install
npx skills add uxuiprinciples/agent-skills
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Comments
Markdown supported