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
/plugin marketplace add rsmdt/the-startup
/plugin install team@the-startupWhat 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-startupThis installs the whole team plugin with all its skills
2Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill user-research -a claude-code3Manually: put the files in place
~/.claude/skills/user-research/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/user-research/
1Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill user-research -a codex2Manually: put the files in place
.agents/skills/user-research/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill user-research -a cursor2Manually: put the files in place
.cursor/skills/user-research/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install rsmdt/the-startup plugins/team/skills/design/user-research2Manually: put the files in place
.github/skills/user-research/SKILL.md1Skills CLI (Vercel)
npx skills add rsmdt/the-startup --skill user-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/rsmdt/the-startup --path plugins/team/skills/design/user-researchManually: put the files in place
.devin/skills/user-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Claude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
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.