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

ux-friction-analyzer — скилл для Claude Code: возможности и установка

Скилл ux-friction-analyzer проверяет интерфейсы на когнитивную нагрузку, точки трения и соответствие гештальт-принципам. Пригодится при проектировании новых экранов или адаптации сценариев под СДВГ.

MIT 266 установок ★ 274 обновлён 2026-10-30

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

Что делает ux-friction-analyzer

Скилл разбирает пути пользователей по закону Фиттса, теории когнитивной нагрузки и правилам гештальт-психологии. В анализе учитываются размеры кликабельных зон (от 44x44 пикселей для мобильных тач-таргетов), группировка элементов через близость и сходство, а также снижение лишней нагрузки за счёт умных умолчаний. Отдельный упор сделан на принципы дизайна для людей с СДВГ: автосохранение, скрытие лишних шагов и спокойные уведомления без паники.

Методология включает построение дерева решений с оценкой вероятностей переходов и оценкой трения по шкале от 1 до 10 для каждого шага. Инструмент оценивает время удержания состояния потока и риски прерываний.

Этот скилл только находит проблемы сценария и предлагает логику, но сам не генерирует стили интерфейса и не пишет код фронтенда.

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

  • найти точки трения и лишние шаги в пользовательском сценарии
  • адаптировать интерфейс для людей с СДВГ через автосохранение и пошаговый показ
  • проверить размеры кликабельных элементов и угловые зоны по закону Фиттса
  • построить дерево решений с вероятностями и баллами когнитивной нагрузки

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

  • Сделай friction audit для сценария оформления заказа
  • Проверь интерфейс настроек на когнитивную нагрузку и соответствие принципам СДВГ
  • Построй дерево решений для онбординга новых пользователей

Как установить ux-friction-analyzer

1Через Skills CLI (Vercel)

npx skills add curiositech/some_claude_skills --skill ux-friction-analyzer -a claude-code

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

~/.claude/skills/ux-friction-analyzer/SKILL.md

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

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

Вопросы об ux-friction-analyzer

Как установить ux-friction-analyzer в Claude Code?

Выполните в терминале команду npx skills add curiositech/some_claude_skills --skill ux-friction-analyzer -a claude-code. Также можно вручную сохранить файл по пути ~/.claude/skills/ux-friction-analyzer/SKILL.md.

Что делает скилл ux-friction-analyzer?

Он анализирует интерфейсы по законам когнитивной психологии, гештальт-принципам и теории потока, выявляя перегруженные этапы сценариев.

Генерирует ли ux-friction-analyzer визуальный дизайн или код компонентов?

Нет, скилл предназначен только для аналитики и аудита интерфейсов. Для вёрстки и технической реализации рекомендаций автор советует подключать другие скиллы.

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

SKILL.md · MIT
---
name: ux-friction-analyzer
description: Comprehensive UX analysis using cognitive psychology, ADHD-friendly design, Gestalt principles, and flow state engineering. Specializes in friction audits, user journey simulation, cognitive
  load optimization, and Fitts' Law application. Activate on "analyze UX", "friction audit", "user journey", "ADHD-friendly", "optimize flow", "reduce cognitive load", "UX audit", "conversion optimization".
  NOT for visual design execution (use web-design-expert), A/B testing implementation (use frontend-developer), or accessibility compliance auditing (use accessibility-auditor).
allowed-tools: Read,Write,Edit,WebFetch
metadata:
  category: Design & Creative
  pairs-with:
  - skill: web-design-expert
    reason: Implement UX recommendations
  - skill: adhd-design-expert
    reason: Deep neurodivergent design patterns
  - skill: frontend-developer
    reason: Technical implementation of UX fixes
  tags:
  - ux
  - accessibility
  - cognitive-load
  - adhd-friendly
  - user-research
---

# UX Friction Analyzer

A comprehensive skill for analyzing and optimizing user experience through cognitive psychology, ADHD-friendly design, and flow state engineering.

## Activation

Use this skill when:
- Designing new interfaces or user flows
- Auditing existing UX for friction points
- Optimizing for neurodivergent users (ADHD, autism)
- Simulating user journeys before building
- Reducing cognitive load in complex applications

Trigger phrases: "analyze UX", "friction audit", "user journey", "ADHD-friendly", "optimize flow", "reduce cognitive load"

---

## Core Frameworks

### 1. ADHD-Friendly Design Principles

Apply these patterns to ALL interfaces:

| Principle | Implementation | Why It Matters |
|-----------|----------------|----------------|
| **Progressive Disclosure** | Show one task at a time; hide future steps | Prevents overwhelm, maintains focus |
| **Context Preservation** | Auto-save every keystroke; never lose work | Reduces anxiety about losing progress |
| **Gentle Reminders** | Status updates, not alarms; no red urgency | Avoids panic, maintains calm |
| **Pause & Resume** | Session state persists across days/weeks | Respects inconsistent schedules |
| **Minimal Distractions** | Single focus area; dim non-active panels | Reduces competing stimuli |
| **Chunked Progress** | Visual cards/steps, not endless scrolling | Creates completion dopamine hits |
| **Predictable Navigation** | Same layout always; no surprises | Reduces reorientation cost |
| **Calm Mode Option** | Reduced animations, muted colors on demand | Accommodates sensory sensitivity |

### 2. Gestalt Psychology

Apply these perception principles:

```
PROXIMITY
─────────
Elements close together = perceived as related
White space creates natural boundaries

┌─────────┐  ┌─────────┐     ┌─────────┐  ┌─────────┐
│ Related │  │ Related │     │ Other   │  │ Other   │
│ Item A  │  │ Item B  │     │ Group A │  │ Group B │
└─────────┘  └─────────┘     └─────────┘  └─────────┘
     ↑ CLOSE = GROUPED            ↑ SEPARATE = DISTINCT

SIMILARITY
──────────
Same color/shape/size = perceived as related function

┌──────┐  ┌──────┐  ┌──────┐     ┌──────┐  ┌──────┐
│ BLUE │  │ BLUE │  │ BLUE │     │ CORAL│  │ CORAL│
│ Save │  │ Copy │  │ Edit │     │ Del  │  │ Clear│
└──────┘  └──────┘  └──────┘     └──────┘  └──────┘
     ↑ SAME = Related actions         ↑ DIFFERENT = Destructive

CONTINUITY
──────────
Eye follows lines/paths naturally

Step 1 ──→ Step 2 ──→ Step 3 ──→ Complete
   ●──────────●──────────●──────────●

CLOSURE
───────
Brain completes incomplete shapes
Use for progress indicators, loading states

[ ████████░░░░░░░░ ] 50% - brain "sees" the end
```

### 3. Cognitive Load Theory

Three types of mental load to manage:

| Type | Definition | Strategy |
|------|------------|----------|
| **Intrinsic** | Task complexity itself | Can't eliminate; acknowledge it |
| **Extraneous** | Poor design adding effort | ELIMINATE THIS - your job |
| **Germane** | Learning/understanding | Minimize for repeat users |

**Working Memory Limits:**
- 7±2 items maximum (Miller's Law)
- 4 chunks optimal for complex tasks
- Micro-breaks every 25 minutes

**Reduce Extraneous Load By:**
- Removing unnecessary choices
- Using recognition over recall
- Providing smart defaults
- Eliminating decorative elements that don't inform

### 4. Fitts' Law

Time to acquire target = f(Distance / Size)

```
IMPLICATIONS FOR BUTTONS:
─────────────────────────

  ┌───────────────────┐          vs          ┌──┐
  │     GENERATE      │                      │Go│
  │                   │                      └──┘
  └───────────────────┘
         ↑                                     ↑
  44px+ touch target                   Hard to hit
  Easy to acquire                      Frustrating

MINIMUM SIZES:
- iOS: 44x44 CSS pixels
- Android: 48x48 CSS pixels
- Desktop: 32x32 minimum, 44x44 preferred

EDGE TARGETS ARE INFINITE:
  ┌─────────────────────────────────────────────────────┐
  │ ■ LOGO                                    MENU ■   │
  │                                                     │
  │   Screen edges = can't overshoot                   │
  │   Place critical actions at corners/edges          │
  │                                                     │
  │ ■ HELP                                  EXPORT ■   │
  └─────────────────────────────────────────────────────┘

ICON + LABEL > ICON ALONE:
- Larger target area
- Reduced ambiguity
- Faster acquisition
```

### 5. Flow State Engineering

**Key Metrics:**
- 15-25 minutes to enter flow state
- 23 minutes to recover from interruption
- 40% productivity loss with frequent interruptions
- Only 41% of work time spent in flow (McKinsey)

**Flow Conditions:**
1. Clear goals for the current task
2. Immediate feedback on actions
3. Balance between challenge and skill
4. No anxiety about failure

**Preserve Flow By:**
- Background processing (don't block UI)
- Push notifications when ready (bring user back faster)
- Quick re-orientation panels after breaks
- Auto-save eliminating "save anxiety"
- Undo everything (confidence to experiment)

---

## Analysis Methodology

### Step 1: Create Decision Tree

Map every user path with probabilities:

```
                    ┌─────────────┐
                    │ USER LANDS  │
                    └──────┬──────┘
                           │
           ┌───────────────┼───────────────┐
           ▼               ▼               ▼
     ┌──────────┐   ┌──────────┐   ┌──────────┐
     │ Action A │   │ Action B │   │ Action C │
     │  (40%)   │   │  (45%)   │   │  (15%)   │
     └────┬─────┘   └────┬─────┘   └────┬─────┘
          │              │              │
          ▼              ▼              ▼
        [Next]         [Next]         [Next]
```

**For each edge, record:**
- Probability (%)
- Friction score (1-10)
- Time to complete (seconds/minutes)
- Cognitive load (low/medium/high)

### Step 2: Simulate User Journeys

Create detailed simulations for each persona:

**Template:**
```
TIME    ACTION                           COGNITIVE STATE           FRICTION
─────────────────────────────────────────────────────────────────────────────
0:00    [User action]                    [Mental state]            Low/Med/High
        └─ [System response or UI shown]

0:15    [Next action]                    [How they feel]           Low/Med/High
        └─ [What happens]
        └─ PROBLEM: [Friction point if any]

...continue...
─────────────────────────────────────────────────────────────────────────────
TOTAL TIME: X minutes
FRICTION POINTS: N (list them)
ABANDONMENT RISKS: N (critical moments)
DELIGHT MOMENTS: N (positive surprises)
```

**Personas to simulate:**
1. **Expert User** - Knows the system, moving fast
2. **New User** - First time, needs guidance
3. **Distracted User** - Context switching, interruptions
4. **Explorer** - No goal, seeing what's possible
5. **Completer** - Trying to finish, hitting obstacles

### Step 3: Friction Analysis Matrix

Quantify and prioritize:

| Friction Point | Users Affected | Severity (1-10) | Fix Difficulty | Priority Score |
|----------------|---------------|-----------------|----------------|----------------|
| [Issue 1]      | X%            | N               | Easy/Med/Hard  | HIGH/MED/LOW   |
| [Issue 2]      | X%            | N               | Easy/Med/Hard  | HIGH/MED/LOW   |

**Priority Formula:**
```
Priority = (Users Affected × Severity) / Fix Difficulty
```

### Step 4: Impedance Mapping

Compare current vs ideal:

```
TASK                          CURRENT IMPEDANCE     IDEAL IMPEDANCE
────────────────────────────────────────────────────────────────────
[Task 1]                      Low (X sec)           ✓ Optimal
[Task 2]                      Medium (X sec)        Could be Y sec
[Task 3]                      HIGH (X min)          Should be Y sec
```

### Step 5: Time-Loss Analysis

Calculate context switch costs:

```
Action                        Frequency    Time Lost Each    Total Impact
─────────────────────────────────────────────────────────────────────────
[Interruption type 1]         X/session    Y min             Z min
[Interruption type 2]         X/session    Y min             Z min
─────────────────────────────────────────────────────────────────────────
TOTAL CONTEXT SWITCH LOSS                                    Z min/session
```

---

## Optimization Patterns

### Immediate Fixes (Low Effort, High Impact)

1. **Giant CTA on Landing**
   ```html
   <button class="cta" style="min-height: 60px; min-width: 200px;">
     Primary Action
     <span class="subtext">Supporting text</span>
   </button>
   ```

2. **Visible Edit Affordances**
   - Show pencil/edit icons by default, not just on hover
   - Add tooltips: "Click to edit"

3. **Auto-Fill Prompts**
   - After user completes 1 item manually, offer to auto-complete rest
   - "Want me to fill in the remaining X items?"

4. **Floating Action Buttons**
   - Critical actions always visible (not buried in menus)
   - Bottom-right for mobile thumb zone

5. **Progress Indicators**
   - Show "Step X of Y" always
   - Visual progress bar at top

### Medium-Term Improvements

1. **Re-Orientation Panels**
   ```
   ┌─────────────────────────────────────────────┐
   │  Welcome back! Here's where you left off:  │
   │                                            │
   │  ✓ Step 1: Complete                        │
   │  → Step 2: In progress (60%)               │
   │  ○ Step 3: Not started                     │
   │                                            │
   │  [Continue where I left off]               │
   └─────────────────────────────────────────────┘
   ```

2. **Keyboard Shortcuts**
   - Number keys for mode switching (1, 2, 3...)
   - Cmd+Enter for primary action
   - Escape for cancel/close

3. **Background Processing**
   - Never block UI for long operations
   - Show progress, allow user to continue
   - Push notification when complete

4. **Smart Defaults**
   - Pre-fill based on user history
   - Remember last-used settings
   - Suggest most common option first

### Long-Term Vision

1. **Predictive UI**
   - Anticipate next action based on patterns
   - Pre-load likely next screens
   - Suggest before user asks

2. **Personalized Complexity**
   - Simple mode for new users
   - Power user mode unlocks over time
   - User controls their complexity level

3. **Accessibility Suite**
   - High contrast mode
   - Reduced motion option
   - Screen reader optimization
   - Keyboard-only navigation

---

## Checklist for New Features

Before shipping any feature, verify:

### Cognitive Load
- [ ] Can user complete with ≤4 things in working memory?
- [ ] Are there unnecessary choices that could be defaults?
- [ ] Is recognition used instead of recall?

### ADHD-Friendly
- [ ] Can user pause and resume without losing context?
- [ ] Are there gentle progress indicators (not anxiety-inducing)?
- [ ] Is the interface calm (not visually noisy)?

### Fitts' Law
- [ ] Are primary buttons ≥44px tall?
- [ ] Are destructive actions away from common paths?
- [ ] Do buttons have labels, not just icons?

### Flow Preservation
- [ ] Does any action block the UI for &gt;2 seconds?
- [ ] Can long operations run in background?
- [ ] Is there a clear "done" state?

### Error Recovery
- [ ] Can every action be undone?
- [ ] Are error messages actionable (not just "Error")?
- [ ] Is auto-save enabled?

---

## Example Analysis Output

When running this skill, produce a document with:

1. **Executive Summary** - Key findings in 3 bullets
2. **Decision Tree** - All user paths with probabilities
3. **User Journey Simulations** - 3-5 personas, full timeline
4. **Friction Matrix** - Prioritized issues table
5. **Optimization Recommendations** - Immediate/Medium/Long-term
6. **Implementation Checklist** - Specific changes to make

---

## Integration Points

- **web-design-expert**: Implement UX recommendations visually
- **adhd-design-expert**: Deep neurodivergent design patterns
- **frontend-developer**: Technical implementation of fixes
- **diagramming-expert**: Create user flow diagrams

---

## Sources

- [NN/g: Minimize Cognitive Load](https://www.nngroup.com/articles/minimize-cognitive-load/)
- [NN/g: Fitts's Law](https://www.nngroup.com/articles/fitts-law/)
- [Laws of UX](https://lawsofux.com/)
- [IxDF: Gestalt Principles](https://www.interaction-design.org/literature/topics/gestalt-principles)
- [Stack Overflow: Developer Flow State](https://stackoverflow.blog/2018/09/10/developer-flow-state-and-its-impact-on-productivity/)
- [Medium: ADHD UX Design](https://medium.com/design-bootcamp/ux-design-for-adhd-when-focus-becomes-a-challenge-afe160804d94)

---

**Core Philosophy**: Every click, every second of confusion, every moment of "where am I?" is friction stealing from your users. Design for the distracted, optimize for the overwhelmed, and everyone benefits.

© curiositech · MIT · curiositech/some_claude_skills

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

Все скиллы по теме «Дизайн» →
ux-friction dylantarre Скилл ux-friction для Claude Code, Cursor и других IDE диагностирует, когда анимация замораживает интерфейс, запутывает пользователя или тормозит выполнение задачи. Проверяет тайминг, подсказки и сигналы состояния по принципам анимации. CX Codex +1 551установок millers-law Owl-Listener Скилл millers-law для Claude Code группирует поля, пункты меню и шаги по смысловым блокам. Он включается при проектировании структуры интерфейса. CX Codex +1 2 100установок hicks-law Owl-Listener Скилл hicks-law для Claude Code применяет закон Хика: время решения растёт с числом одновременных вариантов. Смотрит макет, предлагает сократить число решений — пункты, кнопки, шаги. CX Codex +1 2 100установок screenshot-interaction-analyzer davila7 Субагент screenshot-interaction-analyzer для Claude Code, который читает скриншоты интерфейсов и описывает кликабельные элементы, навигацию, переходы состояний и пути взаимодействия пользователя. CX Codex 414установок uizze-ui UIZZE Скилл uizze-ui для Claude Code направляет агента при вёрстке интерфейсов, исправлении сетки и проверке состояний экрана. Дорабатывает дизайн компонентов без затрагивания логики бэкенда. CX Codex +1 367 700установок ux-heuristics wondelai Скилл ux-heuristics для Claude Code оценивает юзабилити интерфейсов по принципам Nielsen и Krug. Включается при проблемах с навигацией, формами или понятностью интерфейса. CX Codex +1 10 800установок

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

Весь набор →
crisis-response-protocol Скилл crisis-response-protocol помогает внедрить оценку кризисных сигналов и многоуровневые ответы в ИИ-коучинг. Нужен при разработке функций безопасности для таких чатов. CX Codex +1 274установок partner-text-coach Скилл partner-text-coach для Claude Code и Codex разбирает эмоциональный подтекст сообщений партнёра и предлагает варианты ответа. Помогает подобрать слова и снизить напряжение в переписке. CX Codex +1 271установок hand-drawn-infographic-creator Скилл hand-drawn-infographic-creator для Claude Code создаёт схемы и инфографику в стиле анатомического блокнота для материалов о восстановлении, нейронауке и социальных ситуациях. CX Codex +1 269установок fancy-yard-landscaper Скилл fancy-yard-landscaper для Claude Code разбирает фотографии двора, подбирает растения с учётом климата и условий и рисует план посадок. Помогает спланировать посадки на конкретном участке. CX Codex +1 268установок color-contrast-auditor Скилл color-contrast-auditor находит пары цветов, которые не проходят WCAG 2.1, и предлагает исправления. Пригодится перед релизом, при аудите CSS или когда текст на скриншоте не читается. CX Codex +1 262установок playwright-screenshot-inspector Скилл playwright-screenshot-inspector для визуального тестирования веб-интерфейсов: запускает Playwright в headless-режиме, делает скриншоты и анализирует их через мультимодальную модель. CX Codex +1 262установок tech-entrepreneur-coach-adhd Скилл tech-entrepreneur-coach-adhd для Claude Code помогает разработчику с СДВГ перейти от работы в крупной техкомпании к своему приложению. Активируется на запросы о стартапе, MVP и монетизации. CX Codex +1 260установок refactoring-surgeon Скилл refactoring-surgeon для Claude Code находит запахи кода и меняет его структуру, сохраняя поведение. Очищает legacy-код и сокращает дублирование. CX Codex +1 260установок

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

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