Agent skill

user-research

User research methods, customer insight gathering, and problem validation for product discovery.

Stars 149
Forks 27

Install this agent skill to your Project

npx add-skill https://github.com/nicepkg/ai-workflow/tree/main/workflows/product-manager-workflow/.claude/skills/user-research

SKILL.md

User Research Skill

Conduct effective user research to understand customer needs, behaviors, and pain points. Master interview techniques and insight synthesis.

Research Methods

Method Selection Guide

Method When Sample Duration
Interviews Deep understanding 15-25 45-60 min
Surveys Quantitative validation 100+ 5-10 min
Usability UX issues 5-8 30-60 min
Observation Real behavior 3-5 2-4 hours
Analytics Scale patterns All users Ongoing

Qualitative Research

Interview Structure

OPENING (5 min):
- Intro & rapport
- Permission to record
- Context setting

CONTEXT (10 min):
- Role and responsibilities
- Day-to-day workflow
- Tools used

DEEP DIVE (20 min):
- "Walk me through [process]..."
- "Tell me about last time [problem]..."
- "What frustrates you most?"

IMPACT (10 min):
- "What happens when [problem]?"
- "How much time/money does it cost?"

FUTURE (10 min):
- "What would ideal look like?"
- "What would you pay for [solution]?"

CLOSING (5 min):
- "Anything else?"
- "Can I follow up?"

Interview Best Practices

  • Listen 70%, talk 30%
  • Ask "Why?" 5 times
  • Avoid leading questions
  • Use silence effectively
  • Capture quotes verbatim

Quantitative Research

Survey Design

Question Types:

  • Rating scale (1-5, 1-10)
  • Multiple choice
  • Open-ended (limit 1-2)
  • Ranking

NPS Question: "How likely are you to recommend [product] to a friend? (0-10)"

Sample Size Calculator

For 95% confidence, 5% margin:
- Population 100 → Sample 80
- Population 500 → Sample 217
- Population 1000 → Sample 278
- Population 10000 → Sample 370

Synthesis

Affinity Mapping

  1. Write each insight on sticky note
  2. Group similar insights
  3. Name each group (theme)
  4. Rank by frequency/impact
  5. Extract top 5-10 themes

Persona Template

NAME: [Descriptive name]
ROLE: [Job title, company type]
QUOTE: "[Real quote from research]"

GOALS:
- [Goal 1]
- [Goal 2]

FRUSTRATIONS:
- [Pain 1]
- [Pain 2]

BEHAVIORS:
- [How they work]
- [Tools they use]

NEEDS:
- [Need 1]
- [Need 2]

Journey Map

Stage Actions Emotions Pain Points Opportunities
Aware Search Curious Hard to find SEO, content
Consider Compare Confused Too many options Comparison
Purchase Buy Anxious Complex checkout Simplify
Use Onboard Overwhelmed Steep learning Better UX

Troubleshooting

Yaygın Hatalar & Çözümler

Hata Olası Sebep Çözüm
Low response Wrong incentive $50-100 gift card
Surface insights Leading questions "Why?" 5x
Conflicting data Mixed segments Segment analysis
No show Scheduling issues Calendar hold, reminder

Debug Checklist

[ ] Research plan documented mi?
[ ] Sample size sufficient mi?
[ ] Questions non-leading mi?
[ ] Recording consent alındı mı?
[ ] Synthesis done within 24h mi?
[ ] Insights actionable mi?

Recovery Procedures

  1. Low Participation → Increase incentive, new channels
  2. Conflicting Data → Segment by user type
  3. Shallow Insights → Follow-up interviews

Learning Outcomes

  • Plan effective research studies
  • Conduct insightful interviews
  • Design valid surveys
  • Synthesize research data
  • Present actionable insights

Expand your agent's capabilities with these related and highly-rated skills.

nicepkg/ai-workflow

workflow-creator

Create complete Claude Code workflow directories with curated skills. Use when user wants to (1) create a new workflow for specific use case (media creator, developer, marketer, etc.), (2) set up a Claude Code project with pre-configured skills, (3) download and organize skills from GitHub repositories, or (4) generate README.md and AGENTS.md documentation for workflows. Triggers on phrases like "create workflow", "new workflow", "set up workflow", "build a xxx-workflow".

149 27
Explore
nicepkg/ai-workflow

add-new-skills-to-workflow

Add new skills to an existing workflow and update all related documentation. Use when user wants to add skills from GitHub URLs to a workflow (e.g., "add this skill to the workflow", "为工作流添加技能"). Triggers on adding skills to workflows, updating workflow documentation after skill additions.

149 27
Explore
nicepkg/ai-workflow

remove-old-skills-from-workflow

Guide for removing skills from an existing workflow and updating all related documentation. Use when user wants to remove skills from a workflow (e.g., "remove skill", "delete skill", "移除技能", "删除技能").

149 27
Explore
nicepkg/ai-workflow

legacy-to-ai-ready

Transform legacy codebases into AI-ready projects with Claude Code configurations. Use when (1) analyzing old projects to generate AI coding configurations, (2) creating CLAUDE.md, skills, subagents, slash commands, hooks, or rules for existing projects, (3) user wants to enable vibe coding for a codebase, (4) onboarding new team members with AI-assisted development, (5) user mentions "make project AI-ready", "generate Claude config", or "create coding standards for AI".

149 27
Explore
nicepkg/ai-workflow

skill-downloader

Download and install Claude Code skills from various sources. Supports GitHub repositories, compressed archives (.zip, .tar.gz, .skill), and direct URLs. Use when user wants to download, install, or add a skill from GitHub, URL, or archive file. Triggers on "download skill", "install skill", "add skill from", "get skill".

149 27
Explore
nicepkg/ai-workflow

skill-creator

Guide for creating effective skills. This skill should be used when users want to create a new skill (or update an existing skill) that extends Claude's capabilities with specialized knowledge, workflows, or tool integrations.

149 27
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results