Communitygithub.com

UI/UX Pro Max - デザインインテリジェンス

ウェブ・モバイルアプリケーション向けの包括的なデザインガイド。50以上のスタイル、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプを9つの技術スタックに対応。優先度ベースのレコメンデーションと検索可能なデータベース。

UX Pro Max - デザインインテリジェンス とは?

このスキルは、UI/UXデザインと実装のための包括的な知識ベースとCLIツールを提供します。50以上のデザインスタイル、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプをカバーし、React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind、shadcn/uiの9つの技術スタックにわたる実装ガイドラインを含みます。主な機能は、ユーザー要件に基づいて完全なデザインシステムを生成する`--design-system`フラグの付いたPython検索スクリプトです。クリティカル(アクセシビリティ、タッチ操作)から低(チャート)まで8段階の優先度で整理されたルールに基づき、プロジェクトごとに一貫性のあるデザイン決定を行います。また、生成されたデザインシステムを`design-system/MASTER.md`として保存し、階層的にページ固有のオーバーライドを管理する`--persist`フラグもサポートしています。このスキルは、より良い結果を得るための具体的なキーワード検索、複数ドメインの組み合わせ、UXチェック、スタック固有のベストプラクティスの使用を推奨しており、プロフェッショナルなUIのための一般的なルール(絵文字禁止、ホバー状態の安定性、正しいブランドロゴ、一貫したアイコンサイズなど)と、配信前チェックリストも提供します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/ProjectZeroDays/FreeAI_AI_Inference_Workstation/tree/HEAD/skills/ui-ux-pro-max

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

UX Pro Max - デザインインテリジェンス は何をしますか?

ウェブ・モバイルアプリケーション向けの包括的なデザインガイドです。50以上のスタイル、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプを9つの技術スタックに対応。優先度ベースのレコメンデーションを持つ検索可能なデータベースです。

適用タイミング

以下の状況でこれらのガイドラインを参照してください:

  • 新しいUIコンポーネントやページをデザインするとき
  • カラーパレットやタイポグラフィを選択するとき
  • UXの問題についてコードをレビューするとき
  • ランディングページやダッシュボードを構築するとき
  • アクセシビリティ要件を実装するとき

優先度別ルールカテゴリ

優先度カテゴリ影響度ドメイン
1アクセシビリティクリティカルux
2タッチとインタラクションクリティカルux
3パフォーマンス高ux
4レイアウトとレスポンシブ高ux
5タイポグラフィとカラー中typography, color
6アニメーション中ux
7スタイル選択中style, product
8チャートとデータ低chart

クイックリファレンス

1. アクセシビリティ (クリティカル)

  • color-contrast - 通常テキストは最低4.5:1のコントラスト比
  • focus-states - インタラクティブ要素に可視フォーカスリング
  • alt-text - 意味のある画像には説明的な代替テキスト
  • aria-labels - アイコンのみのボタンにはaria-label
  • keyboard-nav - Tab順序が視覚的順序と一致
  • form-labels - for属性付きのlabelを使用

2. タッチとインタラクション (クリティカル)

  • touch-target-size - タッチターゲットは最低44x44px
  • hover-vs-tap - 主要なインタラクションにはclick/tapを使用
  • loading-buttons - 非同期処理中はボタンを無効化
  • error-feedback - 問題の近くに明確なエラーメッセージを表示
  • cursor-pointer - クリック可能な要素にcursor-pointerを追加

3. パフォーマンス (高)

  • image-optimization - WebP、srcset、遅延ロードを使用
  • reduced-motion - prefers-reduced-motionを確認
  • content-jumping - 非同期コンテンツの領域を確保

4. レイアウトとレスポンシブ (高)

  • viewport-meta - width=device-width initial-scale=1
  • readable-font-size - モバイルの本文テキストは最低16px
  • horizontal-scroll - コンテンツがビューポート幅に収まるようにする
  • z-index-management - z-indexスケールを定義(10、20、30、50)

5. タイポグラフィとカラー (中)

  • line-height - 本文テキストは1.5~1.75
  • line-length - 1行あたり65~75文字に制限
  • font-pairing - 見出しと本文フォントの個性を調和

6. アニメーション (中)

  • duration-timing - マイクロインタラクションは150~300ms
  • transform-performance - width/heightではなくtransform/opacityを使用
  • loading-states - スケルトンスクリーンまたはスピナー

7. スタイル選択 (中)

  • style-match - スタイルを製品タイプに合わせる
  • consistency - すべてのページで同じスタイルを使用
  • no-emoji-icons - 絵文字ではなくSVGアイコンを使用

8. チャートとデータ (低)

  • 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、eコマース、ポートフォリオ、ダッシュボード、ランディングページなど
  • スタイルキーワード:ミニマル、遊び心、プロフェッショナル、エレガント、ダークモードなど
  • 業界:ヘルスケア、フィンテック、ゲーム、教育など
  • スタック: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つのドメイン(product、style、color、landing、typography)を並列検索
  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 のみを使用

コンテキスト認識取得プロンプト:

I am building the [Page Name] page. Please read design-system/MASTER.md.
Also check if design-system/pages/[page-name].md exists.
If the page file exists, prioritize its rules.
If not, use the Master rules exclusively.
Now, generate the code...

ステップ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、eコマース、ポートフォリオ、ヘルスケア、美容、サービス
styleUIスタイル、色、エフェクトグラスモーフィズム、ミニマリズム、ダークモード、ブルータリズム
typographyフォントペアリング、Google Fontsエレガント、遊び心、プロフェッショナル、モダン
color製品タイプ別のカラーパレットsaas、eコマース、ヘルスケア、美容、フィンテック、サービス
landingページ構造、CTA戦略ヒーロー、ヒーロー中心、お客様の声、価格設定、社会的証明
chartチャートタイプ、ライブラリ推奨トレンド、比較、タイムライン、ファネル、円グラフ
uxベストプラクティス、アンチパターンアニメーション、アクセシビリティ、z-index、ローディング
reactReact/Next.jsパフォーマンスウォーターフォール、バンドル、Suspense、memo、再レンダリング、キャッシュ
webWebインターフェースガイドラインaria、focus、keyboard、semantic、virtualize
promptAIプロンプト、CSSキーワード(スタイル名)

利用可能なスタック

スタック焦点
html-tailwindTailwindユーティリティ、レスポンシブ、a11y(デフォルト)
react状態、フック、パフォーマンス、パターン
nextjsSSR、ルーティング、画像、APIルート
vueComposition API、Pinia、Vue Router
svelteRunes、ストア、SvelteKit
swiftuiビュー、状態、ナビゲーション、アニメーション
react-nativeコンポーネント、ナビゲーション、リスト
flutterウィジェット、状態、レイアウト、テーマ設定
shadcnshadcn/uiコンポーネント、テーマ設定、フォーム、パターン
jetpack-composeコンポーザブル、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 フラグは2つの出力形式をサポートしています:

# 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アイコンとして🎨 🚀 ⚙️ などの絵文字を使用
安定したホバー状態ホバー時にcolor/opacityのトランジションを使用レイアウトがずれるスケール変換を使用
正しいブランドロゴSimple Iconsから公式のSVGを調査ロゴパスを推測したり、誤ったパスを使用
一貫したアイコンサイズ固定のviewBox(24x24)とw-6 h-6を使用異なるアイコンサイズをランダムに混在

インタラクションとカーソル

ルール推奨非推奨
カーソルポインターすべてのクリック可能/ホバー可能なカードに cursor-pointer を追加インタラクティブ要素にデフォルトのカーソルを残す
ホバーフィードバック視覚的なフィードバックを提供(色、シャドウ、ボーダー)要素がインタラクティブであることを示すものがない
スムーズなトランジションtransition-colors duration-200 を使用インスタントな状態変更または遅すぎる(>500ms)

ライト/ダークモードのコントラスト

ルール推奨非推奨
ガラスカードのライトモードbg-white/80 またはそれ以上の不透明度を使用bg-white/10(透過しすぎ)を使用
テキストのコントラスト(ライト)テキストに #0F172A(スレート-900)を使用本文テキストに #94A3B8(スレート-400)を使用
ミュートテキスト(ライト)最低でも #475569(スレート-600)を使用グレー-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 が尊重されている

関連スキル