50 KiB
UI UX Pro Max
🇦🇿 Azərbaycanca | 🇮🇩 Bahasa Indonesia | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇻🇳 Tiếng Việt | 🇨🇳 简体中文 | 🇺🇸 English | 🇫🇷 Français | 🇮🇷 فارسی
An AI skill that provides design intelligence for building professional UI/UX across multiple platforms and frameworks. 複数のプラットフォームとフレームワークで、プロフェッショナルな UI/UX を構築するためのデザインインテリジェンスを提供する AI スキルです。
役に立ったと感じたら、プロジェクトへのご支援をご検討ください:
その他のプロジェクト
NextLevelBuilder.io | GoClaw.sh | AgentKit.best | TOSE.sh
アイデアを、探索したくなる 3D シーンに。
ビジュアルのインスピレーションであり、ベンチマークではありません。 このスキルが存在する前に録画された、作者提供のプロジェクトです。UI にはベトナム語が含まれています。過去の映像であり、英語のデモでもスキルの実行時テストでもありません。メディアの出所をご覧ください。
🤌 Web サイト:https://3dviz.dev/
v2.0 の新機能
インテリジェントなデザインシステム生成
v2.0 の目玉機能は Design System Generator です。プロジェクトの要件を分析し、ニーズに合わせた完全なデザインシステムを数秒で生成する、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 |
| |
+----------------------------------------------------------------------------------------+
デザインシステム生成の仕組み
┌─────────────────────────────────────────────────────────────────┐
│ 1. USER REQUEST │
│ "Build a landing page for my beauty spa" │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. MULTI-DOMAIN SEARCH (5 parallel searches) │
│ • Product type matching (192 categories) │
│ • Style recommendations (80 searchable; 51 active) │
│ • Color palette selection (192 palettes) │
│ • Landing page patterns (34 patterns) │
│ • Typography pairing (74 font combinations) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 3. REASONING ENGINE │
│ • Match product → UI category rules │
│ • Apply style priorities (BM25 ranking) │
│ • Filter anti-patterns for industry │
│ • Process decision rules (JSON conditions) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ 4. COMPLETE DESIGN SYSTEM OUTPUT │
│ Pattern + Style + Colors + Typography + Effects │
│ + Anti-patterns to avoid + Pre-delivery checklist │
└─────────────────────────────────────────────────────────────────┘
192 の業界別推論ルール
推論エンジンには、次の分野向けの専用ルールが含まれています:
| カテゴリ | 例 |
|---|---|
| テック & SaaS | SaaS、Micro SaaS、B2B サービス、開発者ツール / IDE、AI/チャットボットプラットフォーム、サイバーセキュリティプラットフォーム |
| 金融 | フィンテック/暗号資産、銀行、保険、個人の家計管理、請求書・課金ツール |
| ヘルスケア | 医療クリニック、薬局、歯科、動物病院、メンタルヘルス、服薬リマインダー |
| E コマース | 一般、ラグジュアリー、マーケットプレイス (P2P)、サブスクリプションボックス、フードデリバリー |
| サービス | 美容/スパ、レストラン、ホテル、法律、ホームサービス、予約・アポイントメント |
| クリエイティブ | ポートフォリオ、エージェンシー、写真、ゲーム、音楽ストリーミング、写真/動画編集 |
| ライフスタイル | 習慣トラッカー、レシピ・料理、瞑想、天気、日記、気分トラッカー |
| 新興テック | Web3/NFT、空間コンピューティング、量子コンピューティング、自律型ドローン群 |
各ルールには次の内容が含まれます:
- Recommended Pattern - ランディングページの構成
- Style Priority - 最も適した UI スタイル
- Color Mood - 業界にふさわしいパレット
- Typography Mood - フォントの個性のマッチング
- Key Effects - アニメーションとインタラクション
- Anti-Patterns - やってはいけないこと(例:銀行向けの「AI purple/pink gradients」)
機能
- 80 の検索可能な UI スタイル(うち 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
- 120 の UX ガイドライン - ベストプラクティス、アンチパターン、アクセシビリティのルール、崩れにくいテキストレイアウト、コンパクトなラベル、キャンセル可能なインタラクション
- 192 の推論ルール - 業界別のデザインシステム生成(v2.0 の新機能)
崩れにくいテキストとコンパクトな UI
見出し、長いトークン、チップ、バッジ、中断されたマイクロインタラクションに関する、 本番環境でよくある不具合もガイダンスでカバーするようになりました:
- 見出しのバランスの取れた折り返しはプログレッシブエンハンスメントであり、特定の単語が 最終行に残ることを保証するものではありません。デザインは、幅、フォント、ロケールが変わっても、 自然な折り返しで機能する必要があります。
- 重要なテキストは、狭い幅、ブラウザのズーム、テキストの拡大、ユーザーによる間隔の上書きのもとでも、 切れずにリフローする必要があります。長い URL や識別子は安全に折り返してかまいません。
- チップやタグの集まりは、折り返すか、操作可能な
+nの開示を使うべきです。コンパクトな ラベルは、可能な限り途切れずに表示されるべきです。やむを得ず省略する場合は、キーボード、ポインター、 タッチのユーザーが完全な値にアクセスできる手段が必要です。 - バッジの意味を色だけに頼ってはいけません。インタラクティブなチップには、ネイティブのセマンティクス、 見えるフォーカス、プログラムから取得できる状態が必要です。ライブで変わるカウントには、意味のあるコンテキストが必要です。
- 素早い操作によってアニメーションがキャンセルされることはあっても、最終的なセマンティックな状態、フォーカス、 コンテンツは正しく保たれなければなりません。タイミングはプラットフォームとコンポーネントに合わせて選び、 動きを減らす設定を尊重します。
スタイルの分類
カタログには、安定した ID とエイリアスに裏付けられた 80 の検索可能なスタイル が含まれています:
| ステータス | 数 | 検索時の動作 |
|---|---|---|
| Active | 51 | 通常の推奨に含まれ、ギャラリーでデフォルトで表示されます |
| Supplemental | 29 | 正確な指定や、明示的なバリアント/システムの意図がある場合に返されます。ギャラリーのステータスフィルターから利用できます |
| Deprecated | 9 | 通常のランキングから除外されます。旧名称は正規のスタイルまたはランディングパターンにリダイレクトされます |
Active のセットには、43 の汎用的なビジュアルファミリー、2 つのモバイル専用スタイル、4 つの公式プラットフォーム/デザインシステム、1 つのプラットフォームマテリアル、1 つのコア分析スタイルが含まれます。現在の公式システムには Fluent 2、Shopify Polaris、Adobe Spectrum、Apple Native Experience があります。Liquid Glass は Apple のプラットフォームマテリアルとして扱われ、Material 3 Expressive はモバイルの Material のバリアントのままで、Spectrum 2 は Supplemental です。ランディングページの構成は、BM25 のランキングでビジュアルスタイルと競合しないよう、34 パターンの別のランディングデータセットに分けられています。
完全な分類と、出所を考慮したメタデータについては styles.csv をご覧ください。
💎 ベーシック版とプレミアム版の比較
オープンソース版とプレミアム版の違いについて、多くのご質問をいただいています。ワークフローに合ったものを選べるよう、詳しく説明します。
🟢 ベーシック版(このリポジトリ)
- 完全なオープンソース: 個人の開発者、趣味のプロジェクト、一般的なプロジェクトに最適です。
- コアの UI/UX インテリジェンス: 80 の検索可能な UI スタイル(うち 51 が有効)、192 のプロダクトタイプ、カラーパレット、厳選したフォントペアリングをすべて利用できます。
- スマートな推奨: 内蔵の BM25 検索エンジンにより、非常に精度の高いデザインのマッチングを行います。
- クロスプラットフォーム対応: 22 の主要なフレームワーク(React、Vue、Tailwind、iOS、Android など)に対応したスタック別のガイドライン。
- デザインシステム生成: CLI から、ニーズに合わせた UI のルール、パターン、ロジックをすぐに生成できます。
🟡 プレミアム版
- 拡張されたブランドデザインスキル: UI/UX にとどまらず、ブランドアイデンティティの生成、ロゴデザイン、コーポレートアイデンティティプログラム (CIP)、バナー、プレゼンテーションスライド、カスタムのアイコンまでカバーします。
- 高度なアセット作成: AI を活用した画像生成と深く統合し、プレースホルダーではなく実際のビジュアルアセットを作成します。
- エンタープライズ向けのアーキテクチャ: 大規模なチームでの展開に向けた、より包括的でスケーラブルなデザイントークンのアーキテクチャ。
- 優先サポート: 中断のないデザインワークフロー全体を必要とするチームやプロフェッショナル向けの、専任の技術サポート。
👉 プレミアム版へのアップグレードについて詳しくは、uupm.cc をご覧ください。
インストール
Claude Marketplace を使う (Claude Code)
2 つのコマンドで 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 から、または OS のパッケージマネージャー(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 のコントラスト、ホバー/フォーカス/無効の状態、レスポンシブレイアウト、対応しているすべてのテーマを確認します。
仕組み
- 依頼する - UI/UX のタスク(構築、デザイン、作成、実装、レビュー、修正、改善)を依頼します
- デザインシステムの生成 - AI が推論エンジンを使って、完全なデザインシステムを自動的に生成します
- スマートな推奨 - プロダクトタイプと要件に基づいて、最も適したスタイル、色、タイポグラフィを見つけます
- コード生成 - 適切な色、フォント、余白、ベストプラクティスで UI を実装します
- 納品前のチェック - よくある UI/UX のアンチパターンに照らして検証します
対応スタック
このスキルは、次のスタック向けのガイドラインを提供します:
| カテゴリ | スタック |
|---|---|
| Web (HTML) | HTML + Tailwind(デフォルト) |
| React エコシステム | React、Next.js、shadcn/ui |
| Vue エコシステム | Vue、Nuxt.js、Nuxt UI |
| Angular | Angular |
| PHP | Laravel (Blade、Livewire、Inertia.js) |
| その他の Web | Svelte、Astro、Three.js |
| デスクトップ | JavaFX、WPF、WinUI 3、Avalonia、Uno Platform、UWP |
| iOS | SwiftUI |
| Android | Jetpack Compose |
| クロスプラットフォーム | React Native、Flutter |
プロンプトで使いたいスタックを伝えるだけです。指定しなければ HTML + Tailwind がデフォルトになります。
例
ビフォー/アフター:運用ダッシュボード
シンプルな運用ダッシュボード(ビフォー)を、UI UX Pro Max が生成したデザインシステムだけを使ってスタイルを変更したものです(アフター)。生成には search.py "internal operations dashboard" --design-system --density 8 --motion 3 --variance 4 を使っています。
コミュニティから提供された参考例であり、スキルの公式デモ、ベンチマーク、実行時テストではありません。
デザインシステムコマンド(上級者向け)
デザインシステムジェネレーターに直接アクセスするには:
注: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
# 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
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux
# RTL / Arabic, Hebrew, Persian interfaces (style and product domains)
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain style --rtl=full
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech" --domain product --rtl=partial
# 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
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
Web スタックの検索はバージョンを考慮します。古いメジャーバージョンを含まないクエリでは、現在の
有効なガイダンスが返されます。明示的にレガシーな用語や古いメジャーバージョン(例: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 と一緒に使うことはできません。
デザインシステムの永続化(Master + Overrides パターン)
デザインシステムをファイルに保存して、セッションをまたいだ階層的な取得 を行えます:
# 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"
これにより、次のような design-system/ フォルダー構成が作成されます:
design-system/
└── myapp/ # One folder per project (slug of -p "MyApp")
├── MASTER.md # Global Source of Truth (colors, typography, spacing, components)
└── pages/
└── dashboard.md # Page-specific overrides (only deviations from Master)
階層的な取得の仕組み:
- 特定のページ(例:"Checkout")を作るときは、まず
design-system/[project-slug]/pages/checkout.mdを確認します - ページのファイルが存在する場合、そのルールが Master ファイルを 上書き します
- 存在しない場合は、
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` uses Bun when available and falls back to TypeScript compiler output after `npm ci`.
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 をご覧ください。
カタログの出所と更新
コミット済みのカタログの概要には、現在 1,934 の承認済み Google Fonts と、 公式のライセンスのメタデータが一致しない限り昇格されない 8 つのレビュー除外 が記録されています。 アイコンのガイダンスは引き続き 105 の厳選した行(100 の Phosphor の Web 向けの直接のインポートと、 React Native/フォールバックのガイダンス)です。別に用意された 1,512 アイコンのアップストリームの Phosphor のマニフェスト は、名前、 ウェイト、React/SSR のインポートを検証するもので、アップストリームのパッケージ全体で検索結果があふれることはありません。
通常の開発とプルリクエストの CI は、ネットワークに依存しません。スナップショットのハッシュと 生成されたカウントの検証を含む、完全なオフラインのゲートは次のコマンドで実行します:
npm --prefix cli run verify:data
# Or check only the generated catalog summary:
npm --prefix cli run validate:catalog-summary
更新の正規化も、コミット済みのフィクスチャに対して完全にオフラインで試すことができます。 出力は一時的な候補ディレクトリに書き出され、正規のデータが 置き換えられることはありません:
candidate_dir="$(mktemp -d)"
python3 scripts/refresh-google-fonts.py \
--api-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json \
--metadata-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json \
--existing-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv \
--overrides src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json \
--output-csv "$candidate_dir/google-fonts.csv" \
--license-output "$candidate_dir/google-font-licenses.json" \
--metadata-revision fixture-catalogs-v1 \
--verified-at 2026-08-13 --expected-count 2 --approve-changes
python3 scripts/refresh-icon-catalog.py \
--input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json \
--package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json \
--react-package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json \
--react-exports-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json \
--curated-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv \
--output "$candidate_dir/phosphor-icons-upstream.json" \
--verified-at 2026-08-13 --expected-count 2
アップストリームからのライブの更新は、意図的に refresh-catalogs.yml
ワークフローに分離されています。このワークフローは毎週月曜日の 03:17 UTC に実行されるほか、必要に応じて手動でも実行できます。
GitHub Actions のシークレットとして GOOGLE_FONTS_API_KEY を設定し、ワークフローを実行して、
レビュー用のアーティファクトをダウンロードしてください:
gh workflow run refresh-catalogs.yml
run_id="$(gh run list --workflow refresh-catalogs.yml --limit 1 --json databaseId --jq '.[0].databaseId')"
gh run watch "$run_id"
gh run download "$run_id" --name "catalog-refresh-review-$run_id"
このワークフローは Google Fonts Developer API と、バージョンを固定した公式の Phosphor の
パッケージを読み込み、候補と unified diff をアーティファクトに書き出します。リポジトリの権限は読み取り専用です。
コミット、プッシュ、PR の作成、マージは一切行いません。候補のファイルを src/ui-ux-pro-max/data/ に
手動で昇格させる前に、変更レポート、除外、ライセンス、関連性の指標、オフラインのゲートを
確認してください。
自動リリース
このリポジトリでは、semantic-release と Conventional Commits を使って GitHub のリリースを自動的に作成しています:
devブランチからは、2.6.0-beta.1のようなベータ版の GitHub プレリリースが作成されます。mainブランチからは、2.6.0のような正式な安定版の GitHub リリースが作成されます。
リリースノートと CHANGELOG.md は、Conventional Commit のメッセージから生成されます。バージョン番号は、リリースの準備中に skill.json、.claude-plugin/plugin.json、.claude-plugin/marketplace.json、cli/package.json、cli/package-lock.json の間で同期されます。
正しくバージョンを上げるために、次のコミットタイプを使ってください:
fix:-> パッチリリースfeat:-> マイナーリリースfeat!:またはBREAKING CHANGE:-> メジャーリリース
リリースのワークフローは、GitHub のリリースにはデフォルトの GITHUB_TOKEN を使い、ui-ux-pro-max-cli を npm に公開するためにはリポジトリの NPM_TOKEN シークレットを使います。
トラブルシューティング
Claude Code で response exceeded the ... output token maximum と表示される
これは Claude Code の 1 回の応答に対する上限であり、UI/UX Pro Max のインストーラーや検索スクリプトのエラーではありません。まず、タスクを小さなステップに分け、大きな結果は少しずつファイルに書き出すよう Claude に依頼してください。
どうしても 1 回の応答を大きくする必要があり、使用中のモデルが対応している場合は、新しいセッションを始める前に Claude Code の出力トークンの上限を設定してください。例:
# macOS, Linux, or WSL
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="64000"
claude
# Windows PowerShell
$env:CLAUDE_CODE_MAX_OUTPUT_TOKENS = "64000"
claude
シェルの環境変数の変更は、そのシェルから起動したプログラムにしか適用されないため、変数を設定したら Claude Code を再起動してください。Claude Code は、使用中のモデルの出力上限を超える値を上限に丸めます。モデルやプロバイダーの上限はさまざまです。この値を大きくすると、レイテンシーや使用量が増えることもあり、自動コンパクションまでに使える実質的なコンテキストも少なくなります。公式の Claude Code の環境変数のリファレンスをご覧ください。
uipro: unknown command 'uninstall' または unknown command 'update' と表示される
インストールされている ui-ux-pro-max-cli のバージョンが古くなっています。更新してから再試行してください:
npm install -g ui-ux-pro-max-cli@latest
uipro uninstall
uipro uninstall で "No installed AI skill directories detected" と表示される
コマンドを実行しているディレクトリとは別の場所にスキルがインストールされています。次のいずれかを行ってください:
# Option A — run from the project root where you originally installed it
cd /path/to/your/project
uipro uninstall
# Option B — remove the global install
uipro uninstall --global
# Option C — remove manually
rm -rf .claude/skills/ui-ux-pro-max # Claude Code
rm -rf .cursor/skills/ui-ux-pro-max # Cursor
rm -rf .windsurf/skills/ui-ux-pro-max # Windsurf
rm -rf .agents/skills/ui-ux-pro-max # Antigravity / Codex
Claude.ai の "Upload a skill" ダイアログで "Zip contains too many files (maximum 200)" と表示される
GitHub リポジトリの ZIP 全体をアップロードしないでください。これはソースコード、CLI のアセット、ドキュメント、プレビュー、複数の同梱スキルを含む開発用のチェックアウトなので、Claude の 200 ファイルのアップロード上限を超えてしまいます。Claude のスキルのアップロード用の成果物ではなく、このプロジェクトでは現在、Claude.ai に手動でアップロードするための ZIP を別途公開していません。
Claude Code では、Marketplace からインストールしてください:
/plugin marketplace add nextlevelbuilder/ui-ux-pro-max-skill
/plugin install ui-ux-pro-max@ui-ux-pro-max-skill
または CLI のインストーラーを使ってください:
npx ui-ux-pro-max-cli init --ai claude
Claude Marketplace からのインストールが "Zip file contains a symbolic link" で失敗する
これは v2.5.1 より前のバージョンの既知の問題です。リポジトリが内部でシンボリックリンクを使っていたため、一部のインストールツールで処理できませんでした。解決策: 代わりに CLI のインストーラーを使ってください:
npm install -g ui-ux-pro-max-cli
uipro init --ai claude
または、この問題が解決される次のリリースをお待ちください。
npm install -g ui-ux-pro-max-cli が権限エラーで失敗する
Node のバージョンマネージャーを使う(推奨)か、グローバルインストールをまったく行わないでください:
# npx without installing globally
npx ui-ux-pro-max-cli init --ai claude
デザインシステムのコマンドを実行すると Python が見つからない
検索スクリプトには Python 3.x が必要です。python.org から、または OS のパッケージマネージャー(Homebrew、apt、winget)を使って手動でインストールしてください。AI エージェントがあなたの代わりにインストールすることはなく、代わりにあなたに依頼するよう指示されています。
デザインシステムの出力が途中で切れる / フィールドが省略される
人が読む形式の出力では、長いフィールドは 300 文字で省略されます。省略されていない完全なデータを得るには --json を使ってください:
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "SaaS" --domain style --json
スターの推移
ライセンス
このプロジェクトは MIT License のもとでライセンスされています。
対応エージェント
このスキルは次のエージェントで動作します:
- Claude Code
- AdaL - 自己進化する AI コーディングエージェント (Docs | GitHub)