user-research

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

151 stars

Best use case

user-research is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

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

Teams using user-research should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/user-research/SKILL.md --create-dirs "https://raw.githubusercontent.com/nicepkg/ai-workflow/main/workflows/product-manager-workflow/.claude/skills/user-research/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/user-research/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How user-research Compares

Feature / Agentuser-researchStandard Approach
Platform SupportNot specifiedLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

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

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# 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

Related Skills

writing-user-stories

151
from nicepkg/ai-workflow

Use when an agent needs to write user stories for a project

user-persona-creation

151
from nicepkg/ai-workflow

Create detailed user personas based on research and data. Develop realistic representations of target users to guide product decisions and ensure user-centered design.

lead-research-assistant

151
from nicepkg/ai-workflow

Identifies high-quality leads for your product or service by analyzing your business, searching for target companies, and providing actionable contact strategies. Perfect for sales, business development, and marketing professionals.

content-trend-researcher

151
from nicepkg/ai-workflow

Advanced content and topic research skill that analyzes trends across Google Analytics, Google Trends, Substack, Medium, Reddit, LinkedIn, X, blogs, podcasts, and YouTube to generate data-driven article outlines based on user intent analysis

content-research

151
from nicepkg/ai-workflow

Research-first content creation optimized for both human readers and AI search engines (Claude, ChatGPT, Perplexity, Gemini). Creates authentic, authoritative content that becomes the go-to citation source for AI models answering user questions. Use this skill when: - Creating content that should appear in AI search results (Perplexity, ChatGPT, Claude) - Building topical authority to become THE source AI cites for a topic - Launching a new product and need compelling, citable content - Creating blog posts, articles, social media, or press releases - Need content that references real trends, people, and recent events - Want AI-assisted content that doesn't sound AI-generated - Creating thought leadership content in any industry Triggers: "create content for", "write about", "research and write", "find experts for", "content for launch", "blog post about", "article on", "press release for", "AI search", "show up in AI", "Perplexity", "be cited by AI"

youtube-to-markdown

151
from nicepkg/ai-workflow

Use when user asks YouTube video extraction, get, fetch, transcripts, subtitles, or captions. Writes video details and transcription into structured markdown file.

youtube-seo-optimizer

151
from nicepkg/ai-workflow

Optimize YouTube videos for search and discovery. Generates SEO-optimized titles, descriptions, tags, hashtags, and chapters. Includes keyword research and competitor analysis. Use when publishing videos, improving discoverability, or optimizing existing content.

webfluence

151
from nicepkg/ai-workflow

Content web architecture framework. Use when diagnosing offer doc usage, content-to-conversion pathways, or why someone isn't getting sales despite traffic.

video-to-gif

151
from nicepkg/ai-workflow

Convert video clips to optimized GIFs with speed control, cropping, text overlays, and file size optimization. Create perfect GIFs for social media, documentation, and presentations.

video-title-optimizer

151
from nicepkg/ai-workflow

Optimize video titles for maximum click-through rate (CTR) and YouTube/TikTok SEO. Generates multiple title variations balancing curiosity, keywords, and platform best practices. Use when naming videos, improving CTR, or A/B testing titles.

video-script-writer

151
from nicepkg/ai-workflow

Write engaging video scripts for YouTube, TikTok, and other platforms. Creates complete scripts with hooks, main content, and CTAs. Supports various formats including tutorials, vlogs, reviews, explainers, and storytelling. Use when creating video scripts, writing YouTube content, or planning video structure.

video-script-collaborial

151
from nicepkg/ai-workflow

将视频脚本转换为更适合实际录制的口语化表达,去除书面化语言,增加自然感和亲和力。当用户提到"视频脚本"、"录制"、"口语化"、"自然一点"、"像说话一样"、"太书面了"时使用此技能。