요약
여러 플랫폼에서 전문가 수준 UI/UX를 만들도록 디자인 지능을 주는 AI 스킬. MIT
설명
UI UX Pro Max
여러 플랫폼과 프레임워크에서 전문가 수준의 UI/UX를 만들 수 있도록 디자인 지능을 제공하는 AI 스킬입니다.

이 프로젝트가 도움이 된다면 후원을 고려해 주세요.
다른 프로젝트: NextLevelBuilder.io | GoClaw.sh | AgentKit.best | TOSE.sh
새 스킬도 확인해 보세요
아이디어를 탐험할 가치가 있는 3D 장면으로 바꿔 보세요.

시각적 영감일 뿐 벤치마크는 아닙니다. 이 스킬이 생기기 전에 작성자가 녹화한 프로젝트이며 UI에 베트남어가 들어 있습니다. 역사적 영상이며 영어 데모나 이 스킬의 실행 테스트가 아닙니다.
웹사이트: https://3dviz.dev/
v2.0의 새로운 점
지능형 디자인 시스템 생성
v2.0의 핵심 기능은 디자인 시스템 생성기입니다. 프로젝트 요구 사항을 분석해 몇 초 만에 완성된 맞춤형 디자인 시스템을 만들어 주는 AI 추론 엔진입니다.
+----------------------------------------------------------------------------------------+
| TARGET: Serenity Spa - RECOMMENDED DESIGN SYSTEM |
+----------------------------------------------------------------------------------------+
| |
| PATTERN: Hero-Centric + Social Proof |
| Conversion: Emotion-driven with trust elements |
| CTA: Above fold, repeated after testimonials |
| Sections: |
| 1. Hero |
| 2. Services |
| 3. Testimonials |
| 4. Booking |
| 5. Contact |
| |
| STYLE: Soft UI Evolution |
| Keywords: Soft shadows, subtle depth, calming, premium feel, organic shapes |
| Best For: Wellness, beauty, lifestyle brands, premium services |
| Performance: cost:low | Accessibility: risk:conditional; verify requirements |
| |
| COLORS: |
| Primary: #E8B4B8 (Soft Pink) |
| Secondary: #A8D5BA (Sage Green) |
| CTA: #D4AF37 (Gold) |
| Background: #FFF5F5 (Warm White) |
| Text: #2D3436 (Charcoal) |
| Notes: Calming palette with gold accents for luxury feel |
| |
| TYPOGRAPHY: Cormorant Garamond / Montserrat |
| Mood: Elegant, calming, sophisticated |
| Best For: Luxury brands, wellness, beauty, editorial |
| Google Fonts: https://fonts.google.com/share?selection.family=... |
| |
| KEY EFFECTS: |
| Soft shadows + Context-appropriate transitions + Gentle hover states |
| |
| AVOID (Anti-patterns): |
| Bright neon colors + Harsh animations + Dark mode + AI purple/pink gradients |
| |
| PRE-DELIVERY CHECKLIST: |
| [ ] No emojis as icons (use SVG: Heroicons/Lucide) |
| [ ] cursor-pointer on all clickable elements |
| [ ] Interaction timing follows the platform, component, and user preference |
| [ ] Light mode: text contrast 4.5:1 minimum |
| [ ] Focus states visible for keyboard nav |
| [ ] prefers-reduced-motion respected |
| [ ] Text, chips, and badges reflow without clipping or broken labels |
| [ ] Responsive: 375px, 768px, 1024px, 1440px |
| |
+----------------------------------------------------------------------------------------+
디자인 시스템 생성이 동작하는 방식
- 사용자 요청: "뷰티 스파 랜딩 페이지를 만들어 줘"
- 다중 도메인 검색(병렬 5회): 제품 유형 매칭(192개 범주), 스타일 추천(검색 가능 80개, 활성 51개), 색상 팔레트 선택(192개), 랜딩 페이지 패턴(34개), 타이포그래피 조합(74개)
- 추론 엔진: 제품을 UI 범주 규칙에 맞추고, 스타일 우선순위를 적용(BM25 순위)하고, 업종별 안티패턴을 거르고, 결정 규칙(JSON 조건)을 처리합니다.
- 완성된 디자인 시스템 출력: 패턴 + 스타일 + 색상 + 타이포그래피 + 효과 + 피해야 할 안티패턴 + 납품 전 체크리스트
업종별 추론 규칙 192개
추론 엔진에는 다음 분야의 전문 규칙이 들어 있습니다.
| 범주 | 예 |
|---|---|
| 테크 & SaaS | SaaS, 마이크로 SaaS, B2B 서비스, 개발자 도구 / IDE, AI/챗봇 플랫폼, 사이버 보안 플랫폼 |
| 금융 | 핀테크/암호화폐, 은행, 보험, 개인 재무 추적기, 청구서 · 결제 도구 |
| 헬스케어 | 의료 클리닉, 약국, 치과, 동물병원, 정신 건강, 복약 알림 |
| 이커머스 | 일반, 럭셔리, 마켓플레이스(P2P), 구독 박스, 음식 배달 |
| 서비스 | 뷰티/스파, 레스토랑, 호텔, 법률, 홈 서비스, 예약 · 약속 |
| 크리에이티브 | 포트폴리오, 에이전시, 사진, 게임, 음악 스트리밍, 사진/영상 편집기 |
| 라이프스타일 | 습관 추적기, 레시피 · 요리, 명상, 날씨, 일기, 기분 추적기 |
| 신기술 | Web3/NFT, 공간 컴퓨팅, 양자 컴퓨팅, 자율 드론 함대 |
각 규칙에는 다음이 들어 있습니다.
- 추천 패턴 - 랜딩 페이지 구조
- 스타일 우선순위 - 가장 잘 맞는 UI 스타일
- 색상 분위기 - 업종에 맞는 팔레트
- 타이포그래피 분위기 - 글꼴 성격 매칭
- 핵심 효과 - 애니메이션과 상호작용
- 안티패턴 - 하면 안 되는 것(예: 은행 서비스에 "AI 보라/분홍 그라데이션")
기능
- 검색 가능한 UI 스타일 80개(활성 51개) - Glassmorphism, Claymorphism, Minimalism, Brutalism, Neumorphism, Bento Grid, Dark Mode, AI-Native UI 등
- 색상 팔레트 192개 - 192개 제품 유형과 1:1로 맞춘 업종별 팔레트
- 글꼴 조합 74개 - Google Fonts 가져오기가 포함된 선별된 타이포그래피 조합
- 차트 유형 25개 - 대시보드와 분석을 위한 추천
- 기술 스택 22개 - React, Next.js, Astro, Vue, Nuxt.js, Nuxt UI, Svelte, SwiftUI, React Native, Flutter, HTML+Tailwind, shadcn/ui, Jetpack Compose, Angular, Laravel, Three.js, JavaFX, WPF, WinUI 3, UWP, Avalonia, Uno Platform
- UX 가이드라인 120개 - 모범 사례, 안티패턴, 접근성 규칙, 유연한 텍스트 레이아웃, 작은 라벨, 취소 가능한 상호작용. IME 안전 Enter 단축키를 보세요.
- 추론 규칙 192개 - 업종별 디자인 시스템 생성(v2.0 신규)
유연한 텍스트와 컴팩트 UI
지침은 제목, 긴 토큰, 칩, 뱃지, 중단된 마이크로 인터랙션에서 자주 생기는 운영 문제를 다룹니다.
- 균형 잡힌 제목 줄바꿈은 점진적 향상이지, 특정 단어가 마지막 줄에 남는다는 보장이 아닙니다. 디자인은 너비, 글꼴, 로케일에 따른 자연스러운 줄바꿈에도 동작해야 합니다.
- 필수 텍스트는 좁은 너비, 브라우저 확대, 텍스트 크기 조절, 사용자 간격 재정의에서도 잘리지 않고 다시 흐르어야 합니다. 긴 URL과 식별자는 안전하게 줄바꿈할 수 있습니다.
- 칩과 태그 모음은 줄바꿈하거나 조작 가능한
+n펼침을 써야 합니다. 작은 라벨은 가능하면 통째로 유지하고, 불가피하게 잘라낸다면 키보드 · 포인터 · 터치 사용자 모두가 전체 값에 접근할 수 있는 경로가 있어야 합니다. - 뱃지의 의미는 색상만으로 전달해서는 안 됩니다. 상호작용 칩은 네이티브 시맨틱, 보이는 포커스, 프로그램으로 읽을 수 있는 상태가 필요하고, 실시간 카운트에는 의미 있는 맥락이 필요합니다.
- 빠른 상호작용이 애니메이션을 취소해도 최종 의미 상태, 포커스, 내용은 올바르게 유지되어야 합니다. 타이밍은 플랫폼과 컴포넌트에 맞춰 고르고, 모션 감소 설정을 존중합니다.
스타일 분류체계
카탈로그에는 안정적인 ID와 별칭이 있는 검색 가능한 스타일 80개가 들어 있습니다.
| 상태 | 개수 | 검색 동작 |
|---|---|---|
| 활성 | 51 | 일반 추천에 포함되고 갤러리에 기본으로 표시됨 |
| 보조 | 29 | 정확한 이름 또는 명시적인 변형 · 시스템 의도일 때 반환되며 갤러리의 상태 필터로 쓸 수 있음 |
| 사용 중단 | 9 | 일반 순위에서 제외되며 이전 이름은 표준 스타일이나 랜딩 페이지 패턴으로 연결됨 |
활성 스타일은 일반 시각 계열 43개, 모바일 전용 스타일 2개, 공식 플랫폼/디자인 시스템 4개, 플랫폼 재질 1개, 핵심 분석 스타일 1개를 다룹니다. 지금 포함된 공식 시스템은 Fluent 2, Shopify Polaris, Adobe Spectrum, Apple Native Experience입니다. Liquid Glass는 Apple 플랫폼 재질로 다루고, Material 3 Expressive는 모바일 Material 변형으로 남아 있으며, Spectrum 2는 보조 스타일입니다. 랜딩 페이지 구조는 BM25 순위에서 시각 스타일과 경쟁하지 않도록 별도의 34개 패턴 데이터셋에 들어 있습니다.
전체 분류체계와 출처 정보가 담긴 메타데이터는 styles.csv를 보세요.
💎 기본판 vs. 프리미엄판 비교
오픈소스판과 프리미엄판의 차이를 묻는 분이 많습니다. 작업 방식에 맞는 판을 고르는 데 도움이 되도록 자세히 나눠 봅니다.
🟢 기본판(이 저장소)
- 완전 오픈소스: 개인 개발자, 취미 사용자, 표준 프로젝트에 알맞습니다.
- 핵심 UI/UX 지능: 검색 가능한 UI 스타일 80개(활성 51개), 제품 유형 192개, 색상 팔레트, 선별된 글꼴 조합에 전체 접근할 수 있습니다.
- 스마트 추천: 정확한 디자인 매칭을 위한 BM25 검색 엔진이 내장되어 있습니다.
- 크로스 플랫폼 지원: 주요 프레임워크 22개(React, Vue, Tailwind, iOS, Android 등)를 위한 스택별 가이드라인.
- 디자인 시스템 생성: CLI로 맞춤 UI 규칙, 패턴, 로직을 즉시 만들어 줍니다.
🟡 프리미엄판
- 확장된 브랜드 디자인 스킬: UI/UX를 넘어 브랜드 아이덴티티 생성, 로고 디자인, 기업 아이덴티티 프로그램(CIP), 배너, 발표 슬라이드, 맞춤 아이콘까지 다룹니다.
- 고급 자산 제작: AI 이미지 생성과 깊이 통합되어 자리표시가 아닌 실제 시각 자산을 만듭니다.
- 엔터프라이즈 아키텍처: 대규모 팀 배포를 위해 만든 더 포괄적이고 확장 가능한 디자인 토큰 아키텍처.
- 우선 지원: 끊김 없는 전체 디자인 워크플로가 필요한 팀과 전문가를 위한 전담 기술 지원.
프리미엄 등급으로 올리는 자세한 내용은 uupm.cc를 보세요.
설치
Claude Marketplace 사용(Claude Code)
두 명령으로 Claude Code에 바로 설치합니다.
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
CLI 사용(권장)
# Install CLI globally
npm install -g ui-ux-pro-max-cli
# Go to your project
cd /path/to/your/project
# Install for your AI assistant
uipro init --ai claude # Claude Code
uipro init --ai cursor # Cursor
uipro init --ai windsurf # Windsurf
uipro init --ai antigravity # Antigravity
uipro init --ai copilot # GitHub Copilot
uipro init --ai kiro # Kiro
uipro init --ai codex # Codex CLI
uipro init --ai qoder # Qoder
uipro init --ai roocode # Roo Code
uipro init --ai gemini # Gemini CLI
uipro init --ai trae # Trae
uipro init --ai opencode # OpenCode
uipro init --ai continue # Continue
uipro init --ai codebuddy # CodeBuddy
uipro init --ai droid # Droid (Factory)
uipro init --ai kilocode # KiloCode
uipro init --ai warp # Warp
uipro init --ai augment # Augment
uipro init --ai codewhale # CodeWhale
uipro init --ai zcode # ZCode
uipro init --ai kimi # Kimi Code
uipro init --ai amazonq # Amazon Q Developer
uipro init --ai openclaw # OpenClaw (.agents/skills/)
uipro init --ai autoclaw # AutoClaw (skills/ or ~/.openclaw-autoclaw/skills)
uipro init --ai universal # Universal / Agent Standard (.agents/skills/)
uipro init --ai all # All assistants
npm 패키지 이름은 ui-ux-pro-max-cli이며, 여전히 uipro 명령을 설치합니다. 이전의 uipro-cli 릴리스는 오래되어 현재 자산에 쓰면 안 됩니다.
전역 설치(모든 프로젝트에서 사용)
uipro init --ai claude --global # Install to ~/.claude/skills/
uipro init --ai cursor --global # Install to ~/.cursor/skills/
uipro init --ai zcode --global # Install to ~/.zcode/skills/
uipro init --ai kimi --global # Install to ~/.kimi-code/skills/
uipro init --ai universal --global # Install to ~/.agents/skills/
다른 CLI 명령
uipro versions # List available versions
uipro update # Refresh skill files from installed CLI package
uipro update --global # Refresh global skill files from installed CLI package
uipro init --offline # Compatibility flag; installs bundled templates
uipro init --dry-run # Preview install actions without writing files
uipro uninstall # Remove skill (auto-detect platform)
uipro uninstall --ai claude # Remove specific platform
uipro uninstall --global # Remove from global install
준비물
검색 스크립트를 쓰려면 Python 3.x가 필요합니다(표준 라이브러리만 사용하며, 스크립트는 아무것도 설치하지 않고 네트워크 호출도 하지 않습니다).
Python이 설치되어 있는지 확인하세요.
python3 --version
없으면 python.org에서, 또는 운영체제 패키지 관리자(Homebrew, apt, winget)로 직접 설치하세요. 이 설치 단계는 사람 사용자인 여러분을 위한 것이며, 이 스킬을 쓰는 AI 에이전트는 여러분의 컬퓨터에 소프트웨어를 설치하지 않고 대신 묻도록 지시받습니다.
사용법
스킬 모드(자동 활성화)
지원: Claude Code, Cursor, Windsurf, Antigravity, Codex CLI, Continue, Gemini CLI, OpenCode, Qoder, CodeBuddy, Droid (Factory), KiloCode, Warp, Augment, CodeWhale, ZCode, Kimi Code, Amazon Q Developer, OpenClaw, GitHub Copilot
UI/UX 작업을 요청하면 스킬이 자동으로 활성화됩니다. 평소처럼 대화하면 됩니다.
Build a landing page for my SaaS product
💡 Trae 먼저 SOLO 모드로 전환하세요. UI/UX 요청에 스킬이 활성화됩니다.
워크플로 모드(슬래시 명령)
지원: Kiro, Roo Code, KiloCode
슬래시 명령으로 스킬을 호출합니다.
/ui-ux-pro-max Build a landing page for my SaaS product
프롬프트 예시
Build a landing page for my SaaS product
Create a dashboard for healthcare analytics
Design a portfolio website with dark mode
Make a mobile app UI for e-commerce
Build a fintech banking app with dark theme
이미 만든 앱에 테마 적용하기
스킬을 설치한 뒤 AI 어시스턴트에서 앱을 열고 다음과 같은 프롬프트를 쓰세요. 워크플로 모드에서는 앞에 /ui-ux-pro-max를 붙입니다.
Use the ui-ux-pro-max skill to retheme my existing React app.
Target style: Minimalism & Swiss Style.
First inspect the framework and styling-library versions, routes, components,
styles, and existing theme tokens. Keep the current component structure,
behavior, and business logic.
Reuse and update the existing semantic tokens for colors, typography, spacing,
radii, shadows, and interaction states; add missing tokens rather than creating
a parallel theme system. Replace hard-coded styles one component at a time.
Verify contrast, keyboard focus, responsive layouts, and all supported light/dark
modes. Summarize changed files and any remaining hard-coded styles.
Minimalism & Swiss Style을 원하는 카탈로그 스타일이나 시각적 방향으로 바꾸세요. 검색 결과는 디자인 지침일 뿐 앱을 자동으로 다시 쓰지는 않습니다.
테마 이전 체크리스트:
- 점검: 스타일시트, 인라인 스타일,
bg-blue-600·text-[#1e293b]같은 유틸리티에서 테마와 관련된 하드코딩 값을 찾습니다. - 매핑: 앱이 쓰는 스타일링 시스템에서
background,surface,foreground,primary,border,ring같은 시맨틱 역할을 재사용합니다. 빠진 역할은 설치된 라이브러리 버전의 규칙에 맞게 추가합니다. - 이전: 하드코딩 값을 작은 컴포넌트 묶음 단위로 토큰 참조로 바꿉니다. 토큰만 바꾸면 토큰을 쓰지 않는 스타일에는 영향이 없습니다.
- 검증: 묶음마다 텍스트/UI 대비, hover/focus/disabled 상태, 반응형 레이아웃, 지원하는 각 테마를 확인합니다.
동작 방식
- 요청 - 어떤 UI/UX 작업이든 요청합니다(build, design, create, implement, review, fix, improve).
- 디자인 시스템 생성 - AI가 추론 엔진으로 완성된 디자인 시스템을 자동으로 만듭니다.
- 스마트 추천 - 제품 유형과 요구 사항에 맞는 가장 좋은 스타일, 색상, 타이포그래피를 찾습니다.
- 코드 생성 - 알맞은 색상, 글꼴, 간격, 모범 사례로 UI를 구현합니다.
- 납품 전 점검 - 흔한 UI/UX 안티패턴에 대해 검증합니다.
지원 스택
이 스킬은 다음의 스택별 가이드라인을 제공합니다.
| 분류 | 스택 |
|---|---|
| 웹(HTML) | HTML + Tailwind(기본) |
| React 생태계 | React, Next.js, shadcn/ui |
| Vue 생태계 | Vue, Nuxt.js, Nuxt UI |
| Angular | Angular |
| PHP | Laravel(Blade, Livewire, Inertia.js) |
| 그 밖 웹 | Svelte, Astro, Three.js |
| 데스크톱 | JavaFX, WPF, WinUI 3, Avalonia, Uno Platform, UWP |
| iOS | SwiftUI |
| Android | Jetpack Compose |
| 크로스 플랫폼 | React Native, Flutter |
프롬프트에 원하는 스택을 언급하거나, 언급하지 않으면 HTML + Tailwind가 기본입니다.
예시
전/후: 운영 대시보드
밋밋한 운영 대시보드(전)를, search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4로 UI UX Pro Max가 만들어 준 디자인 시스템만으로 다시 꾸민 결과(후)입니다.
커뮤니티가 올린 설명용 예시이며, 공식 데모나 벤치마크, 이 스킬의 실행 테스트가 아닙니다.
디자인 시스템 명령(고급)
디자인 시스템 생성기를 직접 쓰는 방법입니다.
💡 참고 Continue로 설치했다면 아래 명령의
.claude/skills/를.continue/skills/로, Droid (Factory)는.factory/skills/, ZCode는.zcode/skills/, Amazon Q Developer는.amazonq/skills/로 바꾸세요(Amazon Q는.amazonq/rules/ui-ux-pro-max.md의 규칙만 자동으로 불러오며,.amazonq/skills/의 데이터와 스크립트는 이 규칙이 가리키는 파일입니다).
# Generate design system with ASCII output
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "beauty spa wellness" --design-system -p "Serenity Spa"
# Generate with Markdown output
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --design-system -f markdown
# Export design tokens (requires --design-system)
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech dashboard" --design-system --tokens dtcg
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech dashboard" --design-system --tokens css
# Domain-specific search
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux
# Stack-specific guidelines
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind
웹 스택 검색은 버전을 인식합니다. 이전 메이저 버전을 쓰지 않은 질의는 최신의 활성 가이드를 돌려줍니다. 명시적인 레거시 용어나 이전 메이저 버전(예: Svelte 4, Next.js 15)은 Status와 Applies To로 표시된 선별된 레거시 행만 돌려주며, 맞는 레거시 가이드가 없으면 프레임워크 세대를 섞지 않고 결과를 비울니다.
RTL 호환성(--rtl)
모든 스타일과 제품 행에는 오른쪽에서 왼쪽으로 읽는 인터페이스(아랍어, 히브리어, 페르시아어, 우르두어)용 rtl_level이 들어 있습니다.
| 수준 | 뜻 |
|---|---|
full | 방향에 관계없음: 레이아웃이 뒤집어도 그대로 유지됩니다. |
partial | 깔끈하게 뒤집히지만 개별 컴포넌트와 모션은 조정이 필요합니다. |
caveats | 스타일이나 제품이 읽는 방향을 담고 있습니다(운동 타이포그래피, LTR 타임라인, 코드/터미널 화면, 지도와 좌석 순서). |
# Only styles that mirror without extra work
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full
# All levels, filtered results still tagged with rtl_level
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "mobile" --domain style --rtl
--rtl은 명시적인 --domain style 또는 --domain product가 필요합니다. 필터는 순위를 매긴 뒤 -n/--max-results로 자르기 전에 적용되므로, 좁은 한도가 맞는 행을 가리지 않습니다. --design-system이나 --stack과 함께는 쓸 수 없습니다.
디자인 시스템 저장(마스터 + 오버라이드 패턴)
세션을 넘어 계층적으로 불러올 수 있도록 디자인 시스템을 파일로 저장합니다.
# Generate and persist to design-system/myapp/MASTER.md
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp"
# Also create a page-specific override file
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist -p "MyApp" --page "dashboard"
# Also write a self-contained preview.html next to MASTER.md
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist --preview -p "MyApp"
# Persist machine-readable tokens next to MASTER.md (tokens are master-level only)
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist --tokens dtcg -p "MyApp"
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS dashboard" --design-system --persist --tokens css -p "MyApp"
--preview는 --design-system이 필요합니다. --persist와 함께 쓰면 MASTER.md 옆에 preview.html을 씁니다. --persist 없이는 --output-dir를 주면 거기에 쓰고, 없으면 경로가 출력되는 임시 파일에 씁니다. 이미 있는 파일은 --force를 함께 주지 않으면 건너뜁니다.
--tokens dtcg는 W3C Design Tokens JSON을, --tokens css는 :root CSS 변수를 출력합니다. 둘 다 --design-system이 필요합니다. --persist와 함께 쓰면 MASTER.md 옆에 tokens.json(그리고 --tokens css일 때 tokens.css)이 써집니다. --page 오버라이드는 토큰 파일을 만들지 않습니다.
이렇게 하면 design-system/ 폴더 구조가 만들어집니다.
design-system/
└── myapp/ # One folder per project (slug of -p "MyApp")
├── MASTER.md # Global Source of Truth (colors, typography, spacing, components)
├── preview.html # Static preview of the generated palette, type, and components
├── tokens.json # W3C Design Tokens (when persisted with --tokens)
├── tokens.css # CSS variables (when persisted with --tokens css)
└── pages/
└── dashboard.md # Page-specific overrides (only deviations from Master)
계층적 불러오기가 동작하는 방식:
- 특정 페이지(예: "Checkout")를 만들 때는 먼저
design-system/[project-slug]/pages/checkout.md를 확인합니다. - 페이지 파일이 있으면 그 규칙이 마스터 파일을 덮어씁니다.
- 없으면
design-system/[project-slug]/MASTER.md만 씁니다.
맥락을 아는 불러오기 프롬프트:
I am building the [Page Name] page. Please read design-system/[project-slug]/MASTER.md.
Also check if design-system/[project-slug]/pages/[page-name].md exists.
If the page file exists, prioritize its rules.
If not, use the Master rules exclusively.
Now, generate the code...
구조와 기여
사용자를 위한 안내
코드베이스는 템플릿 기반 생성 시스템을 쓰도록 개편되었습니다. 플랫폼별 파일(.cursor/, .windsurf/, .kiro/, .factory/ 등)은 이제 CLI가 동적으로 생성합니다.
설치는 항상 CLI로 하세요.
npm install -g ui-ux-pro-max-cli
uipro init --ai <platform>
이렇게 하면 설치된 CLI 패키지에 포함된 최신 템플릿과 AI 어시스턴트에 맞는 올바른 파일 구조를 얻습니다. 새 릴리스가 나오면 먼저 npm 패키지를 업데이트하세요.
기여자를 위한 안내
이 프로젝트에 기여하려면 다음과 같이 합니다.
# 1. Clone the repository
git clone https://github.com/nextlevelbuilder/ui-ux-pro-max-skill.git
cd ui-ux-pro-max-skill
# 2. Understand the structure
src/ui-ux-pro-max/ # Source of truth (data, scripts, templates)
cli/ # CLI installer (generates files from templates)
.claude/ # Local dev/test for Claude Code skill
.factory/ # Local dev/test for Droid (Factory) skill
# 3. Make changes in src/ui-ux-pro-max/
# - data/*.csv → Database files
# - scripts/*.py → Search engine & design system
# - templates/ → Platform-specific templates
# 4. Sync to CLI and test locally
cd cli
npm run sync:assets
npm run check:assets
npm run verify:data
npm run typecheck
# 5. Build and test CLI
npm run build
node dist/index.js init --ai claude --offline # Test in a temp folder
node dist/index.js init --ai claude --dry-run # Preview install actions (no writes)
# 6. Create PR (never push directly to main)
git checkout -b feat/your-feature
git commit -m "feat: description"
git push -u origin feat/your-feature
gh pr create
자세한 개발 지침은 CLAUDE.md를 보세요.
문제 해결
Claude Code가 response exceeded the ... output token maximum를 알릴 때
이것은 UI UX Pro Max 설치 프로그램이나 검색 스크립트의 오류가 아니라 Claude Code의 한 번 응답 한도입니다. 먼저 Claude에게 작업을 더 작은 단계로 나눠 달라고 하고, 큰 결과는 파일에 점진적으로 쓰도록 하세요. 한 번에 더 큰 응답이 꼭 필요하고 쓰는 모델이 지원한다면, 새 세션을 시작하기 전에 Claude Code의 출력 토큰 한도를 설정하세요. 예:
# macOS, Linux, or WSL
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="64000"
claude
uipro: unknown command 'uninstall' 또는 unknown command 'update'
설치한 ui-ux-pro-max-cli 버전이 오래된 것입니다. 업데이트한 뒤 다시 시도하세요.
npm install -g ui-ux-pro-max-cli@latest
uipro uninstall
Claude.ai의 "Upload a skill"에서 "Zip contains too many files (maximum 200)"가 나올 때
GitHub 저장소 전체 ZIP을 올리지 마세요. 소스 코드, CLI 자산, 문서, 미리보기, 여러 번들 스킬이 들어 있는 개발용 체크아웃이라 Claude의 200개 파일 업로드 한도를 넘습니다. 이 프로젝트는 Claude.ai용 수동 업로드 ZIP을 따로 배포하지 않습니다. Claude Code에는 Marketplace나 CLI 설치 프로그램을 쓰세요.
Python을 찾을 수 없다고 나올 때
검색 스크립트는 Python 3.x가 필요합니다. python.org에서 또는 운영체제 패키지 관리자로 직접 설치하세요. AI 에이전트는 설치해 주지 않고 묻도록 지시받습니다.
디자인 시스템 출력이 잘리거나 필드가 잘릴 때
사람이 읽는 출력은 긴 필드를 300자에서 자릅니다. --json을 쓰면 잘림 없는 전체 데이터를 얻습니다.
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --json
더 알아보기
카탈로그 출처와 갱신(Google Fonts 1,934개 승인 목록, Phosphor 아이콘 카탈로그, 주간 카탈로그 갱신 워크플로), 자동 릴리스(Conventional Commits 기반 semantic-release), 아랍어 · 히브리어 · 페르시아어용 RTL 내용 등 세부 절차는 저장소 README의 아래 절에 있습니다.
- Architecture & Contributing - Catalog provenance and refresh
- Automated Releases
스타 히스토리
라이선스
이 프로젝트는 MIT 라이선스로 배포됩니다.
호환 에이전트
이 스킬은 다음과 함께 동작합니다.
- Claude Code
- AdaL - 자기 진화하는 AI 코딩 에이전트(문서 | GitHub)
저장소
평점
- 5점
- 0
- 4점
- 0
- 3점
- 0
- 2점
- 0
- 1점
- 0