Communitygithub.com

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

Web/モバイルアプリ向けの包括的なUI/UXデザインガイド。50以上のスタイル、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプを9つのテクノロジースタックにわたって提供します。優先度ベースの推奨機能を備えた検索可能なデータベースです。

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

このスキルは、AIエージェント(Claude Code、Cursor、Codexなどを想定)がWeb/モバイルアプリケーションのUI/UXデザインを包括的に支援するためのナレッジベースおよび検索ツールです。50以上のスタイル(グラスモーフィズム、ミニマリズムなど)、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプを、React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind CSS、shadcn/uiの9つのスタックに対応した形で提供します。コア機能はPythonスクリプトによる優先度ベースの検索であり、`--design-system`フラグで製品タイプ・業界・スタイルに最適化された基本デザインシステムを生成できます。さらに、`--domain`フラグで特定の領域(typography、color、uxなど)の詳細ルールを、`--stack`フラグで実装スタック別のベストプラクティスを検索できます。設計システムはMaster + Overrides パターンでプロジェクトファイルに永続化でき、セッションをまたいだ階層的なルール適用が可能です。アクセシビリティ(カラーコントラクト、フォーカス状態、キーボードナビゲーション)やパフォーマンス(画像最適化、アニメーションの制限)、レスポンシブデザインなど、プロフェッショナルなUIに必須のプラクティスがカテゴリと優先度で整理されており、AIエージェントはこれらのルールをコード生成前に確認し、高品質で一貫性のあるデザインを効率的に提供できます。

対応~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 - デザインインテリジェンス は何をしますか?

Web/モバイルアプリケーション向けの包括的なデザインガイド。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 - 意味のある画像には説明的なaltテキスト
  • aria-labels - アイコンのみのボタンにはaria-label
  • keyboard-nav - Tab順序は視覚順序と一致させる
  • form-labels - for属性を持つlabelを使用

2. タッチ&インタラクション(致命的)

  • touch-target-size - 最小44x44pxのタッチターゲット
  • hover-vs-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、ecommerce、portfolio、healthcare、beauty、service
styleUIスタイル、カラー、エフェクトglassmorphism、minimalism、dark mode、brutalism
typographyフォントペアリング、Google Fontselegant、playful、professional、modern
color製品タイプ別カラーパレットsaas、ecommerce、healthcare、beauty、fintech、service
landingページ構造、CTA戦略hero、hero-centric、testimonial、pricing、social-proof
chartチャートタイプ、ライブラリ推奨trend、comparison、timeline、funnel、pie
uxベストプラクティス、アンチパターンanimation、accessibility、z-index、loading
reactReact/Next.jsパフォーマンスwaterfall、bundle、suspense、memo、rerender、cache
webWebインターフェースガイドラインaria、focus、keyboard、semantic、virtualize
promptAIプロンプト、CSSキーワード(スタイル名)

利用可能なスタック

スタック焦点
html-tailwindTailwindユーティリティ、レスポンシブ、アクセシビリティ(デフォルト)
react状態、フック、パフォーマンス、パターン
nextjsSSR、ルーティング、画像、APIルート
vueComposition API、Pinia、Vue Router
svelteRunes、ストア、SvelteKit
swiftuiビュー、状態、ナビゲーション、アニメーション
react-nativeコンポーネント、ナビゲーション、リスト
flutterウィジェット、状態、レイアウト、テーマ設定
shadcnshadcn/uiコンポーネント、テーマ設定、フォーム、パターン
jetpack-composeコンポーザブル、Modifier、状態ホイスティング、再コンポジション

ワークフロー例

ユーザーリクエスト: 「プロフェッショナルなスキンケアサービスのランディングページを作成して」

ステップ 1: 要件を分析

  • 製品タイプ: Beauty/Spaサービス
  • スタイルキーワード: elegant、professional、soft
  • 業界: Beauty/Wellness
  • スタック: 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

# マークダウン - ドキュメントに最適
python3 skills/ui-ux-pro-max/scripts/search.py "fintech crypto" --design-system -f markdown

より良い結果を得るためのヒント

  1. キーワードは具体的に -「healthcare SaaS dashboard」 > 「app」
  2. 複数回検索する - 異なるキーワードで異なる洞察が得られます
  3. ドメインを組み合わせる - スタイル+タイポグラフィ+カラー=完全なデザインシステム
  4. 常にUXを確認 - 「animation」、「z-index」、「accessibility」を検索して一般的な問題をチェック
  5. スタックフラグを使用 - 実装固有のベストプラクティスを取得
  6. 繰り返す - 最初の検索が合わない場合、別のキーワードを試す

プロフェッショナルUIのための共通ルール

これらは、UIがプロフェッショナルに見えなくなる原因として頻繁に見落とされる問題です:

アイコンと視覚要素

ルール推奨非推奨
絵文字をアイコンにしないSVGアイコン(Heroicons、Lucide、Simple Icons)を使用UIアイコンとして🎨 🚀 ⚙️などの絵文字を使用しない
安定したホバー状態ホバー時にカラー/不透明度のトランジションを使用レイアウトを動かすscale変換を使用しない
正しいブランドロゴ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でレスポンシブである
  • モバイルで水平スクロールが発生しない

アクセシビリティ

  • すべての画像にaltテキストがある
  • フォーム入力にラベルがある
  • 色だけが唯一の指標ではない
  • 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

関連スキル