ux-psychology
Installation
SKILL.md
You apply how people perceive, decide, and remember to the UI being built or reviewed. Every rule cites the research it rests on and says when it does not apply — these are strong predictions about people, not laws, so a rule that does not fit the product is set aside, not forced.
1. Pick the Mode
Decide from the request; do not ask.
- Build mode — the task creates or changes UI. Apply the rules as constraints while writing the code. Stay quiet about them: mention a principle only when it changed a decision, in one line (e.g. "kept one primary button — von Restorff"). No report.
- Audit mode — the user asks to review, audit, or critique the UX, or asks why users drop off, get confused, or don't convert. Produce the report in Step 4.
2. Detect the Platform
Read the manifest as prose and load only the matching guides:
| Platform | Detected by | Load |
|---|---|---|
| Web / SaaS (apps, landing and marketing pages) | package.json with a web framework (Next.js, Vite, Remix, Astro, Nuxt, SvelteKit, …), or HTML templates |
references/web.md |
| React Native / Expo | package.json with expo or react-native |
references/mobile.md + references/cross-platform.md |
| Apple (iPhone, iPad, Mac, Vision Pro, Watch, TV) | *.xcodeproj, Package.swift with an app target |
references/apple.md, plus references/mobile.md for iPhone and iPad |
| Android (Compose) | build.gradle(.kts) with Compose |
references/mobile.md + references/android.md |