Agent skill

UX Research

by rampstackco in rampstackco/claude-skills

Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions.

MITAuto-check passedProduct & Project Management

Install UX Research

skills CLI
$ npx skills add rampstackco/claude-skills --skill ux-research -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rampstackco/claude-skills ux-research --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/rampstackco/claude-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/ux-research .claude/skills/ux-research && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
ux-research
GitHub stars
935
Token cost
~2.7k tokens
SKILL.md length
1,262 words
Files
3 (incl. references)
Skills in repo
103
Repo updated
First seen
Licence
MIT

At a glance

Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions.

  • Works in 6 steps: Frame the question → Choose the method → Recruit → …
  • The user wants to plan user research
  • SKILL.md covers When to use, When NOT to use, Required inputs and The framework: 6 phases, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

UX Research is an agent skill from rampstackco/claude-skills. 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…

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 3 other files, including reference files (for example `README.md` and `references/interview-guide-template.md`).

It sits in Product & Project Management, covering User research, UX design and Recruiting and HR. The repository describes itself as: Stack-agnostic Claude Skills covering the full website lifecycle: brand, design, content, SEO, dev, ops, growth, and research. Build, ship, audit, optimize. The licence is MIT.

When your agent uses it

  • The user wants to plan user research
  • Design interviews
  • Recruit participants
  • Conduct discovery

Example prompts

  • “/ux-research”

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Frame the question
  2. Choose the method
  3. Recruit
  4. Conduct
  5. Synthesize
  6. Communicate

What it can do on your machine

Read from SKILL.md and the folder at commit 482c9bf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

UX Research loads about 2.7k tokens when it runs, and up to ~4.7k if it reads all its reference files. Until then it costs about 170 tokens; SKILL.md has 1,262 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~170
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.7k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from rampstackco/claude-skills at commit 482c9bf, republished under its MIT licence (© rampstackco). 1,262 words, ~2,736 tokens.

Download SKILL.mdSave it as .claude/skills/ux-research/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
ux-research
description
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.
category
research
catalog_summary
Research planning, user interviews, qualitative synthesis
display_order
1

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
Show full SKILL.md (419 more words)Show less
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:

markdown
# [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

© rampstackco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files (references) in skills/ux-research of rampstackco/claude-skills.

  • SKILL.md
  • README.md
  • references/interview-guide-template.md

Open the folder on GitHubat commit 482c9bf

Compare with similar skills

UX Research next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

UX Research compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
UX Research this skillrampstackco/claude-skills935—~2.7kAutomated safety check: PassMIT
Lean UX Canvas v2deanpeters/Product-Manager-Skills7.2k1 repos~6.2kAutomated safety check: PassCustom licence
UX Researcher Designeralirezarezvani/claude-skills28k1 repos~3kAutomated safety check: PassMIT
Product Researchalirezarezvani/claude-skills28k—~2.7kAutomated safety check: PassMIT
Building ProductGTM-Strategist/gtm-strategist-skills261—~5.8kAutomated safety check: PassMIT
Investigateghaida/intent206—~7.3kAutomated safety check: PassCC0-1.0

Similar skills

  • Lean UX Canvas v2

    deanpeters/Product-Manager-Skills

    Guides a team through Jeff Gothelf's Lean UX Canvas v2 to frame a business problem, surface assumptions and decide what to learn and test next.

    7.2k GitHub starsUsed in 1 repo~6.2k tokens
    Product & Project ManagementAuto-check passed
  • UX Researcher Designer

    alirezarezvani/claude-skills

    UX research and design toolkit for Senior UX Designer/Researcher including data-driven persona generation, journey mapping, usability testing frameworks, and research synthesis.

    28k GitHub starsUsed in 1 repo~3k tokens
    Product & Project ManagementAuto-check passed
  • Product Research

    alirezarezvani/claude-skills

    A skill your agent uses when planning and synthesizing product/user research as a method-and-repository discipline — selecting the right method for the goal (generative interviews vs usability test…

    28k GitHub stars~2.7k tokensUpdated 1 mo ago
    Product & Project ManagementAuto-check passed
  • Building Product

    GTM-Strategist/gtm-strategist-skills

    A skill your agent uses when the user needs to define their MVP, create a product roadmap, plan metrics and tracking, refine their value proposition with JTBD, or run usability tests.

    261 GitHub stars~5.8k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Investigate

    ghaida/intent

    Guide and conduct user research — from planning through synthesis.

    206 GitHub stars~7.3k tokensUpdated 2 mo ago
    Product & Project ManagementAuto-check passed
  • Discover Interview Synthesis

    product-on-purpose/pm-skills

    Synthesizes user research interviews into actionable insights, patterns, and recommendations.

    713 GitHub stars~1.3k tokensUpdated 3 days ago
    Product & Project ManagementAuto-check passed

More from rampstackco/claude-skills

All 103 skills in this repo
  • After Action Report

    rampstackco/claude-skills

    Run a structured after-action review (postmortem, retrospective) on a launch, incident, or completed project to capture timeline, root cause analysis, contributing factors, and actionable lessons.

    935 GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Analytics Strategy

    rampstackco/claude-skills

    Design measurement frameworks including event taxonomy, KPI hierarchy, dashboard architecture, attribution models, and analytics implementation strategy.

    935 GitHub starsUsed in 1 repo~2.4k tokens
    Auto-check passed
  • Brand Style Guide

    rampstackco/claude-skills

    Build or audit a comprehensive brand style guide that documents the full brand system including story, logo system, color, typography, imagery, voice, applications, and dos/don'ts.

    935 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Brand Voice

    rampstackco/claude-skills

    Develop or document a complete brand voice and tone system covering voice attributes, tone shifts by context, vocabulary preferences, grammar rules, and copy examples.

    935 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Content And Copy

    rampstackco/claude-skills

    Write or edit website copy, blog content, and editorial pieces with attention to voice, structure, and goal.

    935 GitHub stars~2.1k tokensUpdated today
    Auto-check passed
  • Content Strategy

    rampstackco/claude-skills

    Develop a content strategy covering editorial positioning, content pillars, formats, calendar, governance, and topical authority planning.

    935 GitHub stars~2.6k tokensUpdated today
    Auto-check passed

Questions about UX Research

What does UX Research do?

Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions. UX Research is an agent skill from rampstackco/claude-skills. Plan and execute user research including research planning, recruiting, interview design, qualitative synthesis, and translating findings into product decisions.

When should I use UX Research?

UX Research fits situations like: the user wants to plan user research; design interviews; recruit participants; conduct discovery.

How do I install UX Research in Claude Code?

Run `npx skills add rampstackco/claude-skills --skill ux-research -a claude-code`. Or copy the skill folder (skills/ux-research in rampstackco/claude-skills) into .claude/skills/ux-research in your project. Claude Code loads it when a task matches its description.

How do I install UX Research in Codex?

Run `npx skills add rampstackco/claude-skills --skill ux-research -a codex`. Or copy the skill folder (skills/ux-research in rampstackco/claude-skills) into .agents/skills/ux-research in your project. Codex loads it when a task matches its description.

Can I use UX Research in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add rampstackco/claude-skills --skill ux-research -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/ux-research, .gemini/skills/ux-research, .github/skills/ux-research and .opencode/skills/ux-research in your project.

What does UX Research need to run?

SKILL.md names no scripts, command-line tools or credentials: UX Research is instructions for the agent only.

Does UX Research access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is UX Research safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does UX Research use?

UX Research is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does UX Research use?

About 2.7k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to UX Research?

Skills that share tags, products or a category with UX Research: Lean UX Canvas v2 (deanpeters/Product-Manager-Skills, 7.2k stars), UX Researcher Designer (alirezarezvani/claude-skills, 28k stars), Product Research (alirezarezvani/claude-skills, 28k stars) and Building Product (GTM-Strategist/gtm-strategist-skills, 261 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains UX Research?

rampstackco (a GitHub organization) maintains it in rampstackco/claude-skills, which has 935 GitHub stars. The repository holds 103 skills in this directory. The repository was last updated on October 7, 2026.

Source: rampstackco/claude-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.