Communitygithub.com

UI/UX 디자인

웹 앱, SaaS B2B, 대시보드, 폼, 테이블, 모바일 등 사용자 인터페이스를 설계, 구현, 검토하고 비판합니다. Nielsen 휴리스틱, UX 법칙(Yablonski), Refactoring UI, 사용자 중심 디자인(Lowdermilk, ISO 9241), WCAG 2.2 AA, 증거 기반 패턴(NN/g, GOV.UK, Baymard)을 활용하여 검증 가능한 사용성과 시각적 디자인 기준을 적용합니다.

UX 디자인란 무엇인가요?

이 스킬은 UI/UX 디자인 전반을 다루는 포괄적인 지침입니다. 개발자나 AI 에이전트가 코드에서 UI(컴포넌트, 화면, 스타일, Tailwind/CSS)를 생성하거나 수정할 때, 화면이나 캡처를 검토하거나 개선할 때, 휴리스틱 평가나 접근성 검토가 필요할 때, 두 디자인 중 결정을 내려야 할 때, 폼, 빈 상태, 로딩/에러 상태, 테이블, 대시보드를 디자인할 때, 마이크로카피를 작성할 때, 기능 요청을 플로우로 변환할 때, 사용성 테스트를 준비할 때 이 스킬을 사용합니다. (사용자가 'UX'나 '디자인'이라는 단어를 명시하지 않더라도, 그 결과물을 화면을 통해 사람이 사용한다면 이 스킬을 적용해야 합니다.) 이 스킬은 세 권의 책(Lowdermilk의 'User-Centered Design', Yablonski의 'Laws of UX', Wathan과 Schoger의 'Refactoring UI')과 NN/g, WCAG 2.2, 공개 디자인 시스템에서 핵심 내용을 추출하여 정리합니다. 디자인 결정은 다음과 같은 명확한 우선순위 체계를 따릅니다: 1) 프로젝트 디자인 시스템 및 지침(CLAUDE.md, 토큰), 2) 접근성(WCAG 2.2 AA) 및 사용자 보호, 3) 증거 기반 연구(NN/g, Baymard, GOV.UK), 4) 실무 팁(Refactoring UI). 이 스킬은 UX 라이브러리, Cursor, Codex, Claude Code 등 다양한 AI 에이전트 플랫폼에서 사용할 수 있도록 설계되었습니다. 핵심 작업 방식은 다음과 같습니다. 먼저 요청을 '사용자 니즈'로 재구성하고 사용 맥락을 파악합니다. 그런 다음 Nielsen의 10가지 휴리스틱과 UX 법칙(예: Fitts의 법칙, Hick의 법칙, Jakob의 법칙)을 체크리스트로 사용하여 구조와 상호작용을 평가합니다. 시각적 디자인은 '회색조로 시작하여 기능 우선' 원칙에 따라 진행되며, 접근성은 WCAG 2.2 AA를 최소 기준으로 삼아 모든 결정에 반영합니다. 각 권장 사항은 반드시 해당 원칙(예: 'WCAG 1.4.3(필수)')과 함께 제시되어, 단순한 의견이 아닌 근거 있는 조언임을 명확히 합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JVISERASS/ui-ux-design/tree/main

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

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

문서

UX 디자인은(는) 무엇을 하나요?

개인 스킬. 세 권의 책(Lowdermilk, User-Centered Design; Yablonski, Laws of UX; Wathan과 Schoger, Refactoring UI)과 NN/g, WCAG 2.2 및 공개 디자인 시스템의 내용을 나만의 언어로 요약했습니다. 자세한 내용과 출처, 검증되지 않은 내용은 references/에 표시되어 있습니다. 이 파일은 항상 머릿속에 담아두어야 할 내용입니다.

0. 우선순위

두 조언이 충돌할 때는 위에 있는 조언이 우선합니다.

  1. 프로젝트 디자인 시스템 및 지침(CLAUDE.md, 토큰, 프리미티브, 브랜드 가이드). 프로젝트에 'border-radius: 0, 그림자 없음'이라고 명시되어 있다면, Refactoring UI가 그림자를 권장하더라도 그림자를 제안하지 않습니다. 대신 시스템이 허용하는 방법(선, 배경, 공백)으로 깊이감을 만듭니다. 새로 만들기 전에 기존 토큰과 컴포넌트를 먼저 읽습니다.
  2. 하드 룰: WCAG 2.2 AA 접근성 및 사용자 기만 금지. 프로젝트 시스템이 대비나 포커스 요구사항을 위반하는 경우, WCAG 기준과 함께 시스템 내에서 대안을 제시합니다.
  3. 증거: 데이터가 있는 연구 및 가이드(NN/g, Baymard, GOV.UK, ISO 표준).
  4. 실무 지식: Refactoring UI 및 유사한 실용적 조언들. 기본적으로 좋은 조언이지만, 절대적인 법칙은 아닙니다.

권장 사항이 어느 수준에 속하는지 항상 명시하십시오: 'WCAG 1.4.3(필수)'는 '보통 이렇게 하면 더 좋다'와 같은 무게가 아닙니다.

1. 그리기 전에: 니즈 파악

요청은 종종 해결책 형태로 옵니다('CSV 내보내기 추가', '여기에 버튼 추가'). 그 이면에는 니즈가 있으며, 문자 그대로의 해결책을 디자인하면 표면적이 더 넓어지고 결과도 더 나빠지는 경우가 많습니다. 따라서 디자인하기 전에:

  • 요청 재구성: [상황]에서 [사용자]가 [결과]를 원하는 이유는 [동기]이기 때문이다. 상황이나 동기를 채울 수 없다면 질문하거나 가정을 명시적으로 선언합니다.
  • 사용 맥락(ISO 9241-11): 누가, 어떤 작업을, 어디서, 무엇으로(야외 모바일, 듀얼 모니터 데스크톱, 매일 사용하는 전문가 또는 1년에 한 번 사용). '사용성'은 추상적으로 존재하지 않습니다. 항상 특정 사용자, 특정 작업, 특정 맥락에서의 사용성을 의미합니다.
  • 현재 해결 방법 찾기(Excel, WhatsApp, 종이): 이것이 필요한 사항에 대한 최고의 명세서입니다.
  • 최소한 하나의 대안 제시: 동일한 니즈를 더 적은 인터페이스로 해결할 수 있는 대안이 있다면 제시합니다.
  • 먼저 해피 패스, 그리고 즉시 상태들: 로딩, 빈 상태(첫 방문/필터 결과/권한 없음), 에러, 성공, 부분 상태. 상태가 없는 화면은 디자인되지 않은 것입니다.

인터뷰, 사용성 테스트, 사용자 수, 메트릭, SUS에 대해서는 references/centrado-en-usuario.md를 참조하십시오.

2. 구조와 상호작용 (사용성에 가장 큰 영향)

Nielsen 휴리스틱, 한눈에 보는 체크리스트:

  1. 상태 가시성: 시스템이 현재 상태를 알려줍니다(저장 중, 저장됨, 로딩 중, 오류 발생).
  2. 사용자 언어 사용: 데이터 모델 언어가 아닌 사용자 언어를 사용합니다.
  3. 사용자 통제 및 자유: 실행 취소, 취소, 뒤로 가기를 제공합니다.
  4. 일관성: 동일한 것은 동일하게 보이고 동작해야 하며, 관례를 존중합니다.
  5. 오류 방지: 제약 조건, 좋은 기본값, 다양한 입력 형식 허용.
  6. 기억보다는 인지.
  7. 초보자를 방해하지 않는 전문가용 단축키.
  8. 미니멀리즘: 각 요소는 다른 요소와 경쟁합니다.
  9. 오류는 무엇이 잘못되었고 어떻게 고칠지 알려줍니다.
  10. 상황에 맞는 도움말.

가장 많이 사용되는 UX 법칙과 그 한계:

법칙적용주의할 점
Jakob관례적인 패턴 사용; 가치 혁신은 내비게이션이 아닌 기능에서업계 관례(ERP, CAD)가 일반 웹 관례보다 우선할 수 있음
Fitts목표는 크게, 주의가 집중된 곳 가까이에; 제출 버튼은 마지막 입력 필드 옆에'무한' 코너는 마우스에서만 유효, 터치에서는 해당 없음
Hick시간이 촉박할 때는 옵션을 줄이고, 추천 옵션을 강조하며, 점진적으로 공개알려진 옵션 중에서 선택할 때만 유효; 검색의 경우 조직화(순서, 그룹, 검색)가 우선
Miller / 작업 기억청킹으로 그룹화; 시스템이 사용자를 대신해 기억'7±2'는 메뉴를 제한하지 않음: 눈에 보이는 것은 기억을 사용하지 않음. 실제 용량은 약 4개 블록(Cowan)
Tesler복잡성은 시스템이 흡수(기본값, 자동 완성, 계산)숨기는 것이 단순화가 아님: 복잡성을 이동시킬 뿐
Postel다양한 형식을 허용하고 정규화자동 추측이 아닌 수용: 모호한 경우 해석을 보여주거나 질문
Peak-End가장 가치 있는 순간과 마무리를 신경 쓰고, 부정적인 피크를 감시—
Von Restorff영역당 하나의 강조 요소모든 것이 강조되면 아무것도 강조되지 않으며, 강조된 것이 광고처럼 보일 수 있음
응답 시간<0.1초 즉시; ~1초 가벼운 피드백; 2–10초 스켈레톤 또는 스피너; >10초 진행률 + 취소Doherty의 '400ms'는 1982년 원본 보고서에 없음; Nielsen의 0.1/1/10초 사용
Goal-gradient긴 프로세스에서 가시적이고 정직한 진행 상황 표시거짓 진행 상황은 기만적인 패턴

30가지 법칙, 상황별 맵(폼, 온보딩, 체크아웃, 테이블, 모바일…) 및 오용 사례는 references/leyes-ux.md를 참조하십시오.

증거 기반 패턴(자세한 내용 및 출처는 references/patrones.md):

  • 폼: 레이블은 필드 위에 표시하고 항상 보이게(절대 플레이스홀더를 레이블로 사용하지 않음); 한 열; 올바른 autocomplete 및 inputmode; 전화번호, 날짜, IBAN을 여러 필드로 나누지 않음; 필드 이탈 시 또는 제출 시 유효성 검사하고 수정 즉시 오류 제거('일찍 보상하고 늦게 처벌'); 오류는 필드 옆에 표시하고, 무엇이 잘못되었는지, 어떻게 고칠지 레이블의 단어를 사용하여 설명; 입력 내용은 항상 보존.
  • 버튼: 동사 + 목적어('송장 저장', '확인' 대신); 뷰당 하나의 기본 버튼; 이유를 설명하지 않는 비활성화된 버튼은 피함(클릭은 허용하고 설명하는 것이 나음); 이중 제출 방지.
  • 파괴적 작업: 확인보다 실행 취소가 나음; 되돌릴 수 없는 경우에만 확인하고, 무엇이 손실되는지 알리며, 예/아니요 대신 동사가 포함된 버튼('송장 3개 삭제'/'보관') 사용.
  • 빈 상태: 비어 있음을 알리고(로딩 중이 아님), 여기에 무엇이 나타날지, 그리고 시작 버튼을 표시; 내용이 없으면 필터와 정렬을 숨김.
  • 테이블: 첫 번째 열에 식별 가능한 ID; 숫자는 오른쪽 정렬, tabular-nums 사용 및 동일한 소수점 자리수; 헤더 고정; 활성 필터가 보이는 상태로 필터 표시; 행 작업은 마우스 호버 시에만 보이지 않도록; 드래그 앤 드롭 대안 제공. 모바일: 레코드 검토용 카드, 비교용 첫 번째 열 고정 테이블.
  • 대시보드: 하나의 작업; 각 수치는 비교, 단위, 기간과 함께 제공; 막대 및 선 그래프가 파이 차트나 속도계보다 우선; 색상은 의미를 가지며 유일한 단서가 되어서는 안 됨.
  • 내비게이션: 데스크톱에서는 항상 표시(햄버거 메뉴는 발견성을 떨어뜨림); 모바일에서는 아이콘과 텍스트가 있는 3–5개 목적지의 하단 바; 자주 사용하는 항목은 도달 가능한 영역에, 중요한 항목은 상단 모서리에 배치하지 않음.
  • 마이크로카피: 중요한 내용은 처음 두 단어에; 단어 수를 절반으로 줄임; 스캔 가능한 부제목; 능동태의 짧은 문장; '부탁드립니다', '어이쿠', '유효하지 않음' 사용 금지.

3. 시각적 디자인 (Refactoring UI 요약)

값과 CSS/Tailwind에 대한 자세한 내용은 references/diseno-visual.md를 참조하십시오(§11은 요약본).

  • 레이아웃이 아닌 기능부터 시작하고, 회색조로: 회색조에서 계층 구조가 작동하지 않으면 색상으로 고칠 수 없습니다. 색상은 마지막에 추가합니다.
  • 값보다 시스템 우선: 고정된 간격, 폰트 크기, 색상, 그림자, 모서리 둥글기 스케일을 만들고 그중에서 선택하여 결정합니다. 코드에서는 토큰 사용; 특별한 이유 없이 임의의 값(p-[13px])은 사용하지 않습니다.
  • 크기보다 무게와 색상으로 계층 구조 만들기: 2–3가지 텍스트 톤(기본, 보조, 3차)과 2가지 두께(보통, 세미볼드/볼드); 400 미만은 사용하지 않음. 강조는 종종 경쟁 요소를 약화시키는 것입니다.
  • 레이블은 최후의 수단: 스스로 설명되는 형식('재고: 12'보다 '12개 재고 있음'이 나음); 레이블이 필요하면 값보다 가벼운 무게를 사용. 섹션 제목은 종종 작은 레이블 역할을 합니다. 시각적 계층 구조가 h1…h6의 계층 구조를 따를 필요는 없습니다.
  • 간격: 너무 많은 공백으로 시작하고 줄임; 비선형 스케일(4, 8, 12, 16, 24, 32, 48, 64, 96…)에서 각 단계는 다음 단계와 최소 ~25% 차이; 그룹 내 간격보다 그룹 간 간격을 더 크게(레이블은 해당 필드에 붙어 있음).
  • 너비: 전체 화면으로 늘리지 않음; 컴포넌트별 max-width; 단락은 45–75자; 사이드바는 고정 너비, 콘텐츠는 유연하게.
  • 텍스트: 수동으로 만든 타이포그래피 스케일(12/14/16/18/20/24/30/36/48…) (px 또는 rem, em 절대 사용 금지); 본문은 약 1.5, 제목은 약 1–1.25 줄 간격; 큰 제목은 자간을 약간 좁히고, 대문자는 자간을 넓힘; 크기가 섞일 때 기준선 정렬; 2–3줄에서만 가운데 정렬.
  • 색상: 8–10가지 회색(약간의 색조 포함) 및 색상당 5–10가지 톤(100–900)을 미리 정의, OKLCH 사용 권장(균일한 인지 휘도); 극단에서 채도 증가; 절대 유색 배경에 회색 텍스트 사용 금지(같은 색상의 톤 사용); 반전 대비 배지(밝은 색조 배경, 같은 색상의 어두운 텍스트); 색상은 유일한 신호가 되어서는 안 됨.
  • 의미가 아닌 중요도에 따른 버튼: 기본 버튼은 채워진 스타일, 보조 버튼은 외곽선 또는 연한 배경, 3차 버튼은 링크처럼. 파괴적 버튼은 주요 동작일 때만 크고 빨갛게(확인 대화상자의 최종 버튼).
  • 깊이(시스템이 지원하는 경우): 위에서 내려오는 빛; 약 5가지 그림자(2개 레이어); 테두리 줄이기(공백, 배경 또는 그림자로 분리); 강조 테두리로 포인트 색상 추가. 그림자 없음: 배경 차이와 얇은 선.
  • 이미지: 아이콘은 크기를 조정하지 않음(배경이 있는 도형 안에 배치); 사용자가 업로드한 이미지는 object-fit: cover와 함께 고정 컨테이너에 배치; 이미지 위 텍스트는 대비를 보장하는 레이어 필요.
  • 다크 모드: 반전이 아닌 시맨틱 토큰 재할당; 표면은 높이에 따라 밝아짐; 덜 채도가 높은 액센트.
  • 숫자: 비교하거나 업데이트되는 모든 항목에 font-variant-numeric: tabular-nums 적용.

4. 접근성: 타협할 수 없는 최소 기준

WCAG 2.2 AA가 목표입니다(EU의 EN 301 549 V4.1.1에서 요구). 55개의 A/AA 기준, ARIA, 모달, 라이브 리전 및 테스트 방법을 포함한 전체 체크리스트는 references/accesibilidad.md를 참조하십시오.

  • ARIA보다 기본 HTML 사용(button, a href, label, fieldset, dialog); 클릭 가능한 div는 사용하지 않음.
  • 대비: 텍스트 ≥ 4.5:1; 큰 텍스트(≥ 24px 또는 ≥ 18.66px 볼드), 입력 필드 테두리, 정보를 제공하는 아이콘 및 포커스 ≥ 3:1. WCAG 2.x 공식으로 측정, APCA 사용 금지.
  • 전체 키보드 사용 가능; 포커스 가시적(:focus-visible); 헤더나 고정 바에 가려지지 않도록(scroll-padding); 모달은 포커스 트랩, Esc 키로 닫기, 닫힌 후 포커스 반환.
  • 타겟 크기 ≥ 24×24 CSS px (법적 최소 기준); 터치용으로 44–48px로 디자인.
  • 드래그 가능한 모든 항목에는 드래그 없는 대안 제공(칸반, 정렬, 슬라이더).
  • 오류는 필드 옆에 텍스트로 표시, aria-invalid 및 aria-describedby 사용; 색상만으로 전달 금지.
  • 비동기 상태는 role="status"(또는 긴급한 경우 alert)로 미리 마운트된 리전을 사용하여 알림.
  • 로그인: 붙여넣기 가능; autocomplete는 username, current-password, one-time-code 사용; 인지 테스트 금지.
  • 동일한 프로세스에서 이미 입력한 정보를 다시 요구하지 않음.
  • 320px 너비에서 가로 스크롤 없이 리플로우(데이터 테이블 제외); 200% 확대/축소; prefers-reduced-motion.
  • axe 통과가 접근성을 의미하지는 않음: GOV.UK 연구에서 최고의 도구는 약 41%의 장벽만 발견했으며(모든 도구를 합쳐 약 71%), Deque는 axe가 약 57%의 문제를 감지한다고 추정합니다. 키보드 테스트와 빠른 스크린 리더 테스트도 필요합니다.

5. 요청 유형별 작업 방법

코드로 UI 구현 또는 개선

  1. 프로젝트 디자인 시스템(토큰, 프리미티브, 유사한 기존 컴포넌트)을 읽고, 새로 만들기 전에 재사용합니다.
  2. 니즈, 맥락 및 상태를 작성합니다(§1).
  3. 먼저 회색조로 기능을 구축하고 계층 구조를 만듭니다. 그런 다음 토큰을 사용하여 간격, 타이포그래피 및 색상을 적용합니다.
  4. 모든 상태를 다룹니다: default, hover, focus-visible, active, disabled(이유 포함), loading, 빈 상태, error, success.
  5. 확인: 모바일 너비(320–380px) 및 데스크톱, 키보드, 대비, 긴 텍스트 또는 극단적인 데이터(60자 이름, 7자리 금액, 0개 및 500개 행 목록). 브라우저를 사용할 수 있으면 실제 화면을 확인합니다: 캡처는 코드가 보여주지 않는 것을 보여줍니다.

화면, 캡처 또는 PR 검토

§2–§4를 적용하고 다음을 반환합니다:

  1. 요약 2–3줄: 잘 작동하는 부분과 가장 비용이 많이 드는 문제.
  2. 발견 사항 심각도별 정렬(Nielsen 척도: 4 치명적, 출시 전 수정 · 3 주요 · 2 사소 · 1 미용상). 각 항목: 위치, 위반하는 원칙(휴리스틱, 법칙 또는 WCAG 기준 번호), 영향을 받는 사람과 방법, 그리고 구체적인 수정 사항(값, 컴포넌트, 카피). 필수 사항과 취향을 구분합니다. 심각도는 단일 평가자의 평가임을 명시합니다.
  3. 빠른 수정: 최대 5개, 영향이 크고 노력이 적은 것.
  4. 미해결 질문: 데이터나 사용자로만 해결할 수 있는 사항.

대안 결정

주요 작업과 맥락(§1)과 비교하여 결정하며, 개인 취향으로 결정하지 않습니다. 차이가 실제 동작에 달려 있다면 이를 명시하고 가장 저렴한 테스트 방법(5명 사용자 테스트, A/B 테스트, 분석)을 제안합니다: references/centrado-en-usuario.md §5.

코드 없이 디자인(플로우 또는 와이어프레임)

재구성된 니즈, 해피 패스 플로우와 상태, 각 화면의 구조(결정마다 하나의 원칙으로 정당화), 사용자 검증이 필요한 사항을 전달합니다.

6. 행동 규칙

  • 일반적이기보다 구체적으로: '대비 개선' 대신 '보조 텍스트를 Tailwind v3의 gray-400에서 gray-600으로 변경(2.5:1 → 7.6:1 흰색 배경 기준; WCAG 1.4.3은 4.5:1 요구)'.
  • 권장 사항당 한 줄의 이유를 제시하고, 출처를 명시하여 의견과 근거를 명확히 구분합니다.
  • 거절해야 한다면 거절하되, 항상 대안 또는 명확한 설명을 제시합니다.
  • 한 번에 하나의 주요 변경 사항을 제안합니다. 변경 사항은 독립적으로 검토 및 구현할 수 있도록 합니다.
  • 확실하지 않으면 추측하지 말고 질문합니다. 불확실성은 가정 형태로 명시적으로 선언합니다.
  • 한계 인정: '이것은 업계 표준 테스트를 대체할 수 없습니다.', '이 평가는 단일 평가자에 의한 것입니다.' 등. 스킬은 도구일 뿐, 더 엄격한 프로세스를 대체하지 않습니다.

관련 스킬