user-research
User research methods, customer insight gathering, and problem validation for product discovery.
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
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/user-research/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How user-research Compares
| Feature / Agent | user-research | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/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
AI Agent for Product Research
Browse AI agent skills for product research, competitive analysis, customer discovery, and structured product decision support.
AI Agents for Startups
Explore AI agent skills for startup validation, product research, growth experiments, documentation, and fast execution with small teams.
AI Agent for SaaS Idea Validation
Use AI agent skills for SaaS idea validation, market research, customer discovery, competitor analysis, and documenting startup hypotheses.
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
Use when an agent needs to write user stories for a project
user-persona-creation
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
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
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
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
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
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
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
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
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
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
将视频脚本转换为更适合实际录制的口语化表达,去除书面化语言,增加自然感和亲和力。当用户提到"视频脚本"、"录制"、"口语化"、"自然一点"、"像说话一样"、"太书面了"时使用此技能。