Communitygithub.com

UI/UX Pro Max - 디자인 인텔리전스

웹 및 모바일 애플리케이션을 위한 포괄적인 UI/UX 디자인 가이드입니다. 50개 이상의 스타일, 97개의 색상 팔레트, 57개의 글꼴 페어링, 99개의 UX 가이드라인, 25개의 차트 유형을 9개의 기술 스택에 걸쳐 제공하며, 우선순위 기반 추천 기능을 갖춘 검색 가능한 데이터베이스입니다.

UX Pro Max - 디자인 인텔리전스란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 웹 및 모바일 UI/UX 디자인을 체계적이고 전문적으로 수행할 수 있도록 돕는 포괄적인 디자인 인텔리전스 시스템입니다. 접근성(CRITICAL), 터치 및 상호작용(CRITICAL), 성능(HIGH), 레이아웃 및 반응형(HIGH), 타이포그래피 및 색상(MEDIUM), 애니메이션(MEDIUM), 스타일 선택(MEDIUM), 차트 및 데이터(LOW)의 8가지 우선순위 카테고리로 구분된 방대한 규칙 데이터베이스를 제공합니다. 사용자는 CLI 도구를 통해 특정 제품 유형, 산업, 스타일 키워드를 기반으로 디자인 시스템을 생성(--design-system)하고, 필요한 경우 도메인별 상세 검색을 통해 추가 정보를 얻을 수 있습니다. 생성된 디자인 시스템은 마스터/페이지 오버라이드 패턴을 사용하여 계층적으로 저장 및 검색할 수 있어, 일관성을 유지하면서도 페이지별로 특화된 디자인을 적용할 수 있습니다. React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, Jetpack Compose 등 다양한 스택을 지원하며, 기본 스택은 html-tailwind입니다.

지원 대상~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/ui-ux-pro-max

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

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

문서

UX Pro Max - 디자인 인텔리전스은(는) 무엇을 하나요?

웹 및 모바일 애플리케이션을 위한 포괄적인 디자인 가이드입니다. 50개 이상의 스타일, 97개의 색상 팔레트, 57개의 글꼴 페어링, 99개의 UX 가이드라인, 25개의 차트 유형을 9개의 기술 스택에 걸쳐 제공합니다. 우선순위 기반 추천 기능을 갖춘 검색 가능한 데이터베이스입니다.

적용 시점

다음과 같은 경우 이 가이드라인을 참조하세요:

  • 새 UI 컴포넌트 또는 페이지를 디자인할 때
  • 색상 팔레트와 타이포그래피를 선택할 때
  • UX 문제에 대해 코드를 검토할 때
  • 랜딩 페이지 또는 대시보드를 구축할 때
  • 접근성 요구 사항을 구현할 때

우선순위별 규칙 카테고리

우선순위카테고리영향도메인
1접근성CRITICALux
2터치 및 상호작용CRITICALux
3성능HIGHux
4레이아웃 및 반응형HIGHux
5타이포그래피 및 색상MEDIUMtypography, color
6애니메이션MEDIUMux
7스타일 선택MEDIUMstyle, product
8차트 및 데이터LOWchart

빠른 참조

1. 접근성 (CRITICAL)

  • color-contrast - 일반 텍스트의 경우 최소 4.5:1 비율
  • focus-states - 대화형 요소에 표시 가능한 포커스 링
  • alt-text - 의미 있는 이미지에 대한 설명적인 대체 텍스트
  • aria-labels - 아이콘 전용 버튼에 aria-label
  • keyboard-nav - 탭 순서가 시각적 순서와 일치
  • form-labels - for 속성과 함께 label 사용

2. 터치 및 상호작용 (CRITICAL)

  • touch-target-size - 최소 44x44px 터치 대상
  • hover-vs-tap - 기본 상호작용에는 클릭/탭 사용
  • loading-buttons - 비동기 작업 중 버튼 비활성화
  • error-feedback - 문제 근처에 명확한 오류 메시지 표시
  • cursor-pointer - 클릭 가능한 요소에 cursor-pointer 추가

3. 성능 (HIGH)

  • image-optimization - WebP, srcset, lazy loading 사용
  • reduced-motion - prefers-reduced-motion 확인
  • content-jumping - 비동기 콘텐츠를 위한 공간 확보

4. 레이아웃 및 반응형 (HIGH)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - 모바일에서 본문 텍스트 최소 16px
  • horizontal-scroll - 콘텐츠가 뷰포트 너비에 맞는지 확인
  • z-index-management - z-index 스케일 정의 (10, 20, 30, 50)

5. 타이포그래피 및 색상 (MEDIUM)

  • line-height - 본문 텍스트의 경우 1.5-1.75 사용
  • line-length - 줄당 65-75자로 제한
  • font-pairing - 제목/본문 글꼴 개성 일치

6. 애니메이션 (MEDIUM)

  • duration-timing - 마이크로 인터랙션에 150-300ms 사용
  • transform-performance - width/height가 아닌 transform/opacity 사용
  • loading-states - 스켈레톤 스크린 또는 스피너

7. 스타일 선택 (MEDIUM)

  • style-match - 스타일을 제품 유형에 맞춤
  • consistency - 모든 페이지에서 동일한 스타일 사용
  • no-emoji-icons - 이모지 대신 SVG 아이콘 사용

8. 차트 및 데이터 (LOW)

  • chart-type - 차트 유형을 데이터 유형에 맞춤
  • color-guidance - 접근 가능한 색상 팔레트 사용
  • data-table - 접근성을 위한 테이블 대안 제공

사용 방법

아래 CLI 도구를 사용하여 특정 도메인을 검색하세요.


전제 조건

Python이 설치되어 있는지 확인하세요:

python3 --version || python --version

Python이 설치되어 있지 않은 경우, 사용자 OS에 따라 설치하세요:

macOS:

brew install python3

Ubuntu/Debian:

sudo apt update && sudo apt install python3

Windows:

winget install Python.Python.3.12

이 스킬 사용 방법

사용자가 UI/UX 작업(디자인, 구축, 생성, 구현, 검토, 수정, 개선)을 요청하면 다음 워크플로우를 따르세요:

1단계: 사용자 요구 사항 분석

사용자 요청에서 핵심 정보를 추출하세요:

  • 제품 유형: SaaS, 전자상거래, 포트폴리오, 대시보드, 랜딩 페이지 등
  • 스타일 키워드: 미니멀, 재미있는, 전문적인, 우아한, 다크 모드 등
  • 산업: 의료, 핀테크, 게임, 교육 등
  • 스택: React, Vue, Next.js 또는 기본값 html-tailwind

2단계: 디자인 시스템 생성 (필수)

항상 --design-system으로 시작하여 추론과 함께 포괄적인 권장 사항을 얻으세요:

python3 skills/ui-ux-pro-max/scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]

이 명령은:

  1. 5개 도메인(제품, 스타일, 색상, 랜딩, 타이포그래피)을 병렬로 검색합니다.
  2. ui-reasoning.csv의 추론 규칙을 적용하여 최적의 일치 항목을 선택합니다.
  3. 패턴, 스타일, 색상, 타이포그래피, 효과를 포함한 완전한 디자인 시스템을 반환합니다.
  4. 피해야 할 안티 패턴도 포함합니다.

예시:

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

2b 단계: 디자인 시스템 유지 (마스터 + 오버라이드 패턴)

디자인 시스템을 세션 간 계층적 검색을 위해 저장하려면 --persist를 추가하세요:

python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name"

이렇게 하면 다음이 생성됩니다:

  • design-system/MASTER.md — 모든 디자인 규칙이 포함된 글로벌 소스 오브 트루스
  • design-system/pages/ — 페이지별 오버라이드용 폴더

페이지별 오버라이드 포함:

python3 skills/ui-ux-pro-max/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"

이렇게 하면 다음도 생성됩니다:

  • design-system/pages/dashboard.md — 마스터와 다른 페이지별 규칙

계층적 검색 작동 방식:

  1. 특정 페이지(예: "체크아웃")를 구축할 때 먼저 design-system/pages/checkout.md를 확인합니다.
  2. 페이지 파일이 존재하면 해당 규칙이 마스터 파일을 재정의합니다.
  3. 없으면 design-system/MASTER.md만 사용합니다.

컨텍스트 인식 검색 프롬프트:

[Page Name] 페이지를 구축 중입니다. design-system/MASTER.md를 읽어주세요.
또한 design-system/pages/[page-name].md가 존재하는지 확인하세요.
페이지 파일이 존재하면 해당 규칙을 우선시하세요.
존재하지 않으면 마스터 규칙만 사용하세요.
이제 코드를 생성하세요...

3단계: 상세 검색으로 보충 (필요한 경우)

디자인 시스템을 얻은 후, 도메인별 검색을 사용하여 추가 세부 정보를 얻으세요:

python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]

상세 검색이 필요한 경우:

필요도메인예시
더 많은 스타일 옵션style--domain style "glassmorphism dark"
차트 추천chart--domain chart "real-time dashboard"
UX 모범 사례ux--domain ux "animation accessibility"
대체 글꼴typography--domain typography "elegant luxury"
랜딩 구조landing--domain landing "hero social-proof"

4단계: 스택 가이드라인 (기본값: html-tailwind)

구현별 모범 사례를 얻으세요. 사용자가 스택을 지정하지 않으면 **기본값을 html-tailwind**로 설정하세요.

python3 skills/ui-ux-pro-max/scripts/search.py "<keyword>" --stack html-tailwind

사용 가능한 스택: html-tailwind, react, nextjs, vue, svelte, swiftui, react-native, flutter, shadcn, jetpack-compose


검색 참조

사용 가능한 도메인

도메인용도예시 키워드
product제품 유형 추천SaaS, 전자상거래, 포트폴리오, 의료, 뷰티, 서비스
styleUI 스타일, 색상, 효과glassmorphism, 미니멀리즘, 다크 모드, brutalism
typography글꼴 페어링, Google Fonts우아한, 재미있는, 전문적인, 모던
color제품 유형별 색상 팔레트saas, ecommerce, 의료, 뷰티, fintech, 서비스
landing페이지 구조, CTA 전략히어로, 히어로 중심, 추천사, 가격, 사회적 증명
chart차트 유형, 라이브러리 추천추세, 비교, 타임라인, 퍼널, 파이
ux모범 사례, 안티 패턴애니메이션, 접근성, z-index, 로딩
reactReact/Next.js 성능워터폴, 번들, suspense, memo, 리렌더, 캐시
web웹 인터페이스 가이드라인aria, 포커스, 키보드, 시맨틱, virtualize
promptAI 프롬프트, CSS 키워드(스타일 이름)

사용 가능한 스택

스택초점
html-tailwindTailwind 유틸리티, 반응형, a11y (기본값)
react상태, 훅, 성능, 패턴
nextjsSSR, 라우팅, 이미지, API 라우트
vueComposition API, Pinia, Vue Router
svelteRunes, 스토어, SvelteKit
swiftui뷰, 상태, 네비게이션, 애니메이션
react-native컴포넌트, 네비게이션, 리스트
flutter위젯, 상태, 레이아웃, 테마
shadcnshadcn/ui 컴포넌트, 테마, 폼, 패턴
jetpack-composeComposable, Modifier, 상태 호이스팅, 리컴포지션

예제 워크플로우

사용자 요청: "프로페셔널 스킨케어 서비스 랜딩 페이지 만들어줘"

1단계: 요구 사항 분석

  • 제품 유형: 뷰티/스파 서비스
  • 스타일 키워드: 우아한, 전문적인, 부드러운
  • 산업: 뷰티/웰니스
  • 스택: html-tailwind (기본값)

2단계: 디자인 시스템 생성 (필수)

python3 skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

출력: 패턴, 스타일, 색상, 타이포그래피, 효과, 안티 패턴이 포함된 완전한 디자인 시스템.

3단계: 상세 검색으로 보충 (필요한 경우)

# 애니메이션 및 접근성에 대한 UX 가이드라인 가져오기
python3 skills/ui-ux-pro-max/scripts/search.py "animation accessibility" --domain ux

# 필요한 경우 대체 타이포그래피 옵션 가져오기
python3 skills/ui-ux-pro-max/scripts/search.py "elegant luxury serif" --domain typography

4단계: 스택 가이드라인

python3 skills/ui-ux-pro-max/scripts/search.py "layout responsive form" --stack html-tailwind

그런 다음: 디자인 시스템 + 상세 검색을 종합하고 디자인을 구현하세요.


출력 형식

--design-system 플래그는 두 가지 출력 형식을 지원합니다:

# ASCII 박스 (기본값) - 터미널 표시에 가장 적합
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system

# Markdown - 문서화에 가장 적합
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

더 나은 결과를 위한 팁

  1. 키워드를 구체적으로 입력하세요 - "헬스케어 SaaS 대시보드" > "앱"
  2. 여러 번 검색하세요 - 다른 키워드는 다른 인사이트를 제공합니다.
  3. 도메인을 결합하세요 - 스타일 + 타이포그래피 + 색상 = 완전한 디자인 시스템
  4. 항상 UX를 확인하세요 - 일반적인 문제에 대해 "애니메이션", "z-index", "접근성"을 검색하세요.
  5. 스택 플래그를 사용하세요 - 구현별 모범 사례를 얻으세요.
  6. 반복하세요 - 첫 번째 검색이 맞지 않으면 다른 키워드로 시도해 보세요.

프로페셔널 UI를 위한 일반 규칙

다음은 UI를 비전문적으로 보이게 만드는 자주 간과되는 문제입니다:

아이콘 및 시각적 요소

규칙준수위반
이모지 아이콘 금지SVG 아이콘 사용 (Heroicons, Lucide, Simple Icons)UI 아이콘으로 🎨 🚀 ⚙️ 같은 이모지 사용
안정적인 호버 상태호버 시 색상/불투명도 전환 사용레이아웃을 이동시키는 스케일 변환 사용
올바른 브랜드 로고Simple Icons에서 공식 SVG 조사추측하거나 잘못된 로고 경로 사용
일관된 아이콘 크기고정 viewBox(24x24)와 w-6 h-6 사용다른 아이콘 크기를 무작위로 혼합

상호작용 및 커서

규칙준수위반
커서 포인터모든 클릭 가능/호버 가능 카드에 cursor-pointer 추가대화형 요소에 기본 커서 유지
호버 피드백시각적 피드백 제공 (색상, 그림자, 테두리)요소가 상호작용 가능하다는 표시 없음
부드러운 전환transition-colors duration-200 사용즉각적인 상태 변경 또는 너무 느림 (>500ms)

라이트/다크 모드 대비

규칙준수위반
라이트 모드 유리 카드bg-white/80 이상의 불투명도 사용bg-white/10 사용 (너무 투명함)
라이트 텍스트 대비텍스트에 #0F172A (slate-900) 사용본문 텍스트에 #94A3B8 (slate-400) 사용
라이트 뮤트 텍스트최소 #475569 (slate-600) 사용gray-400 또는 더 밝은 색상 사용
테두리 가시성라이트 모드에서 border-gray-200 사용border-white/10 사용 (보이지 않음)

레이아웃 및 간격

규칙준수위반
플로팅 네비게이션 바top-4 left-4 right-4 간격 추가네비게이션 바를 top-0 left-0 right-0에 고정
콘텐츠 패딩고정 네비게이션 바 높이 고려콘텐츠가 고정 요소 뒤에 숨도록 함
일관된 최대 너비동일한 max-w-6xl 또는 max-w-7xl 사용다른 컨테이너 너비 혼합

전달 전 체크리스트

UI 코드를 전달하기 전에 다음 항목을 확인하세요:

시각적 품질

  • 아이콘으로 이모지 사용 안 함 (대신 SVG 사용)
  • 모든 아이콘이 일관된 아이콘 세트에서 가져옴 (Heroicons/Lucide)
  • 브랜드 로고가 올바름 (Simple Icons에서 확인)
  • 호버 상태로 인한 레이아웃 이동 없음
  • 테마 색상을 직접 사용 (bg-primary)하고 var() 래퍼 사용 안 함

상호작용

  • 모든 클릭 가능한 요소에 cursor-pointer 있음
  • 호버 상태가 명확한 시각적 피드백 제공
  • 전환이 부드러움 (150-300ms)
  • 키보드 탐색을 위한 포커스 상태 표시

라이트/다크 모드

  • 라이트 모드 텍스트가 충분한 대비를 가짐 (최소 4.5:1)
  • 유리/투명 요소가 라이트 모드에서 보임
  • 두 모드 모두에서 테두리가 보임
  • 전달 전 두 모드 모두 테스트

레이아웃

  • 플로팅 요소가 가장자리로부터 적절한 간격을 가짐
  • 고정 네비게이션 바 뒤에 숨겨진 콘텐츠 없음
  • 375px, 768px, 1024px, 1440px에서 반응형
  • 모바일에서 가로 스크롤 없음

접근성

  • 모든 이미지에 대체 텍스트 있음
  • 양식 입력에 레이블 있음
  • 색상이 유일한 지표가 아님
  • prefers-reduced-motion 존중

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

관련 스킬