Plan and execute user research projects. Produces interview guides, usability test scripts, survey templates, affinity maps, persona documents, journey maps, and a structured insights report. Based on saeed-vayghan/gemini-agent-skills ux-researcher skill, adapted for CodeBanana. Triggers: - "user research" - "ux research" - "user interviews" - "usability testing" - "persona" - "user insights" - "用户调研" - "用户访谈" - "用户洞察"
Help users plan and execute structured user research — from defining research questions through to actionable insights. Outputs research artifacts (interview guide, survey, personas, journey map) and a final Markdown insights report + Excel summary.
| Parameter | Default |
|---|---|
| Research method | User interviews (qualitative) |
| Participants | 5–8 |
| Output: Markdown report | Yes |
| Output: Excel summary | Yes |
| Output: Research artifacts | Yes (interview guide / survey / personas) |
User confirms the research topic and product/context. All other fields optional.
| Field | Description | Example |
|---|---|---|
topic | What you want to learn | "Why users churn after trial", "How people manage expenses" |
product | The product or context | "A B2B SaaS invoicing tool", "a mobile fitness app" |
| Field | Description | Example |
|---|---|---|
method | Research method | interviews / survey / usability test / diary study |
target_users | Who to research | "SMB founders", "college students", "first-time homebuyers" |
goal | Business goal behind research | "Improve onboarding", "validate new feature", "understand drop-off" |
existing_data | Any data you already have | "We have 200 survey responses", "NPS is 32" |
Ask these 3 questions in the welcome message:
Convert the user's goal into 3–5 focused research questions:
Example format:
RQ1: Why do users stop using the product after the first week?
RQ2: What alternatives are they using instead?
RQ3: How do they describe their ideal solution?
| Method | Best for | Participants | Time |
|---|---|---|---|
| User Interviews | Deep "why" questions, mental models | 5–8 | 45–60 min each |
| Usability Testing | Task completion, UI friction | 5–8 | 30–45 min each |
| Survey | Quantitative patterns, validation | 50–200+ | 5–10 min |
| Diary Study | Longitudinal behavior, habits | 8–15 | 1–2 weeks |
| Card Sorting | IA, navigation, categorization | 15–20 | 20–30 min |
Recommend method based on user's goal. Default to interviews for open-ended discovery.
Define:
Generate the appropriate artifacts based on chosen method.
# Interview Guide: [Topic]
**Duration:** 45–60 minutes
**Interviewer note:** This is a guide, not a script. Follow the conversation naturally.
## Introduction (5 min)
- Thank participant, explain purpose (learning, not testing them)
- Ask permission to record
- "There are no right or wrong answers — we want to understand your experience."
## Warm-up (5 min)
- Tell me a bit about yourself and what you do day-to-day.
- How long have you been using [product/category]?
## Core Questions (30–35 min)
[Generated based on research questions — 8–12 open-ended questions]
## Probing Techniques
- "Tell me more about that."
- "Can you walk me through what happened?"
- "What were you thinking at that moment?"
- "How did that make you feel?"
- "What would ideal look like?"
## Wrap-up (5 min)
- Is there anything else you'd want us to know?
- Can we follow up if we have more questions?
# Usability Test Script: [Product / Feature]
**Duration:** 30–45 minutes
## Introduction
- Explain think-aloud protocol: "Say everything you're thinking as you go."
- "We're testing the product, not you."
## Tasks
[3–5 realistic tasks based on user goals]
Task 1: "Imagine you want to [goal]. Please show me how you'd do that."
Task 2: ...
## Observation Notes
| Task | Completed? | Time | Errors | Comments |
|------|------------|------|--------|----------|
## Post-task Questions
- What was confusing or unexpected?
- What would you change?
- How does this compare to how you do it today?
Structure:
Question types: Likert scale / multiple choice / ranking / open text Keep total under 15 questions.
Group raw observations/quotes into themes:
Level 1 — Raw notes (direct quotes, observations)
Level 2 — Patterns (cluster of similar notes)
Level 3 — Themes (named insight category)
Level 4 — Insight (actionable "How might we..." statement)
Output format:
## Theme: [Name]
**Insight:** Users struggle with X because Y.
**Supporting quotes:**
- "..." (P3)
- "..." (P7)
**Frequency:** 6/8 participants
**Severity:** High / Medium / Low
## Persona: [Name], [Age], [Role]
**Quote:** "..."
**Goals:** What they're trying to achieve
**Frustrations:** Top 3 pain points
**Behaviors:** How they currently solve the problem
**Tools they use:** ...
**Decision factors:** What makes them choose a solution
Stages: Awareness → Consideration → Onboarding → Regular Use → Advocacy / Churn
For each stage:
# User Research Report: [Topic]
*Method: [Method] | Participants: [N] | Date: [Date]*
## Executive Summary
3–5 bullet points. Most important insights first.
## Research Questions
[List RQs and one-line answers]
## Key Insights
### Insight 1: [Title]
Description. Supporting evidence. Frequency.
### Insight 2: [Title]
...
## Personas
[1–3 persona profiles]
## Journey Map
[Table or narrative]
## Recommendations
| Recommendation | Priority | Rationale |
|----------------|----------|-----------|
## Methodology
- Method, participants, recruitment criteria
- Limitations and caveats
- Areas for follow-up research
Use openpyxl to generate user-research-[topic]-[date].xlsx
| # | Insight | Theme | Frequency | Severity | Recommendation |
|---|
| Participant | Quote / Observation | Theme | Research Question |
|---|
| Name | Age/Role | Goals | Frustrations | Behaviors |
|---|
| Recommendation | Priority | Effort | Impact | Owner |
|---|
Formatting:
#1F3864 (white text)#F2F7FFuser-research-[topic]-[date].mduser-research-[topic]-[date].xlsx✅ User Research Complete: [Topic]
📄 Report: user-research-[topic]-[date].md
📊 Excel: user-research-[topic]-[date].xlsx
**Top 3 Insights:**
1. [Insight 1]
2. [Insight 2]
3. [Insight 3]
**Top Recommendations:**
1. [Rec 1] — Priority: High
2. [Rec 2] — Priority: Medium
**Next steps:**
- [ ] Share findings with product team
- [ ] Prioritize top recommendations in roadmap
- [ ] Schedule follow-up research on [open question]