ux-research
Skill3 starsChanged 10 days agoMITView on GitHub
Activate this skill for user discovery, usability heuristics, cognitive load reduction, UX copywriting, or user interface audit workflows. Use when evaluating design decisions, refining user journeys, or improving usability.
We split this skill into the rules it gives an agent
6 rules. 0 are common, 6 are distinctive, and 0 are very specific to this project.
0
Common
Most of the 11 edited versions we read keep these.
6
Distinctive
This author's own choices. Worth a look.
0
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 28
Every user interface audit must evaluate against the foundational usability heuristics:
- Distinctive: line 30
Visibility of System Status: Keep users informed about what is happening through timely, appropriate visual feedback (e.g., progress …
- Distinctive: line 31
Match Between System and Real World: Use words, phrases, and concepts familiar to the user, not internal system jargon or database enum …
- Distinctive: line 51
Use clear whitespace rhythm and typographic scale to guide the eye naturally through content: Title → Summary → Detail → Action.
- Distinctive: line 62
Never blame the user or display raw system errors.
- Distinctive: line 68
Use specific, verb-first action labels rather than generic "OK" or "Submit":
“Common” is measured: kept by at least 6 in 10 of the 11 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
UX Research & Usability Engineering
Scope: Jakob Nielsen's 10 usability heuristics, cognitive load reduction, UX copywriting, accessible design verification, user interview synthesis, and evidence-based design decisions.
When to Activate
- Conducting usability audits on existing applications or prototypes
- Writing or revising UX microcopy, error states, and empty screens
- Simplifying complex user workflows and reducing cognitive friction
- Planning user testing sessions or synthesizing feedback
- Evaluating accessibility and usability compliance (WCAG & heuristics)
- Reviewing forms, onboarding flows, and navigation architectures
1. Usability Heuristics (Nielsen Norman Group)
Every user interface audit must evaluate against the foundational usability heuristics:
- Visibility of System Status: Keep users informed about what is happening through timely, appropriate visual feedback (e.g., progress indicators, upload progress bars, saving badges).
- Match Between System and Real World: Use words, phrases, and concepts familiar to the user, not internal system jargon or database enum names.
- User Control and Freedom: Provide clear "emergency exits" — undo actions, cancel buttons, and effortless navigation back from accidental steps.
- Consistency and Standards: Users should not have to wonder whether different words, buttons, or icons mean the same thing. Follow platform conventions.
- Error Prevention: Eliminate error-prone conditions or check for them and present users with a confirmation option before they commit to destructive actions.
- Recognition Rather than Recall: Minimize user memory load by making objects, actions, and options visible. Don't force users to remember information from one step to the next.
- Flexibility and Efficiency of Use: Provide accelerators (keyboard shortcuts, bulk actions) for experienced users while keeping the interface clear for novices.
- Aesthetic and Minimalist Design: Dialogues should not contain irrelevant or rarely needed information. Every extra unit of information competes with the relevant units.
- Help Users Recognize, Diagnose, and Recover from Errors: Error messages must be expressed in plain language, indicate the problem precisely, and constructively suggest a solution.
- Help and Documentation: Even though it is better if the system can be used without documentation, help should be easy to search, focused on user tasks, and concrete.
2. Cognitive Load Reduction
Progressive Disclosure
- Present only the primary, essential choices upfront.
- Hide secondary, advanced options under accordion drawers, expandable filters, or modal steps ("Show advanced options").
Chunking & Visual Hierarchy
- Break long forms into logically grouped sections or multi-step wizards with explicit progress indicators.
- Use clear whitespace rhythm and typographic scale to guide the eye naturally through content: Title → Summary → Detail → Action.
Smart Defaults & Safe Affordances
- Pre-fill fields whenever predictable (e.g., user's timezone, country, or default billing address).
- Disable primary action buttons only when required inputs are missing, and always provide contextual tooltips explaining why an action is currently disabled.
3. UX Copywriting Principles
Error Messages
Never blame the user or display raw system errors. Follow the Problem + Reason + Next Step formula:
- ❌
Error 500: Internal server null pointer exception - ❌
You entered an invalid date format! - ✅
We couldn't save your changes. Your connection appears offline. Please check your network and try again.
Action Buttons
Use specific, verb-first action labels rather than generic "OK" or "Submit":
- ❌
Submit/OK - ✅
Create workspace/Save billing address/Delete project permanently
Empty States
An empty state is an onboarding opportunity. Never leave an empty table or list blank:
- Explain what belongs here.
- Explain why it is currently empty.
- Provide a clear primary action button to create the first item.
4. Verification & Usability Gate Checklist
- Every destructive action (delete, downgrade, revoke access) requires explicit confirmation or offers immediate undo.
- Error messages describe the exact issue in plain language and offer a concrete resolution step.
- Forms provide inline validation and clear labels (never rely solely on placeholder text).
- Loading and empty states exist for every dynamic list and dashboard view.
- Interactive controls have visible focus rings and meet minimum touch target sizes (44x44 CSS pixels).
Other versions13 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 13
- nodetool-ai/nodetool★ 603same name
- cuellarfr/design-skills★ 94same name
- felvieira/claude-skills-fv★ 27same name
- justinqwerty/design-skills★ 9same name
- Gustavosilveira23/claude-design-skills★ 8same name
- pedroromeroluna/ai-first-product-skills★ 5same name
- bedomax/webdesigner-agent★ 1same name
- KMaruthi2002/universal-llm-skills★ 1same name
- redhoram/claude-landing-template★ 1same name
- ZeroTokenClaw/agents-skills★ 1same name
3 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
Used alongsideProjects with it also use seo.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
nilssonrSkillseo
Full SEO workflow for auditing pages and creating SEO-optimized content. Provides checklists with educational explanations aligned with Google Search Central documentation.
Also in 3 projects that use this
In this repository50 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .cursor/rules/always-on.mdcCursor rule
- 3d-visualsSkill
- agent-researchSkill
- api-architectureSkill
- assets-mediaSkill
- cavemanSkill
- cloudflare-expertSkill
- devops-cicdSkill
- firebase-expertSkill
- git-collaborationSkill
- gravitasSkill
- gsd-coreSkill
- llm-optimizationSkill
- mobile-engineeringSkill
- ponytailSkill
- postgres-ecosystemSkill
- security-auditorSkill
- sentry-expertSkill
- seo-marketingSkill
- state-managementSkill
- testing-qaSkill
- ui-ux-pro-maxSkill
- ux-researchSkill
- web-animationSkill
- web-gamedevSkill
- 3d-visualsSkill
- agent-researchSkill
- api-architectureSkill
- assets-mediaSkill
- cavemanSkill
- cloudflare-expertSkill
- devops-cicdSkill
- firebase-expertSkill
- git-collaborationSkill
- gravitasSkill
- gsd-coreSkill
- llm-optimizationSkill
- mobile-engineeringSkill
- ponytailSkill
- postgres-ecosystemSkill
- security-auditorSkill
- sentry-expertSkill
- seo-marketingSkill
- state-managementSkill
- testing-qaSkill
- ui-ux-pro-maxSkill
- web-animationSkill
- web-gamedevSkill
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
Reviews can't be read right now.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

