user-research · yonatangross — скилл для Claude Code: personas, journey-maps, JTBD
Скилл user-research для структурированного исследования пользователей: персоны, карты пути, интервью, тестирование юзабилити и card sorting. Помогает понять, что нужно пользователям, и обоснованно проектировать продукт.
MIT 134 установок ★ 305 обновлён 2026-11-07
npx skills add yonatangross/orchestkit --skill user-research -a claude-codeЧто делает user-research
user-research содержит готовые шаблоны и фреймворки для основных методов исследования. Персоны строятся из реальных данных и описывают не демографию, а цели и боли конкретного пользователя. Карты пути отображают весь цикл взаимодействия — от осознания проблемы до лояльности. JTBD-фреймворк переводит потребности в задачи: «когда [ситуация], я хочу [мотивация], чтобы [результат]».
Скилл включает таблицы для выбора метода по размеру выборки и времени, правила интервьюирования (открытые вопросы, глубокие «почему»), structure journey map по B2B SaaS циклам и empathy map для быстрого понимания в команде. Каждый метод привязан к конкретной задаче: интервью — для ранней гипотезы, опросы — для валидации, card sorting — для архитектуры интерфейса.
Доступны три набора подробных правил: research-personas.md для ведения персон, research-journey-mapping.md для сервис-блюпринтов, research-user-interviews.md для сценариев и метрик (NPS, SUS). Плюс готовые шаблоны интервью и гайды для workshop'ов. Скилл не требует дополнительных зависимостей — работает с встроенными инструментами Claude Code для чтения и поиска файлов.
Какие задачи решает
- построить персоны на основе реальных данных вместо угадывания
- отобразить весь путь пользователя от первого контакта до лояльности
- провести структурированное интервью и извлечь закономерности
- понять и сформулировать настоящую работу, которую наёмает пользователь
- организовать исследование: выбрать метод, размер выборки и временные рамки
Примеры запросов агенту
- Создай персону для DevOps-инженера: цели, боли и ключевой инсайт о том, как он оценивает инструменты
- Построй карту пути для сценария: B2B клиент узнал о продукте, оценивает его, покупает, внедряет, расширяет
- Напиши интервью-гайд для валидации гипотезы, что клиентам не хватает самообслуживания в развёртывании
Как установить user-research
1Через Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill user-research -a claude-code2Вручную: положить файлы
~/.claude/skills/user-research/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/user-research/
1Через Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill user-research -a codex2Вручную: положить файлы
.agents/skills/user-research/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill user-research -a cursor2Вручную: положить файлы
.cursor/skills/user-research/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install yonatangross/orchestkit src/skills/user-research2Вручную: положить файлы
.github/skills/user-research/SKILL.md1Через Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill user-research -a gemini-cli2Командой платформы
gemini skills install https://github.com/yonatangross/orchestkit --path src/skills/user-researchВручную: положить файлы
.devin/skills/user-research/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add yonatangross/orchestkit --skill user-research -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об user-research
Как установить user-research в Claude Code?
Запусти npx skills add yonatangross/orchestkit --skill user-research -a claude-code, затем открой ~/.claude/skills/user-research/SKILL.md.
Что делает user-research?
Предоставляет шаблоны и инструкции для исследования пользователей: персоны, journey maps, интервьюирование, JTBD-анализ, empathy maps и card sorting. Помогает выбрать нужный метод и провести исследование от начала до конца.
Какой размер выборки нужен для интервью?
Для интервью рекомендуется 5–8 участников на 2–3 недели. Это достаточно, чтобы обнаружить основные паттерны. Для surveys и A/B тестов нужны большие выборки — 100+ и 1000+ соответственно.
Исходный текст
SKILL.md · MIT
--- name: user-research license: MIT compatibility: "Claude Code 2.1.277+." description: "Personas, journey maps, interview guides, usability tests, card sorting and Jobs-to-Be-Done. Use when planning user research." user-invocable: false disable-model-invocation: false metadata: owner-agent: "product-strategist" category: document-asset-creation version: "1.0.0" author: "OrchestKit" complexity: "medium" tags: "persona, journey-map, user-interview, usability, jtbd, card-sort, empathy-map, research" 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
© OrchestKit · MIT · yonatangross/orchestkit
Похожие скиллы
Все скиллы по теме «Дизайн» →Сначала — user-research от других авторов.