Best for
- what user problem matters and for whom
- whether a concept, flow, or prototype is understandable and usable
- which research method is appropriate
vasilyu1983/AI-Agents-public/frameworks/shared-skills/skills/software-ux-research/SKILL.md
Guides user research methods and research ops. Use when running interviews, usability tests, surveys, or A/B tests to de-risk product decisions.
Decision brief
Use this skill to reduce product and design risk with evidence. It owns research method choice, study design, findings synthesis, and research operations. It does not own UI implementation.
Compatibility matrix
| Platform | Status | Evidence | What to check |
|---|---|---|---|
| Codex | Declared | Source record | Install path and trigger |
| Claude Code | Declared | Source record | Install path and trigger |
| Cursor | Not declared | No explicit evidence | Portability before use |
| Gemini CLI | Not declared | No explicit evidence | Portability before use |
Installation
The source command is displayed only when detected. A safe inspection prompt is always available so your agent can explain every action before execution.
npx skills add https://github.com/vasilyu1983/AI-Agents-public --skill "frameworks/shared-skills/skills/software-ux-research"Inspect the Agent Skill "software-ux-research" from https://github.com/vasilyu1983/AI-Agents-public/blob/53f6cb73ea53a2646e3e7d4665062ad66f3683ac/frameworks/shared-skills/skills/software-ux-research/SKILL.md at commit 53f6cb73ea53a2646e3e7d4665062ad66f3683ac. List every install step, command, network request, credential, file read/write, external action, and rollback step. Explain whether it fits my task. Do not install or execute anything until I approve.
Workflow
1. Define the decision and deadline. 2. Inventory existing evidence. 3. Choose the method and explain why weaker alternatives were rejected. 4. Produce one decision-ready output. 5. Tag confidence and data-handling constraints.
Review the “Stage Guidance” section in the pinned source before continuing.
Before delivering any research output:
Review the “Quick Reference” section in the pinned source before continuing.
Use this skill when the main question is:
Permission review
No configured static risk pattern was detected
This is not proof of safety. Runtime behavior, indirect dependencies, and hidden external systems are outside the static scan.
Evidence record
| Signal | Value | Evidence type | Meaning |
|---|---|---|---|
| Quality score | 95/100 | Computed | Documentation, specificity, maintenance, and trust rules |
| Repository stars | 80 | Source | Repository attention, not individual Skill quality |
| Compatibility | 2 platforms | Source | Declared in the catalog source record |
| Usage guide | automated source guide | Editorial | Generated or reviewed according to the visible evidence level |
Pinned source
Use this skill to reduce product and design risk with evidence. It owns research method choice, study design, findings synthesis, and research operations. It does not own UI implementation.
| Need | Default | Output |
|---|---|---|
| discovery and JTBD | semi-structured interviews with 5-8 participants | opportunity brief |
| usability evaluation | moderated usability test with 5-7 participants | findings report with severity |
| quantification after qual insight | survey or analytics review | segment or pattern readout |
| causal change validation | controlled experiment or staged rollout | experiment brief |
| research ops and repository design | lightweight intake, taxonomy, and consent model | research-ops recommendation |
| accessibility or low-digital-literacy research | moderated sessions with adapted materials | risk and inclusion report |
Use this skill when the main question is:
Route elsewhere when the main task is:
| Need | Use Instead |
|---|---|
| UI design and interaction patterns | ../software-ui-ux-design/SKILL.md |
| code-level accessibility remediation | ../software-accessibility/SKILL.md |
| accessibility testing automation and CI gates | ../qa-testing-accessibility/SKILL.md |
| analytics instrumentation implementation | marketing-product-analytics and ../qa-observability/SKILL.md |
Consumer-grade research looks past task completion to whether the experience is efficient, considerate, and worth coming back to. Evaluate every research question and finding through four layers — methods that only cover the top layer will miss why people churn or never habit-form. See references/consumer-experience-quality.md for methods, instruments, and recipes.
| Layer | Question | Primary Methods |
|---|---|---|
| Task | can users complete the job? | usability testing, task success, SEQ |
| Friction | what slows, frustrates, or shames them? | friction logging, diary studies, session replay paired with interview |
| Emotion | how does it feel — proud, calm, tense, ignored? | PrEmo, AttrakDiff, Microsoft Desirability Toolkit, micro-interviews |
| Meaning | does it earn a place in their life? does it cause harm? | JTBD Switch interviews, Continuous Discovery (OST), longitudinal/diary, retention cohorts |
A finding that names task pass-rate but not friction or emotion is incomplete. Discovery work without Meaning-layer questions tends to ship features people use once.
UX research task
-> Define decision, audience, deadline, and risk
-> Inventory existing evidence and data constraints
-> Choose smallest method mix that answers the decision
-> Run or design study with consent and evidence trail
-> Synthesize findings with confidence level
-> Deliver options, tradeoffs, and next decision
Default outputs:
Every substantial output should include:
| Need | Primary Methods |
|---|---|
| motives, needs, switching triggers | interviews, contextual inquiry, diary studies |
| usability and learnability | moderated usability testing, cognitive walkthroughs, heuristic review |
| scale, segments, or behavioral patterns | analytics review, surveys, feedback mining |
| causal effect | controlled experiment, staged rollout, preference test |
Use moderated testing by default when failure paths, assistive technology, or complex workflows matter.
| Stage | Typical Research Focus |
|---|---|
| discovery | problem selection, JTBD, forces of progress |
| concept or MVP | concept comprehension, prototype usability, onboarding risk |
| launch | blocker identification, accessibility, and readiness |
| growth | retention, friction, and segment behavior |
| maturity | optimization, simplification, or feature retirement |
Before delivering any research output:
For AI-powered product research (the thing being studied is AI-driven):
For AI in the research workflow (synthesis tools, AI moderators, synthetic users):
For accessibility-sensitive research:
why questions that need observed behavior or interviews.References
Assets
marketing-product-analyticsBefore applying this skill on a non-trivial task, read learnings.consolidated.md in this directory (and learnings.md if present).
After applying it, if you encountered a pattern worth remembering, a mistake worth preventing, or a domain fact that surprised you, append one dated bullet to learnings.md via agents-skills-feedback-loop/scripts/append_learning.py. Do not modify SKILL.md itself.
Frequently asked questions
Use this skill to reduce product and design risk with evidence. It owns research method choice, study design, findings synthesis, and research operations. It does not own UI implementation.
The source record exposes this install command: npx skills add https://github.com/vasilyu1983/AI-Agents-public --skill "frameworks/shared-skills/skills/software-ux-research". Inspect the command and pinned source before running it.
The pinned source record declares support for: codex, claude code.
Alternatives
upex-galaxy/agentic-qa-boilerplate
Analyze, prioritize, and document test cases in TMS (Jira/Xray), or repair an existing Story-ATS-ATP-ATR-TC cascade through a sealed explicit mode. Use for Test/ATP/ATR artifacts, ROI and automation verdicts, maintaining traceability, fix-traceability, or broken TMS links. The repair-traceability mode audits, plans, waits for explicit approval, applies, and verifies without launching the general documentation workflow. Do NOT use for writing test code (test-automation) or running suites (regress
upex-galaxy/agentic-qa-boilerplate
Orchestrates in-sprint manual QA per ticket across Stages 1 (Planning), 2 (Execution) and 3 (Reporting). Use for user-story testing, bug retesting, and batch-sprint QA loops. Creates the PBI folder, drives session-start, runs the triage + veto + risk-score decision tree on bugs, produces the ATP + ATR + TC artifacts in the TMS, executes smoke and trifuerza (UI/API/DB) exploration, and files the final QA comment + bug reports. Triggers on: test this ticket, QA this user story, retest this bug, ve
nyldn/claude-octopus
Multi-AI research using available external providers (Double Diamond Discover phase)
alirezarezvani/claude-skills
Helm chart development agent skill and plugin for Claude Code, Codex, Gemini CLI, Cursor, OpenClaw — chart scaffolding, values design, template patterns, dependency management, security hardening, and chart testing. Use when: user wants to create or improve Helm charts, design values.yaml files, implement template helpers, audit chart security (RBAC, network policies, pod security), manage subcharts, or run helm lint/test.