Interface Auditor

Detect UX antipatterns (smells) in interface descriptions using the uxuiprinciples smell taxonomy. Returns structured findings with matched symptoms, severity, and step-by-step remediation recipes. API key optional — full remediation recipes require uxuiprinciples.com API Access.

32 stars 4 forksSoftware Development

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add uxuiprinciples/agent-skills --skill interface-auditor
Manual install
git clone --depth 1 https://github.com/uxuiprinciples/agent-skills.git /tmp/agent-skills
mkdir -p ~/.claude/skills
cp -r /tmp/agent-skills/interface-auditor ~/.claude/skills/interface-auditor

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

```toml
[toolbox.list_smells]
description = "List all UX smells for a category. Valid categories: efficiency, error-prevention, feedback, learnability, accessibility, consistency. Returns smell IDs, names, symptoms, and remediation recipe titles."
command = "curl"
args = ["-s", "-H", "Authorization: Bearer ${UXUI_API_KEY}", "https://uxuiprinciples.com/api/v1/smells?category={category}"]

[toolbox.lookup_smell]
description = "Fetch a specific UX smell by ID. Returns full data: symptoms, detection time, related principles, recipe steps, before/after examples, and AI prompts."
command = "curl"
args = ["-s", "-H", "Authorization: Bearer ${UXUI_API_KEY}", "https://uxuiprinciples.com/api/v1/smells?id={smell_id}"]
```

## What This Skill Does

You audit interface descriptions for UX smells: named antipatterns that signal design problems before user testing. Each smell has a canonical set of symptoms, a detection approach, and a remediation recipe with numbered steps.

You match symptoms from the interface description to the smell taxonomy, then return structured JSON. When `UXUI_API_KEY` is set, you call the toolbox to retrieve full recipe steps, time estimates, and related principle codes. Without a key, you apply the taxonomy from internal knowledge and note the limitation.

The output is always JSON. No prose audit reports.

## Smell Taxonomy

The taxonomy covers 8 smells across 6 categories. Each smell maps to one or more Nielsen heuristics and related uxuiprinciples codes.
Read the full skill on GitHub

Details

Skill name
interface-auditor
Path
interface-auditor/SKILL.md
Repo updated
13 November 2026

FAQ

What does the Interface Auditor skill do?

Detect UX antipatterns (smells) in interface descriptions using the uxuiprinciples smell taxonomy. Returns structured findings with matched symptoms, severity, and step-by-step remediation recipes. API key optional — full remediation recipes require uxuiprinciples.com API Access.

How do I install the Interface Auditor skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add uxuiprinciples/agent-skills --skill interface-auditor. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Interface Auditor popular?

It lives in uxuiprinciples/agent-skills, which has 32 GitHub stars and 4 forks, and is included in 1 curated skill list.

Related skills

AI Interface Reviewer

32

uxuiprinciples/agent-skills

Audit AI-powered interfaces against the uxuiprinciples Part V taxonomy — 44 principles covering transparency, trust calibration, human override, consent, agentic workflows, and conversational design. Returns structured findings with severity and remediation. API key optional — enriched output requires uxuiprinciples.com API Access.

AI, LLMs & AgentsIn 1 list

Flow Checker

32

uxuiprinciples/agent-skills

Run preflight and postflight checklists against UX flows before you design and before you ship. Covers onboarding, forms, pricing, dashboards, and empty states. Returns structured findings with severity and smell linkage. Requires uxuiprinciples.com API Access (pro tier).

Frontend & DesignIn 1 list

Uxui Evaluator

32

uxuiprinciples/agent-skills

Evaluate interface descriptions against 195 research-backed UX/UI principles. Returns structured findings with severity, remediation, and business impact. API key optional — enriched output requires uxuiprinciples.com API Access.

Frontend & DesignIn 1 list

Siwa Circle

43

builders-garden/siwa

Circle developer-controlled wallet integration for SIWA authentication.

Software Development12

Golang Backend

47

mujez/claude-skills

Expert Go backend engineer skill. Use when writing Go services, APIs, microservices, CLI tools, or libraries. Covers architecture, concurrency, testing, database patterns, gRPC, REST APIs, error handling, and Go best practices.

Software Development

Siwa Openfort

43

builders-garden/siwa

Openfort backend wallet integration for SIWA authentication.

Software Development12

Browse the most popular Claude skills, all software development skills, or write your own with the skills generator.