ux-skill

# ux-skill — AIコーディングツール向けデザインインテリジェンスエンジン ux-skillは、AI生成UIを一般的なものではなく特徴的なものにするために設計された**デザインインテリジェンスエンジン**です。Claude Code、Cursor、Windsurf、GitHub Copilot、Gemini CLI、Codexなど、17のAIコーディングツールと統合します。このエンジンは無料で、MITライセンスであり、オフラインで動作し、LLMを一切呼び出しません。 ## 主な機能 - **決定論的7軸シンセサイザー**: ブリーフを新鮮なデザイントークン（暖かさ、コントラスト、密度、幾何学、形式性、動き、タイプの個性）にコンパイルし、テンプレートから選択しません。 - **152のAIスロップ防止リンタールール**: CIで実行され、Critical/Highの問題で非ゼロ終了する決定論的な正規表現ベースのルール。 - **160のブランド仕様**: Apple、Stripe、Linear、Figma、Tesla、BMW、Notion、Spotify、Airbnb、Vercel、Supabase、Cursor、Raycast、Claudeなどの実際のDESIGN.md仕様。 - **12のクエリ可能なJSONマニフェスト**: 84スタイル、176パレット、70タイプペアリング、148コンポーネント、184業界、35チャートタイプ、57モーションプリセット、112 UX法則、152アンチパターンルール、25テックスタック、160ブランド仕様。 - **25のスラッシュコマンド**: ディスカバリー、生成、監査、リント、ポリッシュ、修正ループ、ケーススタディ、ワークショップ、コピー、モーション、アクセシビリティ、ダッシュボード、コンダクターコマンド。 - **5つのサブエージェント**: フロントエンドエンジニア、モーションエンジニア、コピーライター、リサーチシンセサイザー、デザインシステムアーキテクト。 - **18のMCPツール**: ux_synthesize、ux_decisions_query、ux_decisions_statsを含む。 - **17のIDEサポート**: IDEごとに異なるグルーを持つ同じエンジン。 - **オフラインで決定論的**: LLM呼び出しなし、同じ入力は常に同じ出力を生成。 ## インストール 3つのインストールパスが利用可能です： ### パス1 — Claude Codeマーケットプレイス（正規） ```bash /plugin marketplace add Laith0003/ux-skill /plugin install ux@ux-skill ``` ### パス2 — pip（ユニバーサル） ```bash pip install uxskill uxskill init # IDEを自動検出し、適切なアーティファクトをインストール uxskill stats # マニフェスト数を印刷してインストールを検証 uxskill lint . # 現在のディレクトリに対してリンターを実行 ``` ### パス3 — npx（Python不要） ```bash npx uxskill init # 初回実行時にpipx + uxskillをダウンロード npx uxskill recommend --industry=fintech-neobank --tone=warm --stack=nextjs-15-app-router ``` ## 仕組み 1. **入力**: `/ux-discover`（10フィールド）または`ux recommend`のフラグを介してブリーフを提供。 2. **5つの並列検索**: エンジンはマニフェスト（業界、スタイル、トーン、スタック、禁止/地域）全体で5つのルックアップを同時に実行。 3. **マージ**: 決定論的マージャーが候補をランク付けし、競合を解決。 4. **出力**: スタイル、パレット、タイプペア、モーションプリセット、コンポーネント、ブランド模範、アンチパターンガードレールを含むJSONドキュメント。 5. **生成**: 下流コマンドが推奨事項を消費して、サブエージェントを介してコードを生成。 6. **検証**: `/ux-lint`が生成されたコードを152の正規表現ルールに対して再スキャン。 ## v3.1.0のハイライト - **ブランド忠実度の強制**: ロゴピクセルから原色を読み取り、デフォルトフォントを拒否し、ブランドカラー/ロゴを落としたり実際の画像を出さない出力を失敗させる評価のハードフロア。 - **モバイルファーストのゲート**: 新しいクラフト基盤に加え、横スクロール、折り返すナビ/ワードマーク/ボタンラベル、または高すぎるスティッキーヘッダーで失敗するラップ認識ゲート。 - **ワウレイヤー**: エンジンがページごとに2〜3の調整されたシグネチャーモーメントを導出。 - **よりシャープなリンター**: 画像必須、アイコンのみ検出、プレースホルダートークン、100vwルールを含む152ルール。 - **310の合格テスト**: オフライン、決定論的、LLMは一切呼び出されません。 ## アーキテクチャ エンジンは以下で構成されます： - **data/**: クエリ可能なJSONマニフェスト（スタイル、パレット、タイプペア、コンポーネント、業界、チャートタイプ、テックスタック、UXガイドライン、モーションプリセット、アンチパターン、ブランド）。 - **engine/**: Python推論コア（シンセサイザー、決定、レコメンダー、リンター、ディスカバリー、ジェネレーター、インストーラー、CLI）。 - **commands/**: 25のClaude Codeスラッシュコマンド（.mdファイル）。 - **agents/**: 5つのサブエージェント（.mdファイル）。 - **references/**: データとデモページの散文ソース。 - **bin/**: npxラッパーとリンタースクリプト。 - **.ux/**: プロジェクトごとの状態ディレクトリ。 ## 比較 READMEには、他の8つのClaude UXプラグインとの正直な比較が含まれており、ux-skillが勝つ点（コンポーネントライブラリ、モーションプリセット、アンチパターンリンター、ブランド仕様、17 IDEサポート、25スラッシュコマンド）と負ける点（認知度、ブランド認知、マーケティングの洗練度）を指摘しています。 ## ライセンス MITライセンス。著者：Laith Aljunaidy、アンマンのデザイナー兼CTO。サイト：uxskill.laithjunaidy.com。GitHub：Laith0003/ux-skill。PyPI：uxskill。npm：uxskill。