UX/UI Principles — Agent Skills

Five SKILL.md files that inject UX expertise into AI agents. Works with Cursor, Windsurf, kx, Claude Code, and any framework that reads SKILL.md.

Each skill runs on LLM inference alone. Add a UXUI_API_KEY to unlock enriched output: principle codes, 2,300+ academic citations, severity from the taxonomy, and remediation recipes.

Get an API key: uxuiprinciples.com/en/checkout

Skills

Installation

Copy the SKILL.md file for the skill you want into your project root (or wherever your agent framework reads skills from).

# Example: add uxui-evaluator to your project
curl -O https://raw.githubusercontent.com/uxuiprinciples/agent-skills/main/uxui-evaluator/SKILL.md

With API Key (enriched output)

Set UXUI_API_KEY in your environment:

export UXUI_API_KEY=uxui_live_...

Or in your agent config:

[env]
UXUI_API_KEY = "uxui_live_..."

What the API Key Unlocks

Without a key, each skill evaluates using LLM inference and returns generic findings.

With a key (pro tier), the toolbox calls return:

• Principle codes (F.1.1.02, S.1.3.01, etc.) from the full 195-principle taxonomy
• aiSummary fields with concise, citation-backed descriptions
• businessImpact data from 2,300+ peer-reviewed sources
• vibeCodingPrompts for component-level implementation guidance
• UX smell remediation recipes with step-by-step fixes

Plans: uxuiprinciples.com/en/checkout. API Access from $19/yr.

Framework Structure

The skills reference the uxuiprinciples 6-part taxonomy:

License

Skills are free to use and distribute. API access for enriched output requires a paid plan.

uxuiprinciples.com