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.
npx skills add anthropics/knowledge-work-plugins --skill user-research -a claude-codeWhat 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-code2Manually: 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 anthropics/knowledge-work-plugins --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 anthropics/knowledge-work-plugins --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 anthropics/knowledge-work-plugins user-research2Manually: put the files in place
.github/skills/user-research/SKILL.md1Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill user-research -a gemini-cli2Platform CLI
gemini skills install https://github.com/anthropics/knowledge-work-plugins --path design/skills/user-researchManually: put the files in place
.devin/skills/user-research/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add anthropics/knowledge-work-plugins --skill user-research -a opencodeClaude.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 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