К основному содержанию
скилл CX Codex

user-research · yonatangross — скилл для Claude Code: personas, journey-maps, JTBD

Скилл user-research для структурированного исследования пользователей: персоны, карты пути, интервью, тестирование юзабилити и card sorting. Помогает понять, что нужно пользователям, и обоснованно проектировать продукт.

MIT 134 установок ★ 305 обновлён 2026-11-07

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add yonatangross/orchestkit --skill user-research -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/user-research/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/user-research/

По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.

user-research официальный anthropics Скилл user-research помогает планировать продуктовые исследования, составлять сценарии интервью и структурировать выводы. Пригодится при подготовке юзабилити-тестов и формулировании гипотез. CX Codex +1 4 300установок user-research Rudolf S. Скилл user-research помогает планировать исследования пользователей, анализировать интервью и переводить наблюдения в приоритизированные продуктовые задачи. CX Codex +1 ★ 587звёзд репо product-research claude-code-skills Скилл product-research помогает выбрать метод исследования под задачу, обосновать размер выборки и собрать инсайты из закодированных наблюдений без натяжек. CX Codex +1 213установок journey-mapping Prorise-cool Скилл journey-mapping строит карты пути клиентов и пользователей с точками контакта, эмоциями, болями и возможностями для улучшения опыта. CX Codex +1 1установок user-journey-mapping NickCrew Скилл user-journey-mapping для Claude Code помогает составить карту пути пользователя с этапами, точками контакта, эмоциями и проблемами. Запускается при анализе пользовательского опыта или конверсии. CX Codex +1 102установок journey-map Owl-Listener Скилл journey-map для Claude Code и Codex строит карту пути одной персоны: этапы, точки контакта, эмоции и боли. Закрывает редизайн существующего опыта. CX Codex +1 2 600установок user-personas phuryn Скилл user-personas синтезирует данные опросов или интервью в три профиля пользователей с JTBD, болями и метриками успеха. Пригодится продакт-менеджерам перед запуском фич. CX Codex +1 3 200установок customer-persona 101-skills Скилл customer-persona собирает персону покупателя из данных поиска: демография, психография, цели, боли в цифрах и аватар. Нужен портрет сегмента для стратегии или презентации. CX Codex +1 238установок

Из того же набора86

Весь набор →
interaction-patterns Скилл interaction-patterns для Claude Code помогает выбирать паттерны взаимодействия в интерфейсе. Подключается при работе с загрузкой данных, пагинацией, оверлеями и уведомлениями. CX Codex +1 160установок documentation-patterns Скилл documentation-patterns для Codex даёт шаблоны README, ADR, OpenAPI-документации и changelog. Помогает оформлять документацию проекта и записывать архитектурные решения. CX Codex +1 150установок okr-design Скилл okr-design для Claude Code помогает ставить цели и выбирать метрики успеха. Он подключается при работе с OKR, KPI и дизайном экспериментов. CX Codex +1 140установок figma-design-handoff Скилл figma-design-handoff для Claude Code помогает переносить макеты Figma в код и описывать компоненты. Включается при подготовке дизайн-токенов, разборе Dev Mode или сравнении интерфейса с макетом. CX Codex +1 136установок brainstorm Скилл brainstorm собирает варианты решения через параллельных агентов, фильтрует их по реализуемости и помогает сравнить компромиссы. Код он не строит и не чинит. CX Codex +1 133установок setup Скилл setup сканирует проект, определяет стек, советует скиллы и MCP-серверы, а затем считает готовность проекта. Есть режимы повторного сканирования и настройки. CX Codex +1 133установок testing-integration Скилл testing-integration помогает проверять границы API и сервисов: интеграционные тесты, контракты Pact и валидацию схем Zod. Включается при работе с тестами API или взаимодействием сервисов. CX Codex +1 131установок testing-llm Скилл testing-llm помогает тестировать функции с языковыми моделями: подменять ответы, оценивать качество RAG и проверять структурированный вывод. Включается при разработке тестов для ИИ-функций. CX Codex +1 126установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой