MCPInstall

ux-research

Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions. Use this skill whenever the user wants to plan user research, design interviews, recruit participants, conduct discovery, run formative research, or synthesize qualitative findings. Triggers on user research, UX research, user interviews, discovery research, generative research, formative research, qualitative research, user insights, research synthesis, recruitment, interview guide, jobs to be done. Also triggers when product decisions are being made without user input and the user wants to fix that.

Installs
263
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/rampstackco/claude-skills --skill ux-research
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads ux-research automatically when relevant.

  3. 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.

UX Research

Plan and execute user research that produces decisions, not just decks. Stack-agnostic. Tool-agnostic.

This skill is for generative and discovery research. For testing existing designs, use usability-testing. For mapping the full customer experience, use journey-mapping.


When to use

  • Starting a new product or major feature without sufficient user understanding
  • Diagnosing why something isn't working without clear data signals
  • Generating new opportunity hypotheses
  • Validating a strategic direction before significant investment
  • Building empathy across a team that's drifted from users
  • Translating "we should talk to users" intent into a real plan

When NOT to use

  • Testing a specific design or prototype (use usability-testing)
  • Mapping the full journey of an existing experience (use journey-mapping)
  • Quantitative measurement (use analytics-strategy)
  • Conversion testing (use cro-optimization)

Required inputs

  • The research question(s) - what you need to answer
  • Stakeholder buy-in (who needs the findings, what decisions hinge on them)
  • Access to users (current customers, prospects, lapsed users, target segments)
  • Timeline and budget
  • Any prior research to build on

The framework: 6 phases

1. Frame the question

Bad questions produce bad research. Spend disproportionate time on framing.

Good research questions:

  • Specific (not "How do users feel about our product?")
  • Open-ended (not "Do users like feature X?")
  • Decision-relevant (the answer changes what gets built)
  • Researchable (can be answered through user contact, not just analysis)

Examples:

Weak questionBetter question
"Do users like our onboarding?""Where in onboarding do new users feel uncertain about whether to continue?"
"What features should we build?""What unmet needs do current users have when [specific job]?"
"Why is conversion low?""What's the user mental model when they reach the pricing page, and where does it diverge from our intent?"

2. Choose the method

The method follows the question.

Generative methods (what's true?):

  • In-depth interviews. 60 minutes, 5 to 15 participants. Best for understanding context, motivation, mental models.
  • Contextual inquiry. Observe users in their environment doing their work. Best for workflow understanding.
  • Diary studies. Participants log their experience over days/weeks. Best for behaviors that don't manifest in a single session.
  • Field research. Spend time where users live/work. Best for cultural and contextual understanding.
  • Surveys (qualitative-heavy). When you need broad signal with open-ended responses.

Validation methods (is this hypothesis right?):

  • Concept testing. Show a description, mockup, or prototype. Get reactions.
  • Card sorts. Validate information architecture.
  • Tree tests. Validate findability without visual design influence.

(For testing usability of working designs, see usability-testing.)

3. Recruit

The recruit makes or breaks the research.

Recruit criteria:

  • Match the audience the research targets (not "anyone willing")
  • Mix of behaviors (active users, lapsed users, never-users)
  • Mix of demographics where relevant
  • Excludes friends, family, employees (biased)
  • Excludes professional research participants if possible (different population)

Recruit channels:

  • In-product recruiting (intercept current users)
  • Email outreach to user segments
  • Recruiting platforms (UserInterviews, Respondent, etc.)
  • Customer support team referrals
  • Field intercept for in-person

Incentive: Pay participants. Standard rates: $50 to $150 for 60 minutes, more for executives or specialized professions.

Recruit volume: Plan for 20 to 30 percent no-show. Recruit 7 to schedule 5.

4. Conduct

The interview or session itself.

Pre-interview:

  • Send confirmation 24 hours and 1 hour before
  • Test recording setup (audio quality is non-negotiable)
  • Prepare interview guide (see template)
  • Have a notetaker if possible (frees the interviewer to focus)

During the interview:

  • Record video and audio (with consent)
  • Open with rapport-building, not the research questions
  • Use open-ended questions ("Tell me about the last time...")
  • Use silence (let participants fill it; don't rush to the next question)
  • Ask "why" but not too many times in a row (becomes interrogation)
  • Ask for specifics and examples ("Can you walk me through what you did?")
  • Probe contradictions gently ("Earlier you said X, now you're saying Y; help me understand")
  • Watch for moments of emotion (often signal something important)
  • Don't sell or convince - this is listening, not pitching

Anti-patterns:

  • Leading questions ("Don't you find this confusing?")
  • Hypothetical questions ("Would you use a feature that...?") - poor predictor of behavior
  • Multiple questions at once
  • Interrupting
  • Filling silence
  • Interviewing your hypothesis (only asking questions that confirm what you already think)

5. Synthesize

Notes don't become insights automatically.

The synthesis process:

  1. Capture observations. From recordings, notes, transcripts. Each observation is a single data point: a quote, a behavior, an emotion, a moment.
  2. Affinity mapping. Cluster observations into themes. Physical sticky notes or digital equivalents.
  3. Find patterns. Themes that appear across multiple participants are signal. One-off observations are interesting but weaker.
  4. Identify insights. An insight is more than a theme. It's a non-obvious finding that explains a why or implies a so what.
  5. Test the insight against the data. If the insight only fits some interviews, it's a hypothesis, not an insight.
  6. Distinguish signal from noise. A belief that 1 of 8 participants holds may be noise. A belief 6 of 8 hold is signal.

Heuristics for strong insights:

  • They surprise the team (insights you already knew aren't insights)
  • They explain a "why" the team has been guessing about
  • They imply specific actions (so what?)
  • They hold up across multiple data points
  • They can be stated in one or two sentences

6. Communicate

Findings die in slide decks. Plan distribution.

Outputs that work:

  • Top-line insights document. 5 to 10 insights, clearly stated, with supporting quotes.
  • Highlight reels. Edited 5 to 10 minute video of key participant moments. More persuasive than any document.
  • In-room workshops. Walk stakeholders through the synthesis themselves. They internalize when they participate.
  • Per-stakeholder briefs. Different audiences need different framings. CEO wants strategic implications. Designers want pain points. Engineers want use cases.

Outputs that fail:

  • 80-slide decks that get skimmed
  • Reports that no one reads past the executive summary
  • Verbose narrative summaries
  • Insights that sit in a doc no one re-opens

Workflow

  1. Frame the research question. With stakeholders. Multiple iterations.
  2. Pick the method. Match to the question.
  3. Plan logistics. Timeline, budget, recruit, tools, team.
  4. Recruit. Start early. Slow recruits delay everything.
  5. Pilot. Run 1 to 2 sessions before the main batch. Refine the guide.
  6. Conduct. Stay disciplined to the guide while staying open to surprises.
  7. Synthesize. Don't wait until all sessions are done; start mid-way.
  8. Communicate. Multiple formats. Multiple audiences.
  9. Track impact. Did decisions change because of the research? If not, the research failed regardless of quality.

Failure patterns

  • Research without a decision. Findings have no home. Effort wasted.
  • Vague research questions. Bad questions produce uninterpretable answers.
  • Recruiting "anyone willing." Sample doesn't match audience.
  • Over-recruiting professional participants. Pattern-matched answers, not real users.
  • Leading questions in the guide. Findings reflect the researcher, not the user.
  • Skipping synthesis. Notes alone aren't insights.
  • Insights that confirm the team's existing beliefs. Suspect those especially.
  • Findings that never ship. Research findings that don't change product decisions are decoration.
  • Single research project for years of decisions. Research has a shelf life. Refresh.
  • Research as one-time project. Continuous discovery beats episodic research.

Output format

Default outputs:

  1. Research plan (before research starts) - research-plan-[topic].md
  2. Interview guide - interview-guide-[topic].md
  3. Findings doc (after synthesis) - research-findings-[topic].md
  4. Highlight reel (video, separately produced)

Findings document structure:

# [Topic] research findings

## Question we set out to answer
[Specific question]

## Method
[Approach, sample size, dates]

## Top insights
1. [Insight, stated in one sentence]
   - Supporting evidence: [Quotes, behaviors, or state the gap per the data-availability rule]
   - Implication: [What this means for product/strategy]
2. [Insight 2]
   ...

## Themes (less prominent than top insights, still worth noting)
[List]

## Outliers worth investigating
[Single-participant observations that may be signal in disguise]

## Recommended next steps
[Specific actions]

If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.


Reference files

  • references/interview-guide-template.md - Structured interview guide template with example openings, probes, and closes.

FAQ

What does the ux-research skill do?

Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions. Use this skill whenever the user wants to plan user research, design interviews, recruit participants, conduct discovery, run formative research, or synthesize qualitative findings. Triggers on user research, UX research, user interviews, discovery research, generative research, formative research, qualitative research, user insights, research synthesis, recruitment, interview guide, jobs to be done. Also triggers when product decisions are being made without user input and the user wants to fix that.

How do I install ux-research?

Run npx skills add https://github.com/rampstackco/claude-skills --skill 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/ux-research/ (personal) or .claude/skills/ux-research/ (project).

Which AI agents can use 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 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 ux-research?

It is published by rampstackco in rampstackco/claude-skills. It has 263 recorded installs.

More from rampstackco/claude-skills

View all →

art-direction

rampstackco/claude-skills

Direct visual and creative work for campaigns, photography, illustration, video, and branded experiences. Use this skill whenever the user wants to brief a photographer, direct illustrators, plan a creative campaign, develop visual concepts, or evaluate creative work for fit. Triggers on art direction, photo brief, photography brief, illustration brief, campaign concept, creative concept, visual direction, mood board, look and feel, visual treatment, video direction. Also triggers when the user has approved brand identity but needs to extend it into specific creative deliverables. Use creative-direction instead when the ask is the project-wide aesthetic brief that this skill consumes as input.

Media & Creative676 installs

brand-identity

rampstackco/claude-skills

Design or evaluate a brand visual identity system covering logo, color, typography, imagery direction, iconography, and motion principles. Use this skill whenever the user wants to design a logo, build a visual identity, define brand colors, choose brand typography, develop iconography, plan brand imagery, or evaluate an existing identity for cohesion. Triggers on logo design, brand identity, visual identity, brand mark, wordmark, monogram, color palette, brand colors, brand typography, type system, iconography, brand imagery, motion design, brand system, identity system. Also triggers when the user has a brand direction approved and now needs the visual artifacts that express it.

Marketing & SEO500 installs

logo-design

rampstackco/claude-skills

Open the skill to read its SKILL.md instructions.

448 installs

creative-direction

rampstackco/claude-skills

Walk the user through four directional axes (tone register, aesthetic philosophy, audience relationship, sensory ambition) and produce a structured aesthetic brief that downstream content, copy, design, and art-direction skills consume as required input. The aesthetic depth layer, distinct from creative-brief (operational kickoff: scope, audience, deliverables, constraints). Use when a project needs aesthetic coherence across many small decisions and the user has only a vague feeling, or when multiple downstream aesthetic-producing skills need a shared brief. Triggers on creative direction, aesthetic direction, set the aesthetic, define the visual direction, what's the vibe, what's the tone, the four axes. Does NOT fire for a general kickoff brief (use creative-brief), tactical single-piece work, already-documented direction, purely functional output, or locked production-stage work.

Media & Creative421 installs

brand-style-guide

rampstackco/claude-skills

Open the skill to read its SKILL.md instructions.

Marketing & SEO392 installs

landing-page-copy

rampstackco/claude-skills

Open the skill to read its SKILL.md instructions.

Frontend & Design376 installs

Popular productivity & automation skills

View category →

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.

OfficialProductivity & Automation1.3M installs

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 置顶(添加/移除/查询置顶会话)、管理标签数据、处理卡片回调时使用。