Communitygithub.com

vurakit/agentup

UI/UXデザインインテリジェンス。50スタイル、21パレット、50フォントペアリング、20チャート、9スタック(React、Next.js、Vue、Svelte、SwiftUI、React Native、Flutter、Tailwind、shadcn/ui)。アクション:計画、構築、作成、設計、実装、レビュー、修正、改善、最適化、拡張、リファクタリング、UI/UXコードチェック。プロジェクト:ウェブサイト、ランディングページ、ダッシュボード、管理パネル、Eコマース、SaaS、ポートフォリオ、ブログ、モバイルアプリ、.html、.tsx、.vue、.svelte。要素:ボタン、モーダル、ナビバー、サイドバー、カード、テーブル、フォーム、チャート。スタイル:グラスモーフィズム、クレイモーフィズム、ミニマリズム、ブルータリズム、ニューモーフィズム、ベントグリッド、ダークモード、レスポンシブ、スキューモーフィズム、フラットデザイン。トピック:カラーパレット、アクセシビリティ、アニメーション、レイアウト、タイポグラフィ、フォントペアリング、スペーシング、ホバー、シャドウ、グラデーション。統合:shadcn/ui MCPによるコンポーネント検索とサンプル。

agentup とは?

このスキルは、Webおよびモバイルアプリケーション向けの包括的なUI/UXデザインガイドです。50以上のスタイル、97のカラーパレット、57のフォントペアリング、99のUXガイドライン、25のチャートタイプを9つのテクノロジースタックにわたって提供し、優先度ベースの推奨事項を提供します。主な機能として、製品タイプやキーワードに基づいたデザインシステムの生成(--design-system)、ドメイン別の詳細検索(style, color, typography, chart, uxなど)、そしてマスター/オーバーライドパターンによるデザインシステムの永続化(--persist)があります。アクセシビリティ(CRITICAL)、タッチ&インタラクション(CRITICAL)、パフォーマンス(HIGH)、レイアウト(HIGH)など、優先度の高いルールカテゴリを実装しており、アイコン、ホバー状態、ライト/ダークモードのコントラスト、レイアウトに関する具体的なガイドラインも含まれています。このスキルは、Claude Code、Cursor、Codex、Windsurf、CopilotなどのAIエージェントがUI/UXの設計・実装・レビューを行う際に、統一されたデザイン基準を提供し、プロフェッショナルな品質を保証します。

対応~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/vurakit/agentup/tree/HEAD/skills/frontend

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

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

ドキュメント

UI/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 - 意味のある画像に説明的な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/agentup-frontend/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/agentup-frontend/scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"

ステップ2b:デザインシステムの永続化(Master + Overridesパターン)

デザインシステムを セッション間で階層的に取得 するために保存するには、--persist を追加:

python3 skills/agentup-frontend/scripts/search.py "<query>" --design-system --persist -p "Project Name"

これにより以下が作成される:

  • design-system/MASTER.md — すべてのデザインルールを含むグローバルな唯一の情報源
  • design-system/pages/ — ページ固有のオーバーライド用フォルダ

ページ固有のオーバーライドを使用する場合:

python3 skills/agentup-frontend/scripts/search.py "<query>" --design-system --persist -p "Project Name" --page "dashboard"

これにより以下も作成される:

  • design-system/pages/dashboard.md — Masterからのページ固有の逸脱

階層的取得の仕組み:

  1. 特定のページ(例:「チェックアウト」)を構築する場合、最初に design-system/pages/checkout.md を確認
  2. ページファイルが存在する場合、そのルールがMasterファイルを オーバーライド する
  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/agentup-frontend/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/agentup-frontend/scripts/search.py "<keyword>" --stack html-tailwind

利用可能なスタック:html-tailwind、react、nextjs、vue、svelte、swiftui、react-native、flutter、shadcn、jetpack-compose


検索リファレンス

利用可能なドメイン

ドメイン用途キーワード例
productプロダクトタイプの推奨SaaS、e-commerce、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ユーティリティ、レスポンシブ、a11y(デフォルト)
react状態、フック、パフォーマンス、パターン
nextjsSSR、ルーティング、画像、APIルート
vueComposition API、Pinia、Vue Router
svelteRunes、ストア、SvelteKit
swiftuiViews、State、Navigation、Animation
react-nativeコンポーネント、ナビゲーション、リスト
flutterウィジェット、状態、レイアウト、テーマ設定
shadcnshadcn/uiコンポーネント、テーマ設定、フォーム、パターン
jetpack-composeコンポーザブル、Modifier、ステートホイスティング、リコンポジション

ワークフロー例

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

ステップ1:要件の分析

  • プロダクトタイプ:ビューティー/スパサービス
  • スタイルキーワード:エレガント、プロフェッショナル、ソフト
  • 業界:ビューティー/ウェルネス
  • スタック:html-tailwind(デフォルト)

ステップ2:デザインシステムの生成(必須)

python3 skills/agentup-frontend/scripts/search.py "beauty spa wellness service elegant" --design-system -p "Serenity Spa"

出力: パターン、スタイル、色、タイポグラフィ、エフェクト、アンチパターンを含む完全なデザインシステム。

ステップ3:詳細検索での補足(必要に応じて)

# アニメーションとアクセシビリティのUXガイドラインを取得
python3 skills/agentup-frontend/scripts/search.py "animation accessibility" --domain ux

# 必要に応じて代替タイポグラフィオプションを取得
python3 skills/agentup-frontend/scripts/search.py "elegant luxury serif" --domain typography

ステップ4:スタックガイドライン

python3 skills/agentup-frontend/scripts/search.py "layout responsive form" --stack html-tailwind

その後: デザインシステム + 詳細検索を統合し、デザインを実装。


出力フォーマット

--design-system フラグは2つの出力フォーマットをサポート:

# ASCIIボックス(デフォルト) - ターミナル表示に最適
python3 skills/agentup-frontend/scripts/search.py "fintech crypto" --design-system

# Markdown - ドキュメントに最適
python3 skills/agentup-frontend/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でレスポンシブ
  • モバイルで水平スクロールがない

アクセシビリティ

  • すべての画像にaltテキストがある
  • フォーム入力にラベルがある
  • 色だけが唯一のインジケーターではない
  • prefers-reduced-motion が尊重されている

関連スキル