From c5e2a31b1d411caf1e8d117b7a370d176434f1e9 Mon Sep 17 00:00:00 2001 From: UX UI Principles Date: Fri, 3 Apr 2026 07:14:33 +0200 Subject: [PATCH] feat: add uxui-principles skill from uxuiprinciples/agent-skills --- skills/uxui-principles/SKILL.md | 82 +++++++++++++++++++++++++++++++++ 1 file changed, 82 insertions(+) create mode 100644 skills/uxui-principles/SKILL.md diff --git a/skills/uxui-principles/SKILL.md b/skills/uxui-principles/SKILL.md new file mode 100644 index 000000000..b8b79c926 --- /dev/null +++ b/skills/uxui-principles/SKILL.md @@ -0,0 +1,82 @@ +--- +name: uxui-principles +description: 'Evaluate interfaces against 168 research-backed UX/UI principles and detect UX antipatterns. Use this skill when: (1) Auditing an interface design for UX issues, (2) Checking if a UI follows research-backed best practices, (3) Detecting antipatterns and UX smells in existing designs, (4) Reviewing AI-powered interfaces for trust, transparency, and human override, (5) Checking user flows against decision and feedback principles, (6) Injecting UX context into a coding session before implementation. Triggers: "audit this interface", "check UX", "evaluate design", "find antipatterns", "UX review", "does this follow UX principles", "review my UI", "check this flow", "vibe coding UX".' +--- + +# UX/UI Principles + +A collection of 5 agent skills backed by 168 research-based UX/UI principles and 2,098+ academic citations. Evaluate interfaces, detect antipatterns, and inject UX expertise into your AI-assisted workflow. + +**Repository:** https://github.com/uxuiprinciples/agent-skills + +## Install + +```bash +npx skills add uxuiprinciples/agent-skills +``` + +## Skills in This Collection + +### uxui-evaluator + +Evaluate interface descriptions against 168 research-backed UX/UI principles. Returns structured findings with severity, matched principles, and remediation steps. + +**Use when:** You want a comprehensive UX audit of a screen, component, or interaction pattern. + +### interface-auditor + +Detect UX antipatterns (smells) using the uxuiprinciples smell taxonomy. Returns matched symptoms, severity levels, and step-by-step remediation recipes. + +**Use when:** Something feels wrong with a design but you need to pinpoint the specific antipattern. + +### ai-interface-reviewer + +Audit AI-powered interfaces against 44 principles covering transparency, trust calibration, human override, consent, agentic workflows, and conversational design. + +**Use when:** Reviewing a chatbot, AI assistant, copilot feature, or any interface with AI-generated output. + +### flow-checker + +Check user flows against decision, error recovery, and feedback principles. Identifies drop-off risks and missing states. + +**Use when:** Designing or reviewing a multi-step flow such as onboarding, checkout, or form submission. + +### vibe-coding-advisor + +Inject UX context into vibe coding sessions. Reviews planned implementation against UX principles before code is written. + +**Use when:** Starting a new component or feature and you want UX guidance baked in from the start. + +## How It Works + +1. Add the skill collection to your agent +2. Describe the interface, screen, or flow you want to evaluate +3. The skill returns structured findings: severity level, principle violated, and remediation steps +4. API key optional: connect to uxuiprinciples.com for enriched output with full citations and detailed remediation recipes + +## Example Usage + +``` +Evaluate this checkout flow against UX principles: +- Step 1: Cart summary with item list and total +- Step 2: Email entry (no guest checkout option) +- Step 3: Payment form (card only) +- Step 4: Confirmation page +``` + +The skill returns findings like: +- **High severity:** No guest checkout violates Principle #47 (Minimize Friction at Critical Moments) +- **Medium severity:** Single payment method violates Principle #89 (Provide Alternatives) +- **Low severity:** Missing order edit option on confirmation page + +## Principles Coverage + +| Category | Principles | +|----------|-----------| +| Visual Hierarchy & Layout | 1-24 | +| Navigation & Wayfinding | 25-48 | +| Forms & Input | 49-72 | +| Feedback & System Status | 73-96 | +| Error Handling | 97-120 | +| Trust & Credibility | 121-144 | +| AI Interface Patterns | 145-168 |