Communitygithub.com

check-user-experience

프로젝트의 UI를 UX의 30가지 법칙(Laws of UX, lawsofux.com)에 따라 감사하고, 실제 문제점과 구체적인 수정 제안을 포함한 우선순위 보고서를 생성합니다.

check-user-experience란 무엇인가요?

이 스킬은 Fitts, Hick, Jakob, Miller, Doherty, Postel, Tesler, Von Restorff, Peak-End, Serial Position, Zeigarnik, Goal-Gradient, Gestalt 법칙(근접성, 유사성, 공통 영역, 균일 연결성, 프레그난츠), 인지 부하, 선택 과부하, 청킹, Occam의 면도날, Pareto, Parkinson, 미적-사용성, 정신 모델, 흐름, 선택적 주의, 작업 기억, 능동적 사용자의 역설, 인지 편향 등 30가지 UX 법칙을 기준으로 인터페이스를 감사합니다. 코드베이스(웹, React, Vue, Svelte, Angular, React Native, Flutter, SwiftUI), 라이브 URL, 스크린샷 등 다양한 소스를 지원합니다. 각 문제에 대해 법칙, 위치(파일:줄, URL+요소, 스크린샷 영역), 심각도(높음/중간/낮음), 구체적인 수정 제안을 보고합니다. 보고서 생성 후 사용자가 요청할 경우 높은 심각도 항목을 수정할 수 있습니다. 사용자가 "check user experience", "/check-user-experience", "UX audit", "check UX laws", "is my UX good" 등으로 요청하면 자동 실행됩니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/aswin-haridas/skills/tree/HEAD/skills/check-user-experience

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

사용자 경험 확인 (Check User Experience)

UX 법칙에 따라 인터페이스를 감사하고, 실제 문제점과 구체적인 수정 제안이 포함된 우선순위 보고서를 생성합니다. 사용자가 요청하지 않는 한 수정하지 않고 보고만 합니다.

작업 흐름

1. 검사 대상 파악

  • 코드베이스: 스택을 감지한 후, 화면/경로, 공유 컴포넌트(버튼, 입력, 폼, 네비게이션, 모달, 목록, 테이블), 디자인 토큰, 로딩/에러 상태를 찾습니다. 파일 이름만이 아닌 실제 마크업과 스타일을 읽습니다.
  • 라이브 URL / 로컬 빌드: 브라우저에서 열고 주요 흐름을 따라가며 데스크톱 및 모바일 너비에서 스크린샷을 찍고, 가능한 경우 히트 타겟과 응답 시간을 측정합니다.
  • 스크린샷: 시각적으로 판단합니다. 코드 전용 검사는 "확인 불가"로 표시합니다.
  • 3~5개의 주요 사용자 작업(가입, 검색, 체크아웃, X 만들기)을 식별합니다. 해당 흐름을 가장 집중적으로 감사합니다(파레토 법칙은 감사에도 적용됩니다).

2. 모든 법칙 확인

아래 표를 살펴보며 각 법칙에 대해 나열된 신호를 찾습니다. 구체적인 위치가 있는 실제 발견 사항만 보고합니다. 일반적인 조언으로 보고서를 채우지 마십시오. 법칙이 충족되면 "통과" 목록에 한 줄로 기록합니다.

3. 보고서(아래 형식) 작성 후, 높은 심각도 항목 수정 제안

법칙: 확인 사항 및 수정 방법

상호작용 및 노력

법칙발견 기준제안된 수정 사항
피츠의 법칙 — 대상의 크기와 거리에 따라 도달 시간이 결정됨탭 대상 < 44×44pt(iOS) / 48×48dp(Android) / 24×24 CSS px 최소(WCAG 2.5.8), 이상적인 44px; 패딩이 작은 아이콘 전용 버튼; 눈/엄지 위치와 먼 주요 동작; 8px 미만 간격으로 인접한 파괴적/주요 버튼패딩 증가 또는 ::after { inset:-8px } 히트 영역 추가; 주요 CTA를 해당 콘텐츠 근처, 모바일에서는 엄지 영역에 배치; 파괴적 동작 분리
힉의 법칙 — 의사 결정 시간은 선택지의 수/복잡성에 비례상위 항목이 7개 이상인 네비게이션; 정렬되지 않은 긴 목록이 있는 메뉴/선택; 한 화면에 동등한 중요도의 여러 CTA그룹화, 점진적 공개("더 보기"), 긴 목록에 검색/필터 추가, 합리적인 기본값, 하나의 기본 CTA
선택 과부하추천 없이 3~4개 이상의 옵션이 있는 가격/요금제 페이지; 설정 덤프; 한 번에 많은 필터 표시추천 옵션 강조, 고급 옵션 접기, 비교 테이블
도허티 임계값 — 응답이 400ms 미만일 때 생산성이 급상승비동기 작업에 로딩/대기 상태 없음; 제출 시 버튼 비활성화 또는 진행률 표시 없음; 소규모 로드에 전체 페이지 스피너; 낙관적 업데이트 없음; 입력 시 차단 네트워크 호출100ms 미만의 즉각적인 피드백, 스켈레톤, 낙관적 UI, 지연 스피너(~300ms), 디바운스 검색
포스텔의 법칙 — 수용하는 데 관대하라엄격한 입력 형식(전화번호, 날짜, 카드 번호가 공백/대시를 거부); 대소문자 구분 이메일; 트리밍 없음; 수정 방법을 알려주지 않는 유효성 검사 오류; 붙여넣기 차단입력 정규화(트림, 구분 기호 제거), 여러 형식 허용, inputmode/autocomplete 속성, 유용한 오류 메시지
테슬러의 법칙 — 복잡성은 제거할 수 없고 이동만 가능시스템이 처리할 수 있는 작업(알려진 데이터 재입력, 값 계산, 추론 가능한 시간대/국가 선택)을 사용자가 강제로 수행해야 함자동 채우기, 스마트 기본값, 추론, 마지막 선택 기억
능동적 사용자의 역설 — 사용자는 매뉴얼을 읽지 않음문서/호버 시 툴팁을 통해서만 발견 가능한 기능; 가치 제공 전 긴 온보딩 투어; 안내가 없는 빈 상태사용 시점의 인라인 힌트, 실행 가능한 빈 상태, 배움-통한-실행 온보딩
흐름불필요한 중단(모달, 되돌릴 수 있는 작업에 대한 확인, 강제 재인증); 고급 경로에 키보드 단축키 없음; 작업 후 포커스 손실취소 대신 실행 취소, 포커스/스크롤 유지, 키보드 지원, 컨텍스트 전환 최소화

기억 및 인지

법칙발견 기준제안된 수정 사항
밀러의 법칙 / 청킹긴 단절 없는 양식; 긴 문자열을 원시 형태로 표시(ID, 전화번호, 카드 번호 서식 없음); 텍스트 벽; 10개 이상의 플랫 항목이 있는 네비게이션양식을 그룹/단계로 구분, 숫자를 청크로 서식 지정, 제목 및 짧은 단락 사용
인지 부하경쟁 요소가 있는 복잡한 화면; 전문 용어; 동일한 항목에 대한 일관성 없는 용어; 장식적인 혼란필수적이지 않은 요소 제거, 일관된 레이블, 평이한 언어 사용
작업 기억사용자가 이전 화면의 정보(코드, 이전 선택)를 기억해야 함; 입력 중 사라지는 플레이스홀더 전용 레이블; 여러 페이지에 걸친 비교컨텍스트를 계속 표시(요약, 고정 레이블, 이동 경로), 나란히 비교
정신 모델외형과 다르게 작동하는 컨트롤(링크처럼 보이지만 네비게이션을 수행하는 버튼, 또는 그 반대); 일반적이지 않은 비유; 저장 모델 불명확(자동 저장 vs 수동)사용자의 기대에 부합하도록 합니다. 시스템 상태를 명시적으로 만듭니다.
야콥의 법칙 — 사용자는 귀하의 사이트가 다른 사이트처럼 작동하기를 기대함비표준 배치(로고가 홈으로 연결되지 않음, 장바구니가 오른쪽 상단에 없음, 검색 숨김); 기본 컨트롤을 대체하는 사용자 정의 컨트롤(패리티 없음); 재발명된 패턴플랫폼 규칙(HIG / Material / 웹 규범)을 따릅니다. 기본 요소를 먼저 사용합니다.
오컴의 면도날중복 단계, 중복 컨트롤, 기본 화면에서 아무도 필요로 하지 않는 기능제거하거나 보조 표면으로 이동
파레토 원칙기본 작업은 묻혀 있고 거의 사용되지 않는 기능이 주요 공간을 차지함80%의 시간 동안 사용되는 20%의 기능을 승격
파킨슨의 법칙필요 이상으로 오래 걸리는 양식/작업; 자동 채우기 없음; 기대치를 설정하는 진행 표시기 없음자동 완성, 자동 채우기 속성, 예상 시간/단계 표시
선택적 주의 / 배너 맹목광고처럼 스타일링되거나 배너/사이드바에 배치된 중요 정보; 눈에 띄지 않는 중요한 경고작업 경로에 인라인으로 주요 정보 배치, 광고 같지 않으면서도 구별됨
인지 편향다크 패턴: 사전 선택된 옵트인, 확인 샤밍, 숨겨진 비용, 가짜 긴급성, 오해의 소지가 있는 기본값제거하고 정직한 기본값을 사용합니다. 높음(윤리 + 법적 위험)으로 표시합니다.

지각 (게슈탈트)

법칙발견 기준제안된 수정 사항
근접성의 법칙레이블이 잘못된 입력에 더 가까움; 관련 없는 항목과 관련 항목 간의 동일한 간격; 해당 필드에서 멀리 떨어진 도우미 텍스트그룹 내부는 더 좁은 간격, 그룹 간은 더 넓은 간격(간격 척도)
유사성의 법칙동일하게 보이는 요소가 다르게 동작함(클릭 가능 및 정적 텍스트 동일); 동일한 작업 수준에 대해 일관성 없는 버튼 스타일역할별로 일관된 시각적 언어 사용
공통 영역의 법칙관련 컨트롤이 그룹화되지 않음; 경계 없이 콘텐츠를 혼합하는 카드그룹을 위한 카드, 섹션, 배경 영역
균일 연결성의 법칙단계/관련 항목이 시각적으로 연결되지 않음스테퍼/타임라인을 위한 선, 커넥터, 공유 컨테이너
프레그난츠의 법칙지나치게 복잡한 아이콘/일러스트레이션, 모호한 형태형태 단순화; 레이블이 있는 인식 가능한 아이콘
미적-사용성 효과신뢰를 떨어뜨리는 시각적 불일치(혼합된 반경, 임의의 색상, 정렬되지 않은 그리드, 일관성 없는 글꼴 크기)간격/글꼴/색상을 토큰화합니다. 그리드에 정렬합니다.

순서, 동기 및 경험 기억

법칙발견 기준제안된 수정 사항
폰 레스토르프 효과주요 CTA가 시각적으로 구별되지 않음; 모든 것이 강조되어 아무것도 눈에 띄지 않음; 색상에만 의존보기당 하나의 강조된 기본 작업; 모양/크기/아이콘도 사용(접근성)
일련 위치 효과긴 목록의 중간에 있는 주요 네비게이션 항목; 페이지 중간에 묻힌 가장 중요한 정보주요 항목을 처음과 마지막에 배치(예: 탭 바에서 홈 처음, 프로필/장바구니 마지막)
최고-종말 법칙약하거나 누락된 성공 상태(양식 제출이 아무것도 없이 끝나거나 단순 리디렉션); 가혹한 오류 데드엔드; 갑작스러운 흐름 종료명확하고 만족스러운 확인; 오류 발생 시 유용한 복구; 마지막 단계 세련되게 처리
목표-구배 효과진행 표시가 없는 다단계 흐름; 0에서 시작하는 진행스테퍼/진행 표시줄, 남은 단계 표시, 초기 진행 제공
제이가르닉 효과잊혀진 미완료 작업(임시 저장 없음, 탐색 시 양식 데이터 손실, 프로필 완료 알림 없음)임시 저장 자동 저장, "중단한 부분부터 계속", 완료 체크리스트

심각도

  • 높음 — 기본 작업을 차단하거나 심각하게 지연시키거나, 오류/데이터 손실을 유발하거나, 접근성 실패 또는 다크 패턴입니다.
  • 중간 — 일반적인 경로에서 눈에 띄는 마찰이나 혼란을 유발합니다.
  • 낮음 — 개선 사항; 보조 화면.

보고서 형식

# UX 감사 — <앱/화면>
범위: <감사한 내용> · 방법: 코드 / 라이브 / 스크린샷
점수: <통과 법칙>/30 · 높음: n · 중간: n · 낮음: n

## 먼저 수정할 상위 3개
1. ...

## 발견 사항
### [높음] 피츠의 법칙 — 아이콘 버튼이 너무 작음
위치: src/components/Toolbar.tsx:42 (Header.tsx:18도 해당)
문제: 20×20px 아이콘 버튼에 패딩 없음; 모바일에서 잘못 탭함.
수정: `p-3`(44px 대상) 또는 `::after` 히트 영역 확장을 추가합니다.
```(짧은 경우 코드 스니펫)```

(…발견 사항당 하나의 블록, 심각도별로 그룹화, 높음 우선…)

## 통과
- 야콥의 법칙 — 표준 네비게이션 및 로고-홈 패턴.
- ...

## 확인 불가
- 도허티 임계값 — 응답 시간 측정을 위해 실행 중인 앱이 필요합니다.

규칙

  • 모든 발견 사항에는 법칙, 위치(파일:줄, URL + 요소 또는 스크린샷 영역), 관찰된 문제 및 구체적인 수정 사항이 필요합니다. 위치가 없으면 보고하지 마십시오.
  • 중복 병합: 근본 원인당 하나의 발견 사항으로, 모든 위치를 나열합니다.
  • 수정 시 앱의 개성을 변경하지 마십시오. 문제를 해결하는 가장 작은 변경을 제안합니다.
  • 야콥의 법칙과 대상 크기를 판단할 때 플랫폼 규칙(iOS HIG, Material, 웹)을 존중합니다.
  • 접근성(대비, 포커스, 레이블)과의 중복은 괜찮습니다. 관련 법칙 아래에 기록하되, 이것을 완전한 WCAG 감사로 전환하지 마십시오.
  • 보고서 작성 후, 높음(또는 모든) 발견 사항을 수정할지 물어보십시오. 모션/피드백 문제(도허티, 최고-종말, 목표-구배)가 발견되면 /animate-this-app이 해결할 수 있다고 언급하십시오.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

관련 스킬