Skip to main content
skill CX Codex official · Anthropic

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

Helps teams plan research studies, prepare interview guides, and synthesize feedback. Useful for scoping usability tests and prioritizing findings.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add anthropics/knowledge-work-plugins --skill user-research -a claude-code
Open on GitHub

What user-research does

This skill outlines protocols for user interviews, usability testing, surveys, card sorting, diary studies, and A/B testing. Each approach comes with recommended participant sample sizes and turnaround times. For example, surveys target 100+ respondents, while usability tests suggest 5-8 participants across 1-2 weeks.

Interview sessions follow a timed structure: 5 minutes for warm-up, 10 minutes on context, 20 minutes for a deep dive, 10 minutes on prototype reactions, and 5 minutes to wrap up. It keeps discussions focused. To interpret raw data, the skill applies affinity mapping, an impact/effort matrix, journey maps, and jobs-to-be-done framing.

Deliverables are limited to documentation: study plans, question scripts, synthesis reports, and quote collections. Participant recruiting and call hosting remain the user's manual responsibility.

What it helps with

  • structure a product research plan with clear objectives
  • write a timed interview guide for participant sessions
  • group user testing notes into themes with affinity mapping
  • prioritize findings using an impact and effort matrix

Example prompts for the agent

  • Draft a user research plan to test our checkout flow with target participant criteria.
  • Write an interview guide with 10 minutes of workflow context and 20 minutes of deep-dive questions.
  • Synthesize raw usability notes into themes and place them on an impact and effort matrix.

How to install user-research

1Skills CLI (Vercel)

npx skills add anthropics/knowledge-work-plugins --skill user-research -a claude-code

2Manually: 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 do I install user-research in Claude Code?

Run npx skills add anthropics/knowledge-work-plugins --skill user-research -a claude-code. The skill file installs to ~/.claude/skills/user-research/SKILL.md.

What deliverables does user-research produce?

It generates study plans, interview guides with prompt questions, synthesis reports with recommendations, and highlight reels of participant quotes.

How does user-research allocate time during an interview?

The guide schedules 5 minutes for warm-up, 10 minutes for workflow context, 20 minutes for the deep dive, 10 minutes for reactions to concepts, and 5 minutes for closing.

Source text

SKILL.md · Apache-2.0
---
name: user-research
description: Plan, conduct, and synthesize user research. Trigger with "user research plan", "interview guide", "usability test", "survey design", "research questions", or when the user needs help with any aspect of understanding their users through research.
---

# User Research

Help plan, execute, and synthesize user research studies.

## Research Methods

| Method | Best For | Sample Size | Time |
|--------|----------|-------------|------|
| User interviews | Deep understanding of needs and motivations | 5-8 | 2-4 weeks |
| Usability testing | Evaluating a specific design or flow | 5-8 | 1-2 weeks |
| Surveys | Quantifying attitudes and preferences | 100+ | 1-2 weeks |
| Card sorting | Information architecture decisions | 15-30 | 1 week |
| Diary studies | Understanding behavior over time | 10-15 | 2-8 weeks |
| A/B testing | Comparing specific design choices | Statistical significance | 1-4 weeks |

## Interview Guide Structure

1. **Warm-up** (5 min): Build rapport, explain the session
2. **Context** (10 min): Understand their current workflow
3. **Deep dive** (20 min): Explore the specific topic
4. **Reaction** (10 min): Show concepts or prototypes
5. **Wrap-up** (5 min): Anything we missed? Thank them.

## Analysis Framework

- **Affinity mapping**: Group observations into themes
- **Impact/effort matrix**: Prioritize findings
- **Journey mapping**: Visualize the user experience over time
- **Jobs to be done**: Understand what users are hiring your product to do

## Deliverables

- Research plan (objectives, methods, timeline, participants)
- Interview guide (questions, probes, activities)
- Synthesis report (themes, insights, recommendations)
- Highlight reel (key quotes and observations)

© anthropics · Apache-2.0 · anthropics/knowledge-work-plugins

Similar skills

Everything for Design →

From the same set159

The whole set →
financial-statements Generates financial statements with period comparisons and variance analysis. Use it for P&L preparation, period close, budget checks, and leadership summaries. CX Codex +1 4,500installs competitive-intelligence Gathers competitor data from your CRM, emails and web sources, shows how to win against them in a specific deal, and tracks win/loss patterns across your pipeline. Built for sales teams who need competitive context before a call. CX Codex +1 4,500installs design-system This skill audits a design system, documents components, and helps extend existing patterns. Use it when tokens, states, naming, or accessibility need a closer check. CX Codex +1 4,200installs research-synthesis Synthesizes interview transcripts, surveys, and support tickets into structured reports with themes, user segments, and prioritized actions. CX Codex +1 4,100installs slack-messaging This skill helps agents write Slack messages with mrkdwn, clear structure, and channel-aware etiquette. Use it for drafts, replies, and announcements. CX Codex +1 4,000installs interview-prep Builds interview plans with competency-based questions, scoring rubrics, and a debrief template. Useful when preparing structured candidate interviews. CX Codex +1 3,700installs review-contract Checks a contract against your negotiation playbook: flags deviations, drafts redlines and spells out the business impact. CX Codex +1 3,700installs validate-data Runs QA checks on data reports, SQL queries, and charts before stakeholder review. Catches calculation bugs, flawed logic, and analytical bias. CX Codex +1 3,700installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor