uxui-principles
Helps your agent evaluate interfaces based on proven design principles. It identifies common errors and improves the user experience in code projects.
What it does
This tool helps check if a website or app follows best design practices to be easy and pleasant to use. It finds common issues and gives tips on how to fix them.
When to use it
- ✓When creating a new app design.
- ✓When reviewing an existing website.
- ✓To ensure an AI system is user-friendly.
Example of what to ask your AI
“Check this screen layout for usability issues.”
Want more? Open the sections below.
How to use
The easiest way: copy the message below and paste it into Claude, ChatGPT, Cursor or any AI. It reads the skill and follows the instructions.
Skill link
Ready-to-paste message
How it works
You describe the interface you want to evaluate. The tool compares it against research-based design rules and points out what can be improved, explaining the problem and how to fix it.
Installation
Easiest way: copy the skill link and paste it into Claude, ChatGPT or Cursor asking it to follow the instructions.
In the terminal (Claude Code, Codex, Cursor), in your project folder:
npx skills add sickn33/agentic-awesome-skills --skill uxui-principlesOr download just the file:
curl -L https://raw.githubusercontent.com/sickn33/agentic-awesome-skills/main/plugins/agentic-awesome-skills-claude/skills/uxui-principles/SKILL.md -o SKILL.mdTechnical content (original SKILL.md)
Original text by the author, straight from GitHub.
UX/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.
FAQ
What are 'UX/UI principles'?
These are research-backed rules and best practices that help create interfaces that are easy, efficient, and enjoyable for users.
What are 'antipattens'?
These are design solutions that seem good but actually cause problems for the user, leading to a frustrating experience.
Do I need to be a design expert to use this?
No, the tool is designed to help anyone identify design problems, even without deep technical knowledge.
Details
Original description by the author
Evaluate interfaces against 168 research-backed UX/UI principles, detect antipatterns, and inject UX context into AI coding sessions.
Popularity
- GitHub stars
- 48k
- Ranking position
- #4477
- License
- MIT
- Updated
- 10/15/2026
Comments
- …
More skills from this repository
00-andruia-consultant
Helps your agent start or improve AI projects. It analyzes code, suggests tools, and creates action plans in Spanish.
sickn33/agentic-awesome-skills
007
Lets your agent perform security audits and threat modeling. It's useful for protecting projects against attacks and vulnerabilities.
sickn33/agentic-awesome-skills
10-andruia-skill-smith
Helps your agent create or improve AI tools. It defines how tools work, writes documentation, and validates the structure.
sickn33/agentic-awesome-skills
20-andruia-niche-intelligence
Lets your agent create a summary about a specific industry. It's useful for understanding the context, rules, usage patterns, and risks of a project, using reliable sources.
sickn33/agentic-awesome-skills
Similar skills
accessibility
Helps your agent create interfaces that everyone can use. Ensures websites and apps work well for people with disabilities, like those who are blind or have reduced mobility.
affaan-m/ECC
design-system
Helps your agent create a design system from existing code. It extracts visual information and checks for consistency, generating a report and an interactive preview.
affaan-m/ECC
liquid-glass-design
Helps your agent create iOS user interfaces with a 'Liquid Glass' effect. Allows adding dynamic and interactive visual effects in SwiftUI and UIKit.
affaan-m/ECC