MCP HubMCP Hub
SKILL·0630B0

ux-heuristics

wondelai
업데이트됨 15 days ago
4 조회
2,020
206
2,020
GitHub에서 보기
디자인design

정보

이 스킬은 닐슨의 원칙과 크러그의 법칙과 같은 확립된 휴리스틱을 사용하여 사용성 감사를 수행합니다. 사용자가 혼란을 호소하거나 작업 완료율이 낮을 때, 네비게이션, 폼, 정보 구조의 문제를 식별하고 수정하는 데 도움을 줍니다. 분석에는 심각도 평가, 다크 패턴 인식, 접근성 고려 사항이 포함됩니다.

빠른 설치

Claude Code

추천
기본
npx skills add wondelai/skills -a claude-code
플러그인 명령대체
/plugin add https://github.com/wondelai/skills
Git 클론대체
git clone https://github.com/wondelai/skills.git ~/.claude/skills/ux-heuristics

Claude Code에서 이 명령을 복사하여 붙여넣어 스킬을 설치하세요

문서

UX Heuristics Framework

Practical usability principles for evaluating and improving user interfaces. Users don't read, they scan; they don't make optimal choices, they satisfice; they don't figure out how things work, they muddle through.

Core Principle

"Don't Make Me Think" — every page should be self-evident. If something requires thinking, it's a usability problem. Users have limited patience and cognitive bandwidth, so design for the scanning, satisficing, and muddling-through behavior described above.

Scoring

Goal: 10/10. Audit the interface, rate every issue on the severity scale below, then score the interface from its Quick Diagnostic results: start at 10 and subtract per failed diagnostic row, weighted by the worst severity it triggers (catastrophic/major rows cost ~2, minor/cosmetic ~1). Bands: 9-10 = no severity-3+ issues and ≤1 failed diagnostic row; 6-8 = some major issues or several failed rows; 3-5 = a catastrophic issue or many failed rows; ≤2 = core tasks blocked. Always state the current score, the highest-severity issues, and the specific fixes needed to reach 10/10.

Krug's Usability Principles

Laws 1-3 are Krug's Three Laws of Usability; #4, the Trunk Test, is his navigation orientation check.

1. Don't Make Me Think

Core concept: Every question mark that pops into a user's head adds cognitive load and distracts from the task.

Why it works: Users are on a mission — they don't want to puzzle over labels or decode clever marketing language. The less thinking required, the more likely they complete the task.

Key insights:

  • Clever names lose to clear names every time
  • Marketing-speak creates friction; plain language removes it
  • Unfamiliar categories force users to stop and interpret
  • Ambiguous links and buttons cause hesitation

Product applications:

ContextApplicationExample
Navigation labelsSelf-evident names"Get directions" not "Calculate route to destination"
CTAsAction verbs users understand"Sign in" not "Access your account portal"
Error statesTell users what to do next"Check your email format" not "Validation error"

Copy patterns:

  • Action-oriented buttons: verb + noun ("Create account", "Download report")
  • Avoid jargon: "Save" not "Persist", "Remove" not "Disassociate"
  • If a label needs explanation, simplify the label

Ethical boundary: Clarity should serve users — never use plain language as a veneer to hide unfavorable terms.

See: references/krug-principles.md when you need the full Krug method — scanning/satisficing/muddling psychology, the goodwill reservoir, homepage and tagline guidance, and the $0 usability-testing protocol (how many users, the test script).

2. It Doesn't Matter How Many Clicks

Core concept: The myth says "users leave after 3 clicks." In reality users don't mind clicks if each one is painless, obvious, and confidence-building.

Why it works: Cognitive effort per click matters more than click count. Users abandon when they lose confidence, not when they run out of patience for clicking.

Key insights:

  • Each click should be painless, obvious, and confidence-building
  • Three mindless clicks beat one click that requires deliberation
  • Shallow nav with clear labels beats deep nav with vague ones

Product applications:

ContextApplicationExample
Checkout flowsMake each step obviousClear step indicators with descriptive labels
SettingsClear categories over flat lists"Account > Security > Change password" (3 confident clicks)
OnboardingSmall, clear stepsWizard with one clear action per step

Copy patterns:

  • Progress indicators: "Step 2 of 4: Shipping details"
  • Confirmations at each step: "Great, your email is verified. Now let's set up your profile."
  • Clear link text: "View all running shoes" not "Click here"

Ethical boundary: Never use extra steps to bury cancellation flows — every click should move users toward their goal, not away from it.

3. Get Rid of Half the Words

Core concept: Remove half the words on each page, then half of what's left. Brevity makes useful content prominent and respects the user's time.

Key insights:

  • Happy-talk ("Welcome to our website!") wastes space
  • Instructions nobody reads should be removed
  • "Please" and "Kindly" and polite fluff add noise
  • Shorter pages mean less scrolling and faster scanning

Product applications:

ContextApplicationExample
Landing pagesCut welcome copy, lead with valueRemove "Welcome to..." paragraphs
Error messagesState problem and fix, nothing more"Password too short (min 8 chars)"
Empty statesAction-oriented, minimal"No results. Try a different search."

Copy patterns:

  • Before: "Please kindly note that you will need to enter your password in order to proceed to the next step." → After: "Enter your password to continue."
  • Before: "We've received your message and will get back to you as soon as possible." → After: "Message sent. We'll reply within 24 hours."

Ethical boundary: Brevity must not omit critical information — concise disclosures for pricing, terms, and data usage are a user right.

4. The Trunk Test

Core concept: Drop a user on any random page (like being released from a car trunk at a random spot) — they should instantly answer six orientation questions: What site is this? What page? What are the major sections? What are my options here? Where am I in the hierarchy? Where's search?

Why it works: Good navigation gives constant orientation. Users who can't tell where they are feel lost and leave.

Apply it as the navigation check: page titles must match the link the user clicked, a "you are here" indicator (highlighted nav item, bold breadcrumb) must be present, and section headings must orient ("Your Account > Billing" not just "Settings").

Ethical boundary: Navigation labels must honestly represent site structure — never use misleading labels to funnel users into marketing pages.

See: references/krug-principles.md when running the Trunk Test or designing navigation — it maps each of the six questions to the page element that answers it, plus breadcrumb and permanent-navigation rules.

Nielsen's 10 Usability Heuristics

1. Visibility of System Status

Keep users informed through timely feedback. Every action needs acknowledgment — progress bars for uploads, confirmations for submissions, skeleton screens for loading. Silent failures destroy trust. Copy pattern: "Saving..." → "Saved".

2. Match Between System and Real World

Speak users' language: "Sign in" not "Authenticate", "Search" not "Query." Follow real-world metaphors (trash bin, shopping cart) and natural ordering (street → city → state → zip).

3. User Control and Freedom

Provide clear "emergency exits." Undo beats "Are you sure?" dialogs — users click through confirmations without reading. Every flow needs cancel/exit, and back buttons must never break.

4. Consistency and Standards

Same words, styles, and behaviors mean the same thing throughout. Internal consistency (your app) plus external consistency (platform conventions: logo top-left, search top-right). One term per concept — "Projects" everywhere, never mixed with "Workspaces."

5. Error Prevention

Prevent problems before they occur: constrained inputs (date pickers over text fields), autocomplete, sensible defaults, "unsaved changes" warnings. Slips (accidental wrong action) and mistakes (wrong intention) need different prevention.

6. Recognition Rather Than Recall

Minimize memory load — show options, don't require memorization. Breadcrumbs, recent searches, pre-filled fields, dropdowns with decoded values. Working memory holds ~7 items; recognition is far easier than recall.

7. Flexibility and Efficiency of Use

Serve both novices and experts: keyboard shortcuts, bulk actions, saved searches, command palettes (Cmd+K). Progressive disclosure keeps it simple for beginners while experts access full power.

8. Aesthetic and Minimalist Design

Every element must earn its place — when everything screams for attention, nothing stands out. Show what matters now, hide what doesn't. One primary CTA per page.

9. Help Users Recognize, Diagnose, and Recover from Errors

Error messages need three parts: what happened, why, and how to fix it. Plain language ("Connection failed" not "ECONNREFUSED"), specific ("Password must be 8+ characters" not "Invalid"), never blame the user, preserve their input.

10. Help and Documentation

Help should be searchable, task-focused ("How to..." not technical reference), and contextual (tooltips, inline hints, guided tours).

See: references/nielsen-heuristics.md when auditing against a specific heuristic — it expands each of the 10 into good-implementation / common-violation / severity tables with copy patterns and ethical boundaries.

Severity Rating Scale

Rate each issue found in an audit:

SeverityRatingDescriptionPriority
0Not a problemDisagreement, not usability issueIgnore
1CosmeticMinor annoyance, low impactFix if time
2MinorCauses delay or frustrationSchedule fix
3MajorSignificant task failureFix soon
4CatastrophicPrevents task completionFix immediately

Weigh three factors: frequency (how often it occurs), impact (how severe when it occurs), persistence (one-time or ongoing).

See: references/audit-template.md when running a full heuristic evaluation — a structured per-screen template that captures issues, severity, and recommended fixes in a consistent format.

Common Mistakes

MistakeWhy It FailsFix
Mystery meat navigationIcons without labels force guessingAdd text labels alongside icons
Too many choicesDecision paralysis slows usersReduce to 7 plus/minus 2 items
No "you are here" indicatorUsers feel lost in the hierarchyHighlight current section in nav and breadcrumbs
No inline validationSubmit, error, scroll cycle frustratesValidate on blur with specific messages
Unclear required fieldsUsers confused about what's mandatoryMark optional fields, not required
Wall of textNobody reads dense paragraphsBreak up with headings, bullets, whitespace
Jargon in labelsUsers don't speak your internal languageUser-test all labels, use plain language
No loading indicatorsUsers think the system is brokenShow spinner, progress bar, or skeleton screen
Tiny tap targetsMobile users misclick constantlyMinimum 44x44 px touch targets
Hover-only informationMobile and keyboard users miss itDon't hide critical info behind hover
No undoUsers afraid to take any actionProvide undo for all non-destructive actions
Poor error messages"Invalid input" tells users nothingExplain what's wrong and how to fix it
Low contrast textUnreadable for many usersWCAG AA minimum (4.5:1 contrast)
Inconsistent nav locationUsers can't find navigationFixed position, same place on every page
Broken back buttonViolates the browser contractNever hijack or break browser history

See: references/wcag-checklist.md when auditing accessibility (contrast, keyboard, screen-reader, focus) — a complete WCAG 2.1 AA checklist with testing tools. See references/cultural-ux.md when designing for global audiences — RTL layouts, color meanings, form/name/date conventions, and localization pitfalls.

Quick Diagnostic

QuestionIf NoAction
Can I tell what site/page this is immediately?Users are lostAdd clear logo, page title, breadcrumbs
Is the main action obvious?Users don't know what to doVisual hierarchy, single primary CTA
Is the navigation clear?Users can't find their wayApply the Trunk Test, add "you are here" indicators
Can I find the search?Goal-driven users are blockedVisible search box in header
Does the system show what's happening?Users lose trust and re-clickLoading states, confirmations, progress
Are error messages helpful?Users get stuckPlain language with a specific fix
Can users undo or go back?Users are afraid to actUndo, cancel, and back options everywhere
Does it work without hover?Mobile/keyboard users excludedVisible alternatives to hover interactions
Are all interactive elements labeled?Users guess at iconsText labels or descriptive tooltips
Does anything make me stop and think "huh?"Cognitive load too highSimplify — if it needs explanation, redesign it

Heuristic Conflicts

Heuristics sometimes contradict each other. When they do:

  • Simplicity vs. Flexibility: use progressive disclosure
  • Consistency vs. Context: consistent patterns, contextual prominence
  • Efficiency vs. Error Prevention: prefer undo over confirmation dialogs
  • Discoverability vs. Minimalism: primary actions visible, secondary hidden

See: references/heuristic-conflicts.md when two heuristics pull in opposite directions and the four rules above don't settle it — resolution frameworks with worked trade-off examples.

Dark Patterns Recognition

Dark patterns violate heuristics deliberately to manipulate users: forced continuity (hard to cancel), roach motel (easy in, hard out), confirmshaming (guilt-based options), hidden costs (surprise fees at checkout).

See: references/dark-patterns.md when you suspect a design manipulates rather than serves users — the complete taxonomy, ethical alternatives, and relevant regulations.

When to Use Each Method

MethodWhenTimeFindings
Heuristic evaluationBefore user testing1-2 hoursMajor violations
User testingAfter heuristic fixes2-4 hoursReal behavior
A/B testingWhen optimizingDays-weeksStatistical validation
Analytics reviewOngoing30 minPatterns and problems

Further Reading

Based on usability principles developed by Steve Krug and Jakob Nielsen:

About the Author

Steve Krug is a usability consultant whose Don't Make Me Think (2000, revised 2014) is the most widely read book on web usability. He demonstrated that usability testing doesn't require a lab or large budget — just watching a few real users try to accomplish tasks.

Jakob Nielsen, PhD is co-founder of the Nielsen Norman Group and author of the 10 Usability Heuristics (1994), still the most-used framework for heuristic evaluation worldwide. The New York Times called him "the guru of Web page usability."

GitHub 저장소

wondelai/skills
경로: plugins/ux-design/skills/ux-heuristics
0
agent-skillsai-skillsbusinessclaude-codeclaude-code-marketplaceclaude-code-plugin
FAQ

자주 묻는 질문

ux-heuristics Skill이란 무엇인가요?

ux-heuristics은(는) wondelai이(가) 만든 Claude Skill입니다. Skill은 Claude가 필요할 때 불러오는 지침과 리소스를 묶어 추가 프롬프트 없이 ux-heuristics 관련 작업을 수행할 수 있게 합니다.

ux-heuristics은(는) 어떻게 설치하나요?

이 페이지의 설치 명령을 사용하세요. ux-heuristics을(를) Claude Code 플러그인으로 추가하거나 저장소를 skills 디렉터리에 복제한 다음 Claude를 다시 시작해 Skill을 불러옵니다.

ux-heuristics은(는) 어떤 카테고리에 속하나요?

ux-heuristics은(는) 디자인 카테고리에 속합니다.

ux-heuristics은(는) 무료로 사용할 수 있나요?

네. ux-heuristics은(는) AIMCP에 등록되어 있으며 무료로 설치할 수 있습니다.

연관 스킬

executing-plans
디자인

executing-plans 스킬은 검토 체크포인트가 포함된 통제된 배치로 실행할 완전한 구현 계획이 있을 때 사용합니다. 이 스킬은 계획을 불러와 비판적으로 검토한 후, 소규모 배치(기본값 3개 작업)로 작업을 실행하면서 각 배치 사이에 진행 상황을 아키텍트 검토를 위해 보고합니다. 이를 통해 내재된 품질 관리 체크포인트를 갖춘 체계적인 구현이 보장됩니다.

스킬 보기
requesting-code-review
디자인

이 스킬은 코드 변경 사항을 요구 사항에 따라 분석하기 위해 코드 리뷰어 하위 에이전트를 호출합니다. 작업 완료 후, 주요 기능 구현 후, 또는 메인 브랜치에 병합하기 전에 사용해야 합니다. 이 리뷰는 현재 구현체와 원래 계획을 비교하여 문제를 조기에 발견하는 데 도움이 됩니다.

스킬 보기
connect-mcp-server
디자인

이 스킬은 개발자들이 HTTP, stdio 또는 SSE 전송 방식을 통해 MCP 서버를 Claude Code에 연결하는 포괄적인 가이드를 제공합니다. GitHub, Notion 및 사용자 정의 API와 같은 외부 서비스를 통합하기 위한 설치, 구성, 인증 및 보안을 다룹니다. MCP 통합 설정, 외부 도구 구성 또는 Claude의 모델 컨텍스트 프로토콜 작업 시 활용하세요.

스킬 보기
web-cli-teleport
디자인

이 스킬은 작업 분석을 기반으로 개발자가 Claude Code 웹 인터페이스와 CLI 인터페이스 중 선택할 수 있도록 돕고, 두 환경 간 원활한 세션 텔레포트를 가능하게 합니다. 웹, CLI 또는 모바일 환경 전환 시 세션 상태와 컨텍스트를 관리하여 워크플로를 최적화합니다. 다양한 단계에서 서로 다른 도구가 필요한 복잡한 프로젝트에 사용하세요.

스킬 보기