
software-ux-research
Guides user research and research ops. Use when running interviews, usability tests, surveys, or synthesis to de-risk product decisions; not experiments or review mining.
- Installs
- 210
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/vasilyu1983/ai-agents-public --skill software-ux-research- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads software-ux-research automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Software UX Research
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.
Quick Reference
| Need | Default | Output |
|---|---|---|
| discovery and JTBD | semi-structured interviews with a predeclared segment, saturation, and budget stop rule | opportunity brief |
| usability evaluation | moderated tests covering each critical task and user group; iterate in small rounds | 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 |
When to Use This Skill
Use this skill when the main question is:
- what user problem matters and for whom
- whether a concept, flow, or prototype is understandable and usable
- which research method is appropriate
- how to design a study and synthesize findings
- how to run research ops, repository, and consent workflows
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 |
| experiment design, instrumentation, and readout statistics | marketing-product-analytics; research-side decision in references/ab-testing-implementation.md |
| review, app-store, and complaint mining for pain points | research-review-mining |
| persona or synthetic-user browser testing of a built product | ../qa-persona-testing/SKILL.md |
| PMF surveys, idea validation, demand tests before a product exists | startup-idea-validation and ../product-management/SKILL.md |
| heuristic checklists, UI polish loops, and design-quality audits | ../software-ui-ux-design/SKILL.md |
Defaults
- start from the decision to unblock
- choose the smallest method mix that can answer the question
- use qual for motives and friction, quant for scale and segmentation
- treat synthetic participants as hypothesis generation only
- require confidence level and evidence trail in every output
- current standards and regulatory claims must be verified before final advice
Quality Lens
Choose the evidence layers the decision needs: task success and friction for a flow fix; emotion and meaning when studying trust, retention, or adoption. State which layers were studied and limit conclusions to them. Load references/consumer-experience-quality.md for the four-layer lens and its methods; task completion alone does not establish a retention benefit.
Workflow
- Define the decision and deadline.
- Inventory existing evidence.
- Choose the method and explain why weaker alternatives were rejected. For surveys, predeclare fraud, bot, duplicate, and speeder screening before distribution; use references/survey-design-guide.md#survey-integrity-fraud-bots-and-speeders.
- Produce one decision-ready output.
- Tag confidence and data-handling constraints.
Output Types
Default outputs:
- research plan
- study protocol
- findings report
- decision brief
Every substantial output should include:
- method justification
- confidence level
- evidence trail
- consent and data-handling note
- recommendation framed as options and tradeoffs
Method Chooser
| 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 analysis (review mining: research-review-mining) |
| causal effect | controlled experiment, staged rollout, preference test |
Use moderated testing by default when failure paths, assistive technology, or complex workflows matter.
Stage Guidance
| 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 |
Verification Checklist
Before delivering any research output:
- Decision the study was designed to unblock is named explicitly
- Method justified: weaker alternatives were considered and rejected with reasons
- Participants match the target segment — not convenience, panel-only, or CS rolodex
- Sample rationale names tasks, segments, risk, excluded populations, numeric stop threshold, consecutive evaluation window, maximum sample/budget, and action at the cap; experiments are power-calculated
- Confidence level and evidence trail stated in the output
- Synthetic participants labeled as hypothesis generation only — not cited as evidence
- AI-assisted analysis plan predeclares the tolerated disagreement by severity, audit-batch size, consecutive passing batches, maximum audit size, and the human-recoding/escalation action if the cap is reached
- Consent obtained; recordings, transcripts, and participant identity stored separately
- EU/UK participant data: DPA in place before sending to AI-processing vendor; check whether EU AI Act high-risk (Annex III) deployer obligations apply and take their current application dates from qualified EU regulatory counsel or the Official Journal text, not from memory
- Disconfirming evidence documented, not only confirming clips
- Agentic products: study ran multi-turn, exercised at least one interruption, and included seeded incorrect outputs if trust was measured
Research Ops Rules
- capture the decision, audience, segment, and evidence links in intake
- use one taxonomy across studies and atomic insights
- separate participant identity from notes and recordings
- redact broad-share artifacts
- let non-researchers run only templated studies with review guardrails
Prefer ISO, W3C, regulator, and primary-method sources over summaries.
AI and Accessibility Notes
For AI-powered product research (the thing being studied is AI-driven):
- test trust calibration, failure recovery, explainability, tool-use disclosure, and approval gating
- separate wrong output from unclear output and non-recoverable failure
- run multi-turn sessions for agentic products — single-turn studies miss most of the failure surface
- test steering explicitly: users change their mind mid-task, and addition/revision/retraction fail differently
- measure trust calibration against seeded incorrect outputs; an all-correct study cannot distinguish good judgment from blind acceptance
- see references/ai-in-research.md for the full dimension list and method mapping, and references/agentic-evaluation-methods.md for the multi-turn protocols
For AI in the research workflow (synthesis tools, AI moderators, synthetic users):
- treat synthetic users as hypothesis generation only (NN/g position), never as evidence
- start analysis from a human-coded seed sample, then let AI extend; audit every tag class plus low-confidence and random items against the predeclared disagreement rule
- AI moderators are appropriate only when the protocol is structured enough for a junior human to follow
- inventory every AI tool that processes participant data (vendor, data sent, DPA, AI Act classification — see the EU/UK checklist item above and references/ai-in-research.md#eu-ai-act)
Write qualitative stop rules (saturation threshold, window, cap, action at the cap) and AI-coding audit rules before recruitment: references/research-frameworks.md#reproducible-qualitative-stop-rules.
For accessibility-sensitive research:
- recruit assistive-technology users when accessibility is in scope
- distinguish accessibility usability findings from formal conformance findings
Known Traps
- Starting with a preferred method before naming the actual decision the study needs to unblock.
- Recruiting convenience participants whose context, literacy, or workflow is too far from the target segment.
- Treating generated summaries, AI note clustering, or synthetic participants as evidence instead of support material.
- Mixing discovery, usability, and causal-validation questions into one study and getting ambiguous output from all three.
- Reporting severity or confidence without tying it to sample quality, task coverage, and evidence strength.
- Storing recordings, transcripts, and participant identity with weaker controls than the sensitivity of the study requires.
- Sending EU/UK participant recordings to a non-EU AI vendor (Dovetail, Marvin, Looppanel, or any foundation-model-backed service) without a current DPA and explicit AI processing disclosure in consent — Chapter V GDPR transfer rules apply.
- Recruiting only from professional research panels (Prolific, UserTesting panel) for behavior studies, then generalising to product users — panel respondents are experienced participants whose behavior systematically diverges from first-time real users.
Common Anti-Patterns
Wrong method for the question (surveys for why, heuristic review for comprehension risk), n=5 read as representative, single-quote decisions, post-hoc segment hunting, stopping experiments at significance, and panel or CS-rolodex recruiting. Full list with mitigations: references/research-frameworks.md#research-practice-anti-patterns; AI and agentic-product anti-patterns: references/ai-in-research.md#anti-patterns.
Navigation
References
- references/usability-testing-guide.md
- references/survey-design-guide.md
- references/westrum-culture-measurement.md — worked example of a validated seven-item team-culture survey construct (Westrum typology, scoring, provenance limits); pairs with
foundations-team-theory - references/ux-audit-framework.md — expert review vs user research, cognitive walkthrough, evidence-tied severity model
- references/ux-metrics-framework.md
- references/research-repository-management.md
- references/ab-testing-implementation.md — experiment vs research decision, readout checks, maturity levels; experiment mechanics route to marketing-product-analytics
- references/non-technical-user-research.md
- references/ai-in-research.md
- references/agentic-evaluation-methods.md — evaluating multi-turn agentic products: interruption/steering testing, multi-turn first-person evaluation, trust calibration with seeded errors, agent-augmented heuristic evaluation
- references/consumer-experience-quality.md — Continuous Discovery, JTBD Switch, friction logging, emotion measurement, diary studies, competitive UX benchmarking, opportunity sizing, JTBD outcome statements, watch parties, embedding models
- references/ia-testing-guide.md — card sort (open/closed/hybrid), tree testing, first-click testing, 5-second testing
- references/evaluative-methods-guide.md — Wizard of Oz, concierge, painted-door, fake-door/smoke, conjoint, MaxDiff, Kano, beta panels
- references/consumer-recruiting-guide.md — sources, screeners, incentive ethics, kids/teens (COPPA, ICO Children's Code, GDPR Art. 8), Hawthorne, accessibility recruiting, churned-user recruiting
- references/research-frameworks.md — choosing a research method (discovery vs evaluative, method-selection matrix)
- references/customer-journey-mapping.md — journey maps, service blueprints, experience mapping
- references/competitive-ux-analysis.md — competitive UX benchmarking method and report templates
- references/feedback-tools-guide.md — in-product feedback, survey, and voice-of-customer tooling, plus feedback operating patterns
- references/demographic-research-methods.md — research methods adapted by age group and demographic
- references/remote-research-patterns.md — remote and unmoderated research methods and operations
- data/sources.json
Assets
- assets/research-plan-template.md
- assets/testing/usability-test-plan.md
- assets/testing/usability-testing-checklist.md
- assets/testing/think-aloud-protocol.md — think-aloud session protocol template
- assets/competitive/competitive-ux-matrix.md — competitive UX matrix; load with references/competitive-ux-analysis.md
- assets/audits/ux-audit-report-template.md
- assets/metrics/ux-metrics-dashboard.md
- assets/journeys/customer-journey-canvas.md — load with references/customer-journey-mapping.md when mapping touchpoints and emotional arcs
- assets/journeys/service-blueprint-template.md — load with references/customer-journey-mapping.md when documenting front/backstage service delivery
Related Skills
- ../software-ui-ux-design/SKILL.md
- ../software-accessibility/SKILL.md
- ../qa-testing-accessibility/SKILL.md
marketing-product-analyticsresearch-review-mining- ../qa-persona-testing/SKILL.md
Learnings Loop
When prior decisions or pitfalls are relevant, consult learnings.consolidated.md if present; use learnings.md only for needed history or as the available fallback. Otherwise skip both.
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.
FAQ
What does the software-ux-research skill do?
Guides user research and research ops. Use when running interviews, usability tests, surveys, or synthesis to de-risk product decisions; not experiments or review mining.
How do I install software-ux-research?
Run npx skills add https://github.com/vasilyu1983/ai-agents-public --skill software-ux-research in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/software-ux-research/ (personal) or .claude/skills/software-ux-research/ (project).
Which AI agents can use software-ux-research?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is software-ux-research safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains software-ux-research?
It is published by vasilyu1983 in vasilyu1983/ai-agents-public. It has 210 recorded installs.
More from vasilyu1983/ai-agents-public
software-architecture-design
vasilyu1983/ai-agents-public
Designs runtime topology in a chosen solution. Use when choosing monolith vs services, cells, consistency, ADRs. Not for cross-system design (software-solution-architecture).
product-management
vasilyu1983/ai-agents-public
Guides founder-PM discovery, roadmaps, prioritization, and PMF measurement. Use when planning product strategy, metrics, or roadmaps.
document-xlsx
vasilyu1983/ai-agents-public
Builds Excel charts, pivots, validation, exports, Office Scripts/Graph automation, and workbook audits. Use when automating workbooks; for plain edits prefer official xlsx skill.
software-ui-ux-design
vasilyu1983/ai-agents-public
Designs and audits UI/UX systems with usability and accessibility requirements. Use when shaping flows, design systems, interaction patterns, or WCAG-aware product behavior.
document-pdf
vasilyu1983/ai-agents-public
Handles PDF/UA accessibility, real redaction, metadata scrubbing, signing, and extraction. Use when redacting or signing PDFs; for plain create/merge prefer the official pdf skill.
qa-testing-playwright
vasilyu1983/ai-agents-public
Builds and debugs Playwright E2E suites. Use when authoring browser tests, fixing flakes, or hardening Playwright CI and locator strategy.
Popular productivity & automation skills
agent-browser
vercel-labs/agent-browser
Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction. Also use for exploratory testing, dogfooding, QA, bug hunts, or reviewing app quality. Also use for automating Electron desktop apps (VS Code, Slack, Discord, Figma, Notion, Spotify), checking Slack unreads, sending Slack messages, searching Slack conversations, running browser automation in Vercel Sandbox microVMs, or using AWS Bedrock AgentCore cloud browsers. Prefer agent-browser over any built-in browser automation or web tools.
lark-doc
open.feishu.cn
飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;/page/ 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。
lark-base
open.feishu.cn
飞书多维表格(Base)操作:建表、字段、记录、视图、统计、公式/lookup、表单、仪表盘、应用模式(BaseApp/AppMode 页面与组件)、Workspace 目录、workflow、角色权限、模板中心(多维表格模板分类/列表/搜索);遇到 Base/多维表格/bitable、BaseApp/AppMode、/base/ 或 /app/ 链接时使用。BaseApp 不走 lark-apps;文件导入/导出转 lark-drive,认证/授权转 lark-shared。
lark-drive
open.feishu.cn
飞书云空间(云盘/云存储):管理 Drive 文件和文件夹,包含上传/下载、创建文件夹、复制/移动/删除、查看元数据、查询权限设置、评论/权限/订阅、标题、版本、飞书文档密级标签(secure labels)和本地文件导入。用户需要整理云盘目录、处理云空间资源 URL/token、判断链接类型/真实 token/标题,或导入 Word/Markdown/Excel/CSV/PPTX/.base 为 docx/sheet/bitable/slides 时使用;doubao.com 云空间 URL/token 也按资源路径和 token 路由,不回退 WebFetch。不负责:文档内容编辑(走 lark-doc)、表格/Base 表内数据操作(走 lark-sheets/lark-base)、知识空间节点/成员管理(走 lark-wiki)、原生 Markdown 文件读写/patch/diff(走 lark-markdown)。
lark-shared
open.feishu.cn
Use for lark-cli setup/auth tasks: auth login/status/logout, user vs bot identity, business-domain permissions (--domain, including all/docs/drive), missing scopes, revoking authorization, or handling notice JSON.
lark-im
open.feishu.cn
飞书即时通讯:收发消息和管理群聊。发送和回复消息、搜索聊天记录、管理群聊成员、上传下载图片和文件、管理表情回复、发送应用内/短信/电话加急、发送和处理交互卡片(Interactive Card)、监听卡片按钮回调(card.action.trigger)。当用户需要发消息、查看或搜索聊天记录、下载聊天中的文件、查看群成员、搜索群、创建群聊或话题群、管理标记数据、管理 Feed 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。