ux-ui-mastery — Claude Code skill: what it does, how to install
ux-ui-mastery — a router skill for UX/UI: it checks whether the Sumi package is already installed and, when it is not, pulls in its 45 topic skills, from Nielsen heuristics to motion design.
MIT 210 installs ★ 35 updated 2026-10-21
npx skills add podo/design-agent-skills --skill ux-ui-mastery -a claude-codeWhat ux-ui-mastery does
The skill is a thin pointer. It carries no design knowledge itself; it points at phazurlabs/sumi, the repo once named phazurlabs/ux-ui-mastery. On first use it looks for sumi-orchestrator under ~/.agents/skills/ or the project's .agents/skills/ and checks its SKILL.md for a das: block. Present and clean means the request goes straight to the orchestrator. Otherwise the package gets installed.
Scope comes from the presence of ~/.agents/skills/ux-ui-mastery: with the directory there it installs globally, without it into the project. The command is npx skills add phazurlabs/sumi --skill followed by 45 skill names, plus -g for the global run. Claude users have a second route: /plugin marketplace add phazurlabs/sumi, then /plugin install sumi. That route also brings the /sumi: commands (start at /sumi:start) and a crew of four agents.
Reference capture through /sumi:inspo runs against a local Chrome, with puppeteer-core installed in the project (npm i -D puppeteer-core). Mobbin references need a Mobbin account and its MCP server. Both have to be in place before the capture step can run.
What it helps with
- Check whether Sumi is already on disk before installing it again
- Pull 45 design skills with a single command
- Rate usability findings against Nielsen's heuristics
- Check a screen against WCAG 2.2
- Set up design tokens the W3C way
Example prompts for the agent
- See if the Sumi skill set is installed and pull it in if it isn't
- Audit the signup flow with Nielsen's heuristics and rate each issue by severity
- Take the ambient UI patterns for iOS 26 and apply them to the settings screen
How to install ux-ui-mastery
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill ux-ui-mastery -a claude-code2Manually: put the files in place
~/.claude/skills/ux-ui-mastery/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/ux-ui-mastery/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill ux-ui-mastery -a codex2Manually: put the files in place
.agents/skills/ux-ui-mastery/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill ux-ui-mastery -a cursor2Manually: put the files in place
.cursor/skills/ux-ui-mastery/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install podo/design-agent-skills skills/ux-ui-mastery2Manually: put the files in place
.github/skills/ux-ui-mastery/SKILL.md1Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill ux-ui-mastery -a gemini-cli2Platform CLI
gemini skills install https://github.com/podo/design-agent-skills --path skills/ux-ui-masteryManually: put the files in place
.devin/skills/ux-ui-mastery/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add podo/design-agent-skills --skill ux-ui-mastery -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-ui-mastery
How do I install ux-ui-mastery in Claude Code?
Run npx skills add podo/design-agent-skills --skill ux-ui-mastery -a claude-code. The skill lands at ~/.claude/skills/ux-ui-mastery/SKILL.md.
What does ux-ui-mastery do?
It routes UX/UI requests: it checks for sumi-orchestrator and, if that is missing, installs the Sumi package with its 45 topic skills.
What do I need for reference capture?
A local Chrome plus puppeteer-core in the project for /sumi:inspo, and a Mobbin account with its MCP server for Mobbin references.
Source text
SKILL.md · MIT
--- name: ux-ui-mastery description: | Sumi (formerly ux-ui-mastery), a UX/UI design-intelligence skill suite from Phazur Labs: a router skill plus deep skills for cognitive psychology UX, Nielsen Norman Group heuristics, UX research methods, interaction and motion design, accessibility and inclusive design, mobile and desktop UX, cross-cultural i18n UX, agentic AI and generative UX, ambient/zero UI, spatial and voice UX, design systems and tokens, component code, and reference-grounded visual design. triggers: - "ux mastery" - "phazurlabs" - "UX ui mastery" - "Sumi design crew" - "iOS 26 UX" - "ambient UI" das: type: package category: design-review upstream: "https://github.com/phazurlabs/sumi" version: latest install: false --- # ux-ui-mastery > Catalogue stub — full package: [phazurlabs/sumi](https://github.com/phazurlabs/sumi) (the repo was renamed from `phazurlabs/ux-ui-mastery`) <!-- das:install:start — generated from stub.yaml by `npm run generate`; edit stub.yaml, not this block --> ## Decision tree 1. **Is the full skill already installed?** This package installs 45 skills (`sumi-orchestrator`, `accessibility-inclusive-design`, `agentic-ai-generative-ux`, `ai-design-generation`, `ai-spatial-voice-ux`, `ambient-calm-zero-ui`, `animation-recipe-library`, `business-design-templates`, `cognitive-psychology-ux`, `color-palette-library`, `component-patterns-code`, `conversion-optimization-patterns`, `cross-cultural-i18n-ux`, `data-visualization-mastery`, `design-critique-case-studies`, `design-memory`, `design-process-methods`, `design-systems-architecture`, `design-token-presets`, `desktop-app-design`, `figma-design-tool-workflows`, `form-design-encyclopedia`, `icon-illustration-systems`, `image-media-patterns`, `interaction-motion-design`, `layout-block-intelligence`, `micro-copy-intelligence`, `mobile-ux-design`, `navigation-pattern-encyclopedia`, `nng-ux-heuristics`, `page-composition-engine`, `performance-states-patterns`, `platform-visual-standards`, `reference-intelligence`, `responsive-block-patterns`, `screen-flow-patterns`, `sector-style-intelligence`, `shadow-elevation-density`, `typography-pairing-recipes`, `ui-pattern-intelligence`, `ui-visual-design-system`, `ux-ethics-content-strategy`, `ux-metrics-measurement`, `ux-research-methods`, `visual-design-mastery`); checking the first. - Global: `f=~/.agents/skills/sumi-orchestrator/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - Project: `f=.agents/skills/sumi-orchestrator/SKILL.md; [ -f "$f" ] && ! grep -q "^das:" "$f" && echo "installed" || echo "pointer"` - `installed` → the skill is installed as `sumi-orchestrator`, invoke it and proceed - `pointer` → go to step 2 2. **Detect scope, then install:** ```bash [ -e ~/.agents/skills/ux-ui-mastery ] && echo "global" || echo "project" ``` **Global:** ```bash npx skills add phazurlabs/sumi --skill sumi-orchestrator accessibility-inclusive-design agentic-ai-generative-ux ai-design-generation ai-spatial-voice-ux ambient-calm-zero-ui animation-recipe-library business-design-templates cognitive-psychology-ux color-palette-library component-patterns-code conversion-optimization-patterns cross-cultural-i18n-ux data-visualization-mastery design-critique-case-studies design-memory design-process-methods design-systems-architecture design-token-presets desktop-app-design figma-design-tool-workflows form-design-encyclopedia icon-illustration-systems image-media-patterns interaction-motion-design layout-block-intelligence micro-copy-intelligence mobile-ux-design navigation-pattern-encyclopedia nng-ux-heuristics page-composition-engine performance-states-patterns platform-visual-standards reference-intelligence responsive-block-patterns screen-flow-patterns sector-style-intelligence shadow-elevation-density typography-pairing-recipes ui-pattern-intelligence ui-visual-design-system ux-ethics-content-strategy ux-metrics-measurement ux-research-methods visual-design-mastery -g -y ``` **Project:** ```bash npx skills add phazurlabs/sumi --skill sumi-orchestrator accessibility-inclusive-design agentic-ai-generative-ux ai-design-generation ai-spatial-voice-ux ambient-calm-zero-ui animation-recipe-library business-design-templates cognitive-psychology-ux color-palette-library component-patterns-code conversion-optimization-patterns cross-cultural-i18n-ux data-visualization-mastery design-critique-case-studies design-memory design-process-methods design-systems-architecture design-token-presets desktop-app-design figma-design-tool-workflows form-design-encyclopedia icon-illustration-systems image-media-patterns interaction-motion-design layout-block-intelligence micro-copy-intelligence mobile-ux-design navigation-pattern-encyclopedia nng-ux-heuristics page-composition-engine performance-states-patterns platform-visual-standards reference-intelligence responsive-block-patterns screen-flow-patterns sector-style-intelligence shadow-elevation-density typography-pairing-recipes ui-pattern-intelligence ui-visual-design-system ux-ethics-content-strategy ux-metrics-measurement ux-research-methods visual-design-mastery -y ``` > **Claude Code:** send a command as a chat message starting with `!` to run it without leaving the conversation. **Claude Code plugin route:** ``` /plugin marketplace add phazurlabs/sumi /plugin install sumi ``` **Heads-up** - **Requires:** for the plugin's /sumi:inspo reference capture - a local Chrome and puppeteer-core in your project (npm i -D puppeteer-core); for Mobbin references - a Mobbin account and its MCP server - **License:** Apache-2.0 <!-- das:install:end --> ## Invoke after install - Start with `sumi-orchestrator`: it routes any UX/UI request (audit, fix, create, implement, systematize, measure) to the right skills in order - Depth skills it routes to are named for their topic, for example `cognitive-psychology-ux`, `nng-ux-heuristics`, `accessibility-inclusive-design`, `ux-research-methods`, `interaction-motion-design`, `mobile-ux-design`, `agentic-ai-generative-ux`, `ui-visual-design-system` and `component-patterns-code` - With the Claude Code plugin route you also get the `/sumi:` commands (start with `/sumi:start`) and a crew of four agents. If `/plugin install sumi` is ambiguous, use the full form `/plugin install sumi@sumi-marketplace` Trigger phrases: "ux mastery", "phazurlabs", "UX ui mastery", "Sumi design crew", "iOS 26 UX", "ambient UI" ## What it does A large UX/UI knowledge suite for Claude Code. The router skill, `sumi-orchestrator`, maps a request to a pipeline with stage gates, and the other skills are the depth libraries it pulls in: cognitive psychology and Laws of UX, NN/g heuristics with severity ratings, UX research methods, WCAG 2.2 accessibility, interaction and motion, mobile, desktop, cross-cultural, agentic-AI, ambient and spatial/voice UX, design systems and W3C tokens, production component code, microcopy, layout blocks, palettes, typography pairings, and platform standards such as iOS 26 Liquid Glass and Material 3 Expressive. The plugin adds commands (`/sumi:audit`, `/sumi:fix`, `/sumi:inspo` and more) and agents that source current Awwwards and Mobbin references and grade your build against them. The skills CLI route installs the skills only, which adds many skill descriptions to your agent's context. The router names the skills it needs, so trim with `--skill` only if you keep the ones it routes to. ## When NOT to use - Quick design review — use `plan-design-review` for a lighter-weight pass - Single-domain needs where one focused skill suffices (for example `wcag-ai-skill` for accessibility only, or `interaction-design` for interaction states)
© podo · MIT · podo/design-agent-skills