ux-principles — Claude Code skill: UX rules for your agent
Gives your coding agent usability heuristics, user research methods and accessibility checks, so interface work follows known rules instead of guesswork.
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a claude-codeWhat ux-principles does
The skill hands the agent a reference set: the four principles of user-centered design, the five stages of design thinking, and Nielsen's ten usability heuristics with notes on each. Ask it to rework a form or review a screen and it argues from those definitions rather than improvising.
Inside are written sections with principles and examples — visibility of system status, match with the real world, user control and freedom, consistency, error prevention, recognition over recall. Flexibility, aesthetics, error recovery and documentation follow. The material stops partway through the seventh heuristic.
Worth installing if you build interfaces and want the agent to cite specific principles. On a purely backend task it just adds context weight, so check the work is actually about user experience first.
What it helps with
- review a screen against usability heuristics
- plan user research for a new feature
- spot accessibility barriers in a form
- write personas and a user journey map
- cut friction from a checkout flow
Example prompts for the agent
- run this screen through Nielsen's heuristics and list what breaks
- help me plan a usability test for the signup form
- check our checkout for accessibility issues and suggest fixes
How to install ux-principles
1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a claude-code2Manually: put the files in place
~/.claude/skills/ux-principles/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ux-principles/
1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a codex2Manually: put the files in place
.agents/skills/ux-principles/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a cursor2Manually: put the files in place
.cursor/skills/ux-principles/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install manutej/luxor-claude-marketplace ux-principles2Manually: put the files in place
.github/skills/ux-principles/SKILL.md1Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a gemini-cli2Platform CLI
gemini skills install https://github.com/manutej/luxor-claude-marketplace --path plugins/luxor-design-toolkit/skills/ux-principlesManually: put the files in place
.devin/skills/ux-principles/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add manutej/luxor-claude-marketplace --skill ux-principles -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 ux-principles
How do I install ux-principles in Claude?
Run npx skills add manutej/luxor-claude-marketplace --skill ux-principles -a claude-code. The skill file lands at ~/.claude/skills/ux-principles/SKILL.md.
What does ux-principles do?
It gives the agent a UX reference: user-centered design principles, design thinking stages and usability heuristics with examples. The agent applies them when you ask it to review or rework an interface.
Which platforms does the skill support?
Besides Claude there are installs for Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode. GitHub Copilot uses a different command: gh skill install manutej/luxor-claude-marketplace ux-principles.
