ai-interface-reviewer — Claude Code skill: AI interface audits
This skill reviews AI-powered interfaces against a 44-principle taxonomy and returns structured findings with severity and remediation. Use it to assess chat, copilot features, or agent workflows.
npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a claude-codeWhat ai-interface-reviewer does
The skill checks AI interfaces against principles concerning transparency, trust, human control, consent, and conversational design. Its review produces structured findings, rates their severity, and suggests remediation. It applies to chat interfaces, voice assistants, and products where AI can take autonomous actions.
An API key is optional. Enriched results require API Access from uxuiprinciples.com and the UXUI_API_KEY variable. The skill includes curl calls to retrieve an individual Part V principle or list the principles. Without the key, enriched results are unavailable, so account for that when configuring the skill.
What it helps with
- check whether an interface communicates AI limitations
- find points where users cannot override an agent action
- review how a chatbot handles ambiguous requests
- assess whether users can correct AI output
- spot gaps in consent for AI data use
Example prompts for the agent
- Review this AI chat for clear limits and handling of ambiguous requests.
- Assess this agent workflow and flag actions users cannot override.
- Check whether copilot suggestions fit the interface context and can be dismissed.
How to install ai-interface-reviewer
1Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a claude-code2Manually: put the files in place
~/.claude/skills/ai-interface-reviewer/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ai-interface-reviewer/
1Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a codex2Manually: put the files in place
.agents/skills/ai-interface-reviewer/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a cursor2Manually: put the files in place
.cursor/skills/ai-interface-reviewer/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install uxuiprinciples/agent-skills ai-interface-reviewer2Manually: put the files in place
.github/skills/ai-interface-reviewer/SKILL.md1Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a gemini-cli2Platform CLI
gemini skills install https://github.com/uxuiprinciples/agent-skills --path ai-interface-reviewerManually: put the files in place
.devin/skills/ai-interface-reviewer/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about ai-interface-reviewer
How do I install ai-interface-reviewer in Claude Code?
Run npx skills add uxuiprinciples/agent-skills --skill ai-interface-reviewer -a claude-code. The skill file is at ~/.claude/skills/ai-interface-reviewer/SKILL.md.
What does ai-interface-reviewer do?
It audits AI-powered interfaces against a 44-principle taxonomy and returns structured findings with severity and remediation.
Does ai-interface-reviewer require an API key?
No key is needed for basic use. Enriched results require UXUI_API_KEY and API Access from uxuiprinciples.com.
