MCPInstall

ux-friction-analyzer

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).

Installs
255
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/curiositech/some_claude_skills --skill ux-friction-analyzer
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads ux-friction-analyzer automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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:

PrincipleImplementationWhy It Matters
Progressive DisclosureShow one task at a time; hide future stepsPrevents overwhelm, maintains focus
Context PreservationAuto-save every keystroke; never lose workReduces anxiety about losing progress
Gentle RemindersStatus updates, not alarms; no red urgencyAvoids panic, maintains calm
Pause & ResumeSession state persists across days/weeksRespects inconsistent schedules
Minimal DistractionsSingle focus area; dim non-active panelsReduces competing stimuli
Chunked ProgressVisual cards/steps, not endless scrollingCreates completion dopamine hits
Predictable NavigationSame layout always; no surprisesReduces reorientation cost
Calm Mode OptionReduced animations, muted colors on demandAccommodates 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:

TypeDefinitionStrategy
IntrinsicTask complexity itselfCan't eliminate; acknowledge it
ExtraneousPoor design adding effortELIMINATE THIS - your job
GermaneLearning/understandingMinimize 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 PointUsers AffectedSeverity (1-10)Fix DifficultyPriority Score
[Issue 1]X%NEasy/Med/HardHIGH/MED/LOW
[Issue 2]X%NEasy/Med/HardHIGH/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

    <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 >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


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.

FAQ

What does the ux-friction-analyzer skill do?

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).

How do I install ux-friction-analyzer?

Run npx skills add https://github.com/curiositech/some_claude_skills --skill ux-friction-analyzer in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/ux-friction-analyzer/ (personal) or .claude/skills/ux-friction-analyzer/ (project).

Which AI agents can use ux-friction-analyzer?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is ux-friction-analyzer safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains ux-friction-analyzer?

It is published by curiositech in curiositech/some_claude_skills. It has 255 recorded installs.

More from curiositech/some_claude_skills

View all →

video-processing-editing

curiositech/some_claude_skills

FFmpeg automation for cutting, trimming, concatenating videos. Audio mixing, timeline editing, transitions, effects. Export optimization for YouTube, social media. Subtitle handling, color grading, batch processing. Use for videogen projects, content creation, automated video production. Activate on "video editing", "FFmpeg", "trim video", "concatenate", "transitions", "export optimization". NOT for real-time video editing UI, 3D compositing, or motion graphics.

Media & Creative1.4K installs

interior-design-expert

curiositech/some_claude_skills

Expert interior designer with deep knowledge of space planning, color theory (Munsell, NCS), lighting design (IES standards), furniture proportions, and AI-assisted visualization. Use for room layout optimization, lighting calculations, color palette selection for interiors, furniture placement, style consultation. Activate on "interior design", "room layout", "lighting design", "furniture placement", "space planning", "Munsell color". NOT for exterior/landscape design, architectural structure, web/UI design (use web-design-expert), brand color theory (use color-theory-palette-harmony-expert), or building codes/permits.

Frontend & Design1.1K installs

cv-creator

curiositech/some_claude_skills

Professional CV and resume builder transforming career narratives into ATS-optimized, multi-format resumes. Integrates with career-biographer for data and competitive-cartographer for positioning. Generates PDF, DOCX, LaTeX, JSON Resume, HTML, and Markdown. Activate on 'resume', 'CV', 'ATS optimization', 'job application'. NOT for cover letters, portfolio websites (use web-design-expert), LinkedIn optimization, or interview preparation.

Docs & Writing777 installs

personal-finance-coach

curiositech/some_claude_skills

Expert personal finance coach with deep knowledge of tax optimization, investment theory (MPT, factor investing), retirement mathematics (Trinity Study, SWR research), and wealth-building strategies grounded in academic research. Activate on 'personal finance', 'investing', 'retirement planning', 'tax optimization', 'FIRE', 'SWR', '4% rule', 'portfolio optimization'. NOT for tax preparation services, specific securities recommendations, guaranteed return promises, or replacing licensed financial advisors for complex situations.

Business & Finance772 installs

photo-composition-critic

curiositech/some_claude_skills

Expert photography composition critic grounded in graduate-level visual aesthetics education, computational aesthetics research (AVA, NIMA, LAION-Aesthetics, VisualQuality-R1), and professional image analysis with custom tooling. Use for image quality assessment, composition analysis, aesthetic scoring, photo critique. Activate on "photo critique", "composition analysis", "image aesthetics", "NIMA", "AVA dataset", "visual quality". NOT for photo editing/retouching (use native-app-designer), generating images (use Stability AI directly), or basic image processing (use clip-aware-embeddings).

Media & Creative644 installs

pwa-expert

curiositech/some_claude_skills

Progressive Web App development with Service Workers, offline support, and app-like behavior. Use for caching strategies, install prompts, push notifications, background sync. Activate on "PWA", "Service Worker", "offline", "install prompt", "beforeinstallprompt", "manifest.json", "workbox", "cache-first". NOT for native app development (use React Native), general web performance (use performance docs), or server-side rendering.

AI & Agents546 installs

Popular frontend & design skills

View category →

setup-matt-pocock-skills

mattpocock/skills

Configure this repo for the engineering skills: set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.

Frontend & Design1.1M installs

frontend-design

anthropics/skills

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

OfficialFrontend & Design1M installs

hyperframes-animation

heygen-com/hyperframes

All animation knowledge for HyperFrames — atomic motion rules, multi-phase scene blueprints, scene transitions, broader motion-design techniques, AND the seven runtime adapters (GSAP default, plus Lottie, Three.js, Anime.js, CSS keyframes, Web Animations API, TypeGPU). Use for any motion or animation task: pick 2-4 rules and compose, or load a blueprint, or look up runtime-specific API (e.g. GSAP eases / Lottie player / Three.js mixer). Also covers auditing an existing composition's choreography (animation map) and 24 named text-animation effects. HyperFrames-native: single paused timeline, seek-safe, deterministic.

prototype

mattpocock/skills

Build a throwaway prototype to answer a design question. Use when the user wants to sanity-check whether a state model or logic feels right, or explore what a UI should look like.

Frontend & Design999.2K installs

hyperframes-core

heygen-com/hyperframes

The HyperFrames composition contract — build one renderable project. Use for composition structure, the data- timing attributes, class="clip", tracks, sub-compositions, variables, framework-owned media playback, deterministic-render rules, and validation. Read before writing composition HTML.

Frontend & Design930.5K installs

vercel-react-best-practices

vercel-labs/agent-skills

React and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.

OfficialFrontend & Design843.1K installs