user-research
$
npx mdskill add yonatangross/orchestkit/user-researchCreates user research frameworks for personas, journey maps, and usability testing to build deep customer understanding.
- Helps with building user understanding and mapping customer experiences for product strategy.
- Integrates with tools like Read, Glob, Grep, WebFetch, and WebSearch for data gathering.
- Decides recommendations based on structured research methods like interviews and card sorting.
- Presents results as qualitative insights, actionable fixes, or statistical data in documents.
SKILL.md
.github/skills/user-researchView on GitHub ↗
--- name: user-research license: MIT compatibility: "Claude Code 2.1.76+." description: "User personas, customer journey maps, interview guides, usability testing, and card sorting. Use when building user understanding, mapping customer experiences, planning user research sessions, or defining Jobs-to-Be-Done." tags: [persona, journey-map, user-interview, usability, jtbd, card-sort, empathy-map, research] context: fork agent: product-strategist version: 1.0.0 author: OrchestKit user-invocable: false disable-model-invocation: false complexity: medium persuasion-type: collaborative metadata: category: document-asset-creation allowed-tools: - Read - Glob - Grep - WebFetch - WebSearch --- # User Research Frameworks for building deep user understanding through structured research methods. Covers personas, journey mapping, interviews, usability testing, and Jobs-to-be-Done. ## Research Method Selection Choose the right method for your question: | Method | When to Use | Sample Size | Time | Output | |--------|-------------|-------------|------|--------| | User Interviews | Early discovery, deep understanding | 5-8 | 2-3 weeks | Qualitative insights | | Usability Testing | Validate designs, find issues | 5-10 | 1-2 weeks | Actionable fixes | | Surveys | Quantify attitudes, preferences | 100+ | 1-2 weeks | Statistical data | | Card Sorting | Information architecture | 15-30 | 1 week | IA recommendations | | A/B Testing | Compare alternatives | 1000+ | 2-4 weeks | Statistical winner | **Rule of thumb:** Start with interviews (5-8 participants) to discover unknowns. Switch to surveys once you have hypotheses to validate. ## Persona Quick Reference Personas are fictional composites built from research synthesis. Keep to 3-5 max. ```markdown ## Persona: [Name] ### Demographics - Age: [Range] - Role: [Job title] - Company: [Type/size] - Tech savviness: [Low/Medium/High] ### Quote > "[Characteristic statement that captures their mindset]" ### Goals 1. [Primary goal - what success looks like] 2. [Secondary goal] ### Pain Points 1. [Frustration with current state] 2. [Obstacle they face] ### Key Insight [The most important thing to remember about this persona] ``` **Incorrect — vague persona without goals:** ```markdown Persona: Sarah, Age 35, Marketing Manager. Likes social media and coffee. ``` **Correct — actionable persona with goals and pain points:** ```markdown Persona: DevOps Dana Quote: "I don't have time for tools that create more work than they save." Goals: Reduce deployment failures, give devs self-service capabilities Pain Points: Alert fatigue from false positives, context-switching between 10+ tools Key Insight: Evaluates tools by "time saved vs. time invested" — needs immediate value. ``` ## Journey Map Structure Maps the end-to-end experience for a specific persona and scenario. ```markdown ## Journey Map: [Journey Name] ### Persona + Scenario [Which persona | What they're trying to accomplish] ### Stages: Aware → Consider → Purchase → Onboard → Use → Retain For each stage: - **Touchpoints:** [Channel/interaction point] - **Actions:** [What user does] - **Emotions:** [Satisfied / Neutral / Frustrated] - **Pain Points:** [Friction] - **Opportunities:** [How we improve] ``` Common B2B SaaS stages: `Awareness → Evaluation → Purchase → Onboarding → Adoption → Expansion → Advocacy/Churn` ## JTBD Framework People don't buy products — they hire them to do specific jobs. **JTBD Statement Format:** ``` When [situation], I want to [motivation], so I can [expected outcome]. ``` **Example:** ``` When I'm preparing for a board review, I want to quickly see revenue trends, so I can answer questions confidently without scrambling for data. ``` **Job Dimensions:** | Dimension | Description | |-----------|-------------| | Functional | Practical task to accomplish | | Emotional | How the user wants to feel | | Social | How the user wants to be perceived | **Opportunity Score:** `Importance + (Importance - Satisfaction)` — scores > 10 indicate high-opportunity areas. ## Empathy Map Quick tool for building shared understanding in workshops: ``` +-------------------------+-------------------------------+ | SAYS | THINKS | | Direct quotes | Worries and concerns | | Questions asked | Aspirations | +-------------------------+-------------------------------+ | DOES | FEELS | | Observable actions | Emotional state | | Workarounds | Frustrations and delights | +-------------------------+-------------------------------+ | PAINS | GAINS | | Fears and obstacles | Wants and needs | +-------------------------+-------------------------------+ ``` ## Interview Best Practices | Do | Don't | |----|-------| | Ask open-ended questions | Ask leading questions | | Ask "why" and "how" | Accept surface answers | | Follow interesting threads | Stick rigidly to script | | Take verbatim notes | Paraphrase or interpret | **Standard interview arc:** Warm-up (5 min) → Context setting (10 min) → Deep dive (25 min) → Wrap-up (5 min) ## Rules (Load On-Demand) Read these files for detailed guidance: - [research-personas.md](rules/research-personas.md) — Persona template, empathy map, maintenance schedule - [research-journey-mapping.md](rules/research-journey-mapping.md) — Journey map template, service blueprints, experience curves - [research-user-interviews.md](rules/research-user-interviews.md) — Interview structure, usability testing, NPS/SUS, card sorting ## References - [interview-guide-template.md](references/interview-guide-template.md) — Ready-to-use interview guide template - [journey-map-workshop.md](references/journey-map-workshop.md) — Workshop facilitation guide - [user-story-workshop-guide.md](references/user-story-workshop-guide.md) — User story writing workshop ## Related Skills - `ork:write-prd` — Translate research insights into structured product requirements - `ork:product-frameworks` — Full PM framework suite (business cases, prioritization, metrics, OKRs) --- **Version:** 1.0.0
More from yonatangross/orchestkit
- agent-orchestrationAgent orchestration patterns for agentic loops, multi-agent coordination, alternative frameworks, and multi-scenario workflows. Use when building autonomous agent loops, coordinating multiple agents, evaluating CrewAI/AutoGen/Swarm, or orchestrating complex multi-step scenarios.
- ai-ui-generationAI-assisted UI generation patterns for json-render, v0, Bolt, and Cursor workflows. Covers prompt engineering for component generation, review checklists for AI-generated code, design token injection, refactoring for design system conformance, and CI gates for quality assurance. Use when generating UI components with AI tools, rendering multi-surface MCP visual output, reviewing AI-generated code, or integrating AI output into design systems.
- analyticsQuery cross-project usage analytics. Use when reviewing agent, skill, hook, or team performance across OrchestKit projects. Also replay sessions, estimate costs, and view model delegation trends.
- animation-motion-designAnimation and motion design patterns using Motion library (formerly Framer Motion) and View Transitions API. Use when implementing component animations, page transitions, micro-interactions, gesture-driven UIs, or ensuring motion accessibility with prefers-reduced-motion.
- architecture-patternsArchitecture validation and patterns for clean architecture, backend structure enforcement, project structure validation, test standards, and context-aware sizing. Use when designing system boundaries, enforcing layered architecture, validating project structure, defining test standards, or choosing the right architecture tier for project scope.
- ascii-visualizerASCII diagram patterns for architecture, workflows, file trees, and data visualizations. Use when creating terminal-rendered diagrams, box-drawing layouts, progress bars, swimlanes, or blast radius visualizations.
- assessAssesses and rates quality 0-10 with pros/cons analysis. Use when evaluating code, designs, or approaches.
- async-jobsAsync job processing patterns for background tasks, Celery workflows, task scheduling, retry strategies, and distributed task execution. Use when implementing background job processing, task queues, or scheduled task systems.
- audit-fullFull-codebase audit using 1M context window. Security, architecture, and dependency analysis in a single pass. Use when you need whole-project analysis.
- audit-skillsAudits all OrchestKit skills for quality, completeness, and compliance with authoring standards. Use when checking skill health, before releases, or after bulk skill edits to surface SKILL.md files that are too long, have missing frontmatter, lack rules/references, or are unregistered in manifests.