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

usability-testing — скилл для Claude Code

Скилл usability-testing для Claude Code планирует и проводит тесты удобства на существующих и прототипных дизайнах. Помогает выявить проблемы до запуска с помощью модерируемых тестов, сценариев задач, наблюдения и анализа результатов.

MIT 319 установок ★ 1 107 обновлён 2026-10-19

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

Что делает usability-testing

Скилл охватывает пять фаз: выбор задач для тестирования, решение, модерировать тест или нет, набор участников и сам тест, затем синтез результатов. На входе ему нужны функциональный или близкий к функциональному прототип, конкретные задачи пользователей, целевая аудитория и выбранная платформа для тестирования.

Для модерируемых тестов скилл организует сессию: разминка, фоновые вопросы, выполнение задач с протоколированием мыслей вслух, постфактум-вопросы и обсуждение. Для немодерируемых — готовит сценарий и помогает анализировать записи в масштабе. Скилл выделяет критические проблемы (блокируют выполнение), главные (замедляют), промежуточные (требуют обхода) и косметические, затем ранжирует по приоритету.

Для ранних прототипов и сложных задач лучше модерируемый формат (5–8 участников). Для стабильных дизайнов и валидации — немодерируемый (15–30 участников). Скилл не подходит для генеративного исследования (для этого есть ux-research) и не заменяет конверсионную оптимизацию (cro-optimization).

Какие задачи решает

  • найти препятствия в дизайне до запуска в продакшн
  • выбрать между двумя вариантами интерфейса на основе поведения пользователей
  • разобраться, почему аналитика показывает падение на определённом экране
  • составить сценарий задач и провести модерируемый тест с пользователями
  • синтезировать результаты тестов и ранжировать проблемы по приоритету

Примеры запросов агенту

  • Проведи модерируемый тест удобства для нового экрана поиска. Помоги с сценариями задач и наблюдением.
  • Спланируй немодерируемый тест для мобильного прототипа. Напиши вопросы для 20 участников.
  • Синтезируй результаты пяти тестов: найди критические проблемы и дай рекомендации по приоритету.

Как установить usability-testing

1Через Skills CLI (Vercel)

npx skills add rampstackco/claude-skills --skill usability-testing -a claude-code

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

~/.claude/skills/usability-testing/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об usability-testing

Как установить usability-testing в Claude Code?

Выполни в терминале npx skills add rampstackco/claude-skills --skill usability-testing -a claude-code, затем найди SKILL.md в папке ~/.claude/skills/usability-testing/.

Что делает скилл usability-testing?

Помогает спланировать тесты удобства: выбрать задачи, решить, модерировать тест или нет, провести сессию с пользователями и синтезировать результаты в отчёт с приоритизацией проблем.

В чём отличие модерируемого и немодерируемого тестирования?

Модерируемый формат — исследователь наблюдает в реальном времени, задаёт уточняющие вопросы, хорош для ранних прототипов и сложных задач (5–8 участников). Немодерируемый — участник записывается, работает один, масштабируется до 15–30 участников, но меньше глубины.

Исходный текст

SKILL.md · MIT
---
name: usability-testing
description: "Plan and run usability tests on existing or prototype designs including test design, task scripts, moderation, observation, and findings synthesis. Use this skill whenever the user wants to test usability, run a moderated test, run an unmoderated test, validate a design, find usability issues, or improve task completion. Triggers on usability test, usability testing, moderated test, unmoderated test, task script, think aloud, prototype testing, user testing, design validation, task completion. Also triggers when the user has built something and wants to know if real users can use it before shipping."
category: research
catalog_summary: "Test design, moderation, findings reports"
display_order: 2
---

# Usability Testing

Plan and run tests that find usability problems before users hit them in production. Stack-agnostic. Tool-agnostic.

This skill is for testing existing designs or prototypes. For broader discovery research, use `ux-research`. For conversion testing in production, use `cro-optimization`.

---

## When to use

- Before launching a new flow or major redesign
- After a redesign to verify it doesn't introduce new problems
- When analytics show drop-off but you don't know why
- When customer support tickets pattern around specific UI areas
- Pre-launch user validation
- Comparing two design directions

## When NOT to use

- Discovery / generative research (use `ux-research`)
- Live conversion optimization (use `cro-optimization`)
- Mapping the broader experience (use `journey-mapping`)
- Pure quantitative measurement (use `analytics-strategy`)

---

## Required inputs

- The design or prototype to test (functional or near-functional)
- Specific tasks users would do
- The audience (who should be tested)
- Testing infrastructure (moderated tool, unmoderated tool, in-person setup)

---

## The framework: 5 phases

### 1. Define what to test

Don't test the whole product. Test specific tasks.

**Task selection criteria:**

- The task represents a real user goal (not "click around and explore")
- The task has a clear start and end
- The task is achievable in 2 to 10 minutes
- The task is one of: most common, most strategic, most problematic

**Examples of testable tasks:**

> "You want to find a contractor near you who can install a fence. Show me how you'd do that on this site."

> "You're a first-time visitor. You want to understand if this product fits your needs. Walk me through how you'd evaluate it."

> "Your team needs a new tool to manage projects. Use this site to figure out which plan is right for a 12-person team."

**Task framing rules:**

- State the user goal, not the system action ("find a place to stay" not "click the search button")
- Provide context (why are you doing this?)
- Don't reveal the path
- Don't use product terminology in the task framing

### 2. Choose moderated or unmoderated

**Moderated** (live, with researcher):

- Researcher observes and probes in real time
- Best for early-stage prototypes, complex tasks, novel concepts
- Higher cost, smaller sample (5 to 8 participants typical)
- Catches surprises and probe deeper

**Unmoderated** (recorded, asynchronous):

- Participant completes alone, often via tool (UserTesting, Maze, Lookback)
- Best for stable designs, simple tasks, larger sample
- Lower cost, larger sample (15 to 30 participants typical)
- Catches patterns at scale, less depth per session

For most teams: moderated for early/critical decisions, unmoderated for ongoing validation.

### 3. Recruit

Target audience - not just convenience.

**Recruit criteria:**

- Match real users (target audience, not just "anyone")
- Mix of experience levels with the product (new and existing if applicable)
- Mix of relevant device types (mobile, desktop, tablet if relevant)
- Exclude friends, family, employees

**Sample size:**

- Moderated: 5 to 8 participants (Nielsen's "5 users find 85% of usability issues" for the most common segment)
- Unmoderated: 15 to 30 participants (more participants compensate for less probing)
- Multi-segment testing: 5 to 8 per segment

### 4. Run the test

**Pre-task setup:**

- Confirm recording works
- Brief participant (purpose, anonymity, recording, "no wrong answers")
- Get verbal consent
- Have participant share screen if remote

**Moderated session structure:**

1. **Warm-up** (2 to 3 min). Easy questions to put participant at ease.
2. **Pre-test questions** (3 to 5 min). Background context, current behavior with similar products.
3. **Task 1** (5 to 10 min). Describe task. Have participant attempt while thinking aloud.
4. **Post-task questions** (1 to 2 min). What was easy/hard? Anything confusing?
5. **Repeat for tasks 2, 3, 4** (typically 3 to 5 tasks per 60-minute session).
6. **Overall debrief** (5 to 10 min). General reactions, comparisons to alternatives, anything else.
7. **Close** (2 min).

**Moderation principles:**

- Encourage think-aloud ("What's going through your mind?")
- Don't help unless they're truly stuck (and even then, only after a long pause)
- Don't lead ("Are you looking for the menu?" - bad)
- Note where they hesitate, scroll, or backtrack
- Note their language vs the product's language
- Note emotional reactions

**Anti-patterns:**

- Talking too much (researcher should talk maybe 20% of the time)
- Defending the design when participants struggle
- Helping prematurely
- Asking participants to predict their future behavior
- Treating participant suggestions as features ("Users want X" - test demand for X separately)

### 5. Synthesize and report

Patterns across participants are signal. Single-participant complaints are weaker (but worth investigating).

**Synthesis steps:**

1. **Issue inventory.** Every issue observed, with which participant, which task, severity.
2. **Cluster.** Issues that are the same root problem.
3. **Severity.**
   - **Critical:** Blocks task completion. Most users hit this.
   - **Major:** Significantly slows task. Many users hit this.
   - **Minor:** Friction. Some users hit this. Workaround exists.
   - **Cosmetic:** Polish. Doesn't affect task.
4. **Recommendations.** For each issue, propose specific fixes.
5. **Prioritize.** By severity and effort.

**Report structure:**

```markdown
# Usability Test: [Design / flow]

## Summary
[2 to 3 paragraphs covering: what was tested, headline findings, top 3 priorities]

## Method
[Moderated/unmoderated, sample size, audience, dates, tasks]

## Critical findings
[Each with description, frequency, supporting evidence (quotes/clips), recommendation. Where evidence was not obtained, state the gap per the data-availability rule]

## Major findings
[Same structure]

## Minor findings
[Brief]

## Cosmetic findings
[Briefest]

## What worked well
[Calibration: capture successes too]

## Recommendations
[Prioritized list with effort estimates]

## Next steps
[Test re-run schedule, design iteration plan]
```

---

## Workflow

1. **Define the goals.** What decisions hinge on this? What tasks matter most?
2. **Design tasks.** 3 to 5 specific, realistic, goal-framed tasks.
3. **Choose moderated vs unmoderated.** Match to stage and depth needed.
4. **Recruit.** Specific to audience.
5. **Pilot.** 1 to 2 sessions before main batch. Refine tasks if needed.
6. **Run.** Follow the protocol. Stay disciplined.
7. **Synthesize during, not just after.** Patterns emerge by session 4 or 5.
8. **Report.** Multiple formats - written report + highlight clips.
9. **Track fixes.** Every critical issue should have an owner and date.
10. **Re-test after fixes.** Verify the fix worked, didn't introduce new issues.

---

## Failure patterns

- **Testing the whole product instead of specific tasks.** Vague results.
- **Tasks that reveal the path.** ("Click the menu and find...")
- **Friends and family as participants.** Biased, not representative.
- **Researcher leading the participant.** Findings reflect the researcher.
- **Defending the design when participants struggle.** Misses real issues.
- **Helping too quickly.** Participant doesn't experience the friction.
- **Treating participant suggestions as features.** Users solve their problem; product team designs the solution.
- **One participant = data point.** A single strong opinion isn't a finding.
- **Skipping severity scoring.** All findings treated equally; team can't prioritize.
- **Reports no one reads.** Highlight clips and live walkthroughs work better than 80-page decks.
- **Testing once, never re-testing.** Fixes that introduce new problems go undetected.

---

## Output format

Default outputs:

1. **Test plan** (before testing) - `usability-test-plan-[topic].md`
2. **Task script** (per session) - `usability-tasks-[topic].md`
3. **Findings report** (after synthesis) - `usability-findings-[topic].md`
4. **Highlight clips** (separately produced)

---

## If required data is unavailable

This skill's output depends on data, measurements, or tool results it cannot generate on its own. When a required input, tool, or data source is unavailable or unverifiable, the sanctioned output is the deliverable with the gap stated: what was needed, what was actually obtained or verified, and which parts of the output are affected. Fabricating, estimating, or interpolating a required number to complete the deliverable is never sanctioned. A stated gap is a complete answer.

---

## Reference files

- [`references/task-script-patterns.md`](references/task-script-patterns.md) - Task framing patterns by common product type, with good and bad examples.

© rampstackco · MIT · rampstackco/claude-skills

Похожие скиллы

Все скиллы по теме «Дизайн» →
usability-tester daffy0208 Скилл usability-tester помогает спланировать юзабилити-тест, составить реалистичные сценарии заданий и оценить серьёзность найденных проблем UX. CX Codex +1 188установок usability-check haabe Скилл usability-check проверяет экранный интерфейс по 10 эвристикам Нильсена и выдаёт таблицу pass/partial/fail — пригодится перед сдачей UI-работы. CX Codex +1 ★ 54звёзд репо nielsen-usability-heuristics dembrandt Скилл nielsen-usability-heuristics оценивает интерфейсы и текст ошибок по 10 эвристикам Нильсена. Скилл помогает выявить проблемы юзабилити прямо в коде компонентов до релиза. CX Codex +1 1 200установок ux-usability-foundations hueyexe Скилл ux-usability-foundations учит агента проектировать и рецензировать интерфейсы с точки зрения продуктовой логики, обратной связи и защиты от ошибок пользователя. CX Codex +1 667установок aesthetic-usability Owl-Listener Скилл aesthetic-usability помогает оценить, как визуальная цельность интерфейса влияет на ощущение удобства и доверия. Нужен при разборе слабых первых впечатлений от работающего дизайна. CX Codex +1 2 300установок design-sprint pmprompt Скилл design-sprint для Claude Code проводит пятидневный дизайн-спринт по методике Jake Knapp из Google Ventures: превращает идею в прототип, проверенный реальными пользователями. CX Codex +1 361установок

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

Весь набор →
launch-runbook Скилл launch-runbook для Claude Code составляет и проводит структурированный запуск: проверки перед go-live, процедуры отключения DNS, мониторинг после запуска и откат. Описывает запуск сайта, продукта или крупного релиза. CX Codex +1 325установок interactive-product-tour Скилл interactive-product-tour для Claude Code помогает проектировать продуктовые туры, тултипы и контекстную помощь. Включается при разработке логики триггеров, архитектуры тура или системы подсказок с нуля. CX Codex +1 324установок content-and-copy Скилл content-and-copy помогает писать и редактировать статьи, руководства и тексты для разделов сайта с упором на чёткую структуру, фактуру и тон бренда. CX Codex +1 324установок brand-archetype-system Скилл brand-archetype-system применяет готовые архетипы брендов — наборы цветов, типографики, голоса и композиции — чтобы быстро начать работу над визуальной и словесной идентичностью. CX Codex +1 323установок onboarding-wizard-design Скилл onboarding-wizard-design помогает спроектировать пошаговый онбординг для SaaS-продуктов. Фокусируется на доведении пользователя до первого ценного результата без перегрузки лишними шагами. CX Codex +1 316установок ux-research Скилл ux-research помогает спланировать качественные исследования пользователей, составить вопросы для интервью и разобрать сырые заметки на продуктовые выводы. CX Codex +1 314установок long-form-content-frameworks Скилл long-form-content-frameworks помогает выстроить структуру отдельных лонгридов: от белых книг и кейс-стади до подробных гайдов. Убирает лишнюю воду и академический балласт из черновиков. CX Codex +1 313установок ads-performance-analytics Скилл ads-performance-analytics помогает разбирать отчёты по платной рекламе, сверять атрибуцию и не принимать решения о бюджете по одной цифре. CX Codex +1 313установок

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

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