Skip to main content
skill CX Codex

user-research · rsmdt — Claude Code skill: what it does, how to install

Plans user research studies, analyzes usability tests and customer interviews, and turns findings into prioritized product recommendations.

MIT ★ 587 updated 2026-10-26

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup
Open on GitHub

What user-research does

The skill configures Claude Code as a user research methodologist. It guides work across five steps: clarifying decision questions, picking research methods, executing studies, clustering findings into themes, and drafting deliverables like behavioral personas or journey maps.

Findings follow structured data models, specifically ResearchInsight and ResearchDeliverable. Every insight pairs factual evidence with impact and an explicit priority level (HIGH, MEDIUM, or LOW). Constraints enforce rigor. The agent separates observed behavior from opinions and never generalizes from an isolated anecdote.

Internal workflows pull from guides in reference/ covering interviews, observation, and affinity mapping. Without concrete evidence tied to each insight, recommendations will not be generated.

What it helps with

  • plan structured customer interviews or usability tests
  • cluster raw interview notes into prioritized insight themes
  • build touchpoint journey maps with emotional arcs
  • create behavioral personas instead of demographic profiles
  • turn test observations into actionable design recommendations

Example prompts for the agent

  • Plan a usability study to evaluate our new checkout workflow
  • Synthesize these user interview notes into structured insights with evidence and priority
  • Create a customer journey map for trial onboarding highlighting friction touchpoints

How to install user-research

1Plugin marketplace

/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startup

This installs the whole team plugin with all its skills

2Skills CLI (Vercel)

npx skills add rsmdt/the-startup --skill user-research -a claude-code

3Manually: put the files in place

~/.claude/skills/user-research/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/user-research/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about user-research

How to install user-research in Claude Code?

Add the marketplace repository by running /plugin marketplace add rsmdt/the-startup, then install the bundle with /plugin install team@the-startup.

What does the user-research skill do?

It structures the research process from study planning and question framing to thematic analysis and prioritized product deliverables.

How does user-research handle personas and insights?

The skill mandates behavioral personas over demographic stereotypes and requires verifiable evidence for every insight, rejecting single-anecdote generalizations.

Source text

SKILL.md · MIT
---
name: user-research
description: User research and insight synthesis for interviews, usability testing, personas, journey mapping, and actionable product/design recommendations. Use when planning studies, collecting evidence, synthesizing patterns, or converting findings into prioritized decisions.
---

## Persona

Act as a user research methodologist who plans rigorous studies and synthesizes evidence into prioritized product and design actions.

**Research Target**: $ARGUMENTS

## Interface

ResearchInsight {
  theme: string
  evidence: string[]
  impact: string
  recommendation: string
  priority: HIGH | MEDIUM | LOW
}

ResearchDeliverable {
  method: string
  participants: string
  keyInsights: ResearchInsight[]
  personas: string[]
  journeyMaps: string[]
}

State {
  target = $ARGUMENTS
  methods = []
  rawData = []
  insights = []
}

## Constraints

**Always:**
- Choose research methods based on decision type and lifecycle stage.
- Separate observed behavior from participant opinion.
- Support each insight with concrete evidence.
- Produce prioritized, actionable recommendations.
- Use behavioral personas, not demographic stereotypes.

**Never:**
- Lead participants toward desired answers.
- Generalize from a single anecdote.
- Deliver findings without clear implications for product/design decisions.

## Reference Materials

- `reference/interview-methods.md` — Interview types, question design, and facilitation techniques
- `reference/observation-methods.md` — Contextual inquiry and usability testing protocols
- `reference/synthesis-methods.md` — Affinity mapping, thematic analysis, and insight extraction
- `reference/persona-guide.md` — Behavioral persona framework and creation process
- `reference/journey-mapping.md` — Journey map structure, touchpoints, and emotional arcs
- `reference/planning-reporting.md` — Study planning templates and reporting formats

## Workflow

### 1. Define Decision Questions
- Clarify what decision the research should inform.

### 2. Select Method
- Choose interviews, usability testing, contextual inquiry, survey, or mixed methods.

### 3. Conduct Study
- Execute with structured protocols and representative participants.

### 4. Synthesize Insights
- Cluster observations, name themes, and prioritize by impact/actionability.

### 5. Produce Deliverables
- Deliver insight report, personas/journey maps when needed, and prioritized recommendations.

© Rudolf S. · MIT · rsmdt/the-startup

Similar skills

All skills for Design →

user-research by other authors comes first.

user-research official anthropics user-research helps teams plan research studies, prepare interview guides, and synthesize feedback. Useful for scoping usability tests and prioritizing findings. CX Codex +1 4,300installs user-research OrchestKit Skill for structured user research: personas, journey maps, interviews, usability testing, and card sorting. Learn what users actually need and build products grounded in evidence. CX Codex +1 134installs user-persona Owl-Listener The user-persona skill builds 2-4 research-grounded personas from interview transcripts, surveys, or analytics. It helps teams align design decisions with observed user behavior. CX Codex +1 2,500installs ux-researcher-designer Alireza Rezvani The ux-researcher-designer skill helps turn user data into personas, journey maps, usability test plans, and design recommendations. Use it when research findings need a clear structure. CX Codex +1 962installs om-synthetic-users open-mercato om-synthetic-users constructs synthetic persona panels from repository materials to test product flows and surface objections under decision pressure. CX Codex +1 2,400installs user-persona-creation aj-geddes user-persona-creation builds realistic user personas from qualitative research and interview notes. Useful for guiding product design and feature prioritization. CX Codex +1 494installs ux-research-discovery-testing hueyexe ux-research-discovery-testing gives your agent a working method for discovery interviews, usability tests and synthesis, so product calls rest on observed behavior instead of opinions. CX Codex +1 545installs user-research-cookiy podo user-research-cookiy is a Claude Code skill for planning user research, creating discussion guides, and synthesizing transcripts in an agent workspace. CX Codex +1 264installs

From the same set50

The whole set →
agentic-patterns agentic-patterns fetches current LangChain, Vercel AI SDK and assistant-ui docs, then turns them into guidance for the agent, chat UI, RAG or tool-calling task you name. CX Codex +1 ★ 587repo stars code-quality-review code-quality-review evaluates code across eight dimensions, prioritizing correctness and security risks over cosmetic formatting. CX Codex +1 ★ 587repo stars domain-modeling The domain-modeling skill turns business rules into domain models, aggregate boundaries, and storage decisions. Use it when shaping a business model or changing schema consistency rules. CX Codex +1 ★ 587repo stars project-discovery project-discovery is a Claude Code skill that maps a codebase’s structure, tech stack, entry points, and documentation mismatches against actual code. CX Codex +1 ★ 587repo stars constitution This skill examines a codebase and drafts a project constitution grounded in its existing patterns. Use it to establish or revise governance rules with file-and-line evidence. CX Codex +1 ★ 587repo stars research-user research-user — a subagent for planning and conducting user research. Surfaces genuine user motivations and pain points before building features, when conversion drops, or when your team disagrees on what users actually need. CX Codex ★ 587repo stars design-visual design-visual — a design-systems subagent for Claude Code that establishes design tokens, component standards, and WCAG 2.1 AA accessibility foundations. CX Codex ★ 587repo stars research-product research-product — a subagent for Claude Code that transforms strategic uncertainty and vague requirements into prioritized decisions. Analyzes market and competitors, elicits and reconciles requirements, resolves stakeholder conflicts. CX Codex ★ 587repo stars

Project sponsors

Companies that keep this analytics open